向表中添加一个新的检查约束。expression 是一个布尔条件的可验证的 String 表示。

add_check_constraint :products, "price > 0", name: "price_check"

生成

ALTER TABLE "products" ADD CONSTRAINT price_check CHECK (price > 0)

options 哈希可以包含以下键

:name

约束名称。默认为 chk_rails_<identifier>。

:if_not_exists

如果约束已存在，则静默忽略，而不是引发错误。

:validate

(仅限 PostgreSQL) 指定约束是否应被验证。默认为 true。

向 table_name 添加一个名为 column_name 的新 type 列。

参见 ActiveRecord::ConnectionAdapters::TableDefinition.column。

type 参数通常是迁移的本地类型之一，它们是以下之一：:primary_key、:string、:text、:integer、:bigint、:float、:decimal、:numeric、:datetime、:time、:date、:binary、:blob、:boolean。

您可以使用此列表之外的类型，只要它受您的数据库支持（例如，MySQL 中的“polygon”），但这将不是数据库无关的，并且通常应避免。

可用选项是（默认情况下不存在任何选项）

• :comment - 指定列的注释。此选项会被某些后端忽略。

• :collation - 为 :string 或 :text 列指定排序规则。如果未指定，则该列将具有与表相同的排序规则。

• :default - 列的默认值。使用 nil 表示 NULL。

• :limit - 请求列的最大长度。对于 :string 列，这是字符数；对于 :text、:binary、:blob 和 :integer 列，这是字节数。此选项会被某些后端忽略。

• :null - 允许或禁止列中的 NULL 值。

• :precision - 指定 :decimal、:numeric、:datetime 和 :time 列的精度。

• :scale - 指定 :decimal 和 :numeric 列的标度。

• :if_not_exists - 指定如果列已存在，则不尝试重新添加它。这将避免重复列错误。

注意：精度是有效数字的总数，标度是小数点后可以存储的数字位数。例如，数字 123.45 的精度为 5，标度为 2。精度为 5、标度为 2 的十进制数范围可以从 -999.99 到 999.99。

请注意不同的 RDBMS 实现对 :decimal 列的行为

• SQL 标准表示默认标度应为 0，:scale <= :precision，并且不评论 :precision 的要求。

• MySQL: :precision [1..65]，:scale [0..30]。默认是 (10,0)。

• PostgreSQL: :precision [1..infinity]，:scale [0..infinity]。无默认值。

• SQLite3: 对 :precision 和 :scale 没有限制，但支持的最大 :precision 是 16。无默认值。

• Oracle: :precision [1..38]，:scale [-84..127]。默认是 (38,0)。

• SqlServer: :precision [1..38]，:scale [0..38]。默认 (38,0)。

示例¶ ↑

add_column(:users, :picture, :binary, limit: 2.megabytes)
# ALTER TABLE "users" ADD "picture" blob(2097152)

add_column(:articles, :status, :string, limit: 20, default: 'draft', null: false)
# ALTER TABLE "articles" ADD "status" varchar(20) DEFAULT 'draft' NOT NULL

add_column(:answers, :bill_gates_money, :decimal, precision: 15, scale: 2)
# ALTER TABLE "answers" ADD "bill_gates_money" decimal(15,2)

add_column(:measurements, :sensor_reading, :decimal, precision: 30, scale: 20)
# ALTER TABLE "measurements" ADD "sensor_reading" decimal(30,20)

# While :scale defaults to zero on most databases, it
# probably wouldn't hurt to include it.
add_column(:measurements, :huge_integer, :decimal, precision: 30)
# ALTER TABLE "measurements" ADD "huge_integer" decimal(30)

# Defines a column that stores an array of a type.
add_column(:users, :skills, :text, array: true)
# ALTER TABLE "users" ADD "skills" text[]

# Defines a column with a database-specific type.
add_column(:shapes, :triangle, 'polygon')
# ALTER TABLE "shapes" ADD "triangle" polygon

# Ignores the method call if the column exists
add_column(:shapes, :triangle, 'polygon', if_not_exists: true)

添加新的外键。from_table 是包含键列的表，to_table 包含引用的主键。

外键将根据以下模式命名：fk_rails_<identifier>。identifier 是一个 10 个字符的字符串，它从 from_table 和 column 确定性地生成。可以使用 :name 选项指定自定义名称。

创建简单的外键¶ ↑

add_foreign_key :articles, :authors

生成

ALTER TABLE "articles" ADD CONSTRAINT fk_rails_e74ce85cbc FOREIGN KEY ("author_id") REFERENCES "authors" ("id")

创建外键，如果外键已存在则忽略方法调用¶ ↑

add_foreign_key(:articles, :authors, if_not_exists: true)

在特定列上创建外键¶ ↑

add_foreign_key :articles, :users, column: :author_id, primary_key: "lng_id"

生成

ALTER TABLE "articles" ADD CONSTRAINT fk_rails_58ca3d3a82 FOREIGN KEY ("author_id") REFERENCES "users" ("lng_id")

创建复合外键¶ ↑

Assuming "carts" table has "(shop_id, user_id)" as a primary key.

add_foreign_key :orders, :carts, primary_key: [:shop_id, :user_id]

生成

ALTER TABLE "orders" ADD CONSTRAINT fk_rails_6f5e4cb3a4 FOREIGN KEY ("cart_shop_id", "cart_user_id") REFERENCES "carts" ("shop_id", "user_id")

创建级联外键¶ ↑

add_foreign_key :articles, :authors, on_delete: :cascade

生成

ALTER TABLE "articles" ADD CONSTRAINT fk_rails_e74ce85cbc FOREIGN KEY ("author_id") REFERENCES "authors" ("id") ON DELETE CASCADE

options 哈希可以包含以下键

:column

from_table 上的外键列名。默认为 to_table.singularize + "_id"。传入数组以创建复合外键。

:primary_key

to_table 上的主键列名。默认为 id。传入数组以创建复合外键。

:name

约束名称。默认为 fk_rails_<identifier>。

:on_delete

ON DELETE 时发生的操作。有效值为 :nullify、:cascade 和 :restrict

:on_update

ON UPDATE 时发生的操作。有效值为 :nullify、:cascade 和 :restrict

:if_not_exists

指定外键是否已存在，以避免尝试重新添加它。这将避免重复列错误。

:validate

(仅限 PostgreSQL) 指定约束是否应被验证。默认为 true。

:deferrable

(仅限 PostgreSQL) 指定外键是否可延迟。有效值为布尔值或 :deferred 或 :immediate 以指定默认行为。默认为 false。

向表中添加新索引。column_name 可以是单个 Symbol，也可以是 Symbols 的 Array。

索引将根据表名和列名命名，除非您传递 :name 作为选项。

创建简单索引¶ ↑

add_index(:suppliers, :name)

生成

CREATE INDEX index_suppliers_on_name ON suppliers(name)

创建已存在的索引¶ ↑

add_index(:suppliers, :name, if_not_exists: true)

生成

CREATE INDEX IF NOT EXISTS index_suppliers_on_name ON suppliers(name)

注意：MySQL 不支持。

创建唯一索引¶ ↑

add_index(:accounts, [:branch_id, :party_id], unique: true)

生成

CREATE UNIQUE INDEX index_accounts_on_branch_id_and_party_id ON accounts(branch_id, party_id)

创建命名索引¶ ↑

add_index(:accounts, [:branch_id, :party_id], unique: true, name: 'by_branch_party')

生成

CREATE UNIQUE INDEX by_branch_party ON accounts(branch_id, party_id)

创建具有特定键长度的索引¶ ↑

add_index(:accounts, :name, name: 'by_name', length: 10)

生成

CREATE INDEX by_name ON accounts(name(10))

为多个键创建具有特定键长度的索引¶ ↑

add_index(:accounts, [:name, :surname], name: 'by_name_surname', length: {name: 10, surname: 15})

生成

CREATE INDEX by_name_surname ON accounts(name(10), surname(15))

注意：仅支持 MySQL

创建具有排序顺序（降序或升序，升序为默认值）的索引¶ ↑

add_index(:accounts, [:branch_id, :party_id, :surname], name: 'by_branch_desc_party', order: {branch_id: :desc, party_id: :asc})

生成

CREATE INDEX by_branch_desc_party ON accounts(branch_id DESC, party_id ASC, surname)

注意：MySQL 仅从 8.0.1 开始支持索引顺序（早期版本接受语法但忽略它）。

创建部分索引¶ ↑

add_index(:accounts, [:branch_id, :party_id], unique: true, where: "active")

生成

CREATE UNIQUE INDEX index_accounts_on_branch_id_and_party_id ON accounts(branch_id, party_id) WHERE active

注意：部分索引仅支持 PostgreSQL 和 SQLite。

创建包含附加列的索引¶ ↑

add_index(:accounts, :branch_id,  include: :party_id)

生成

CREATE INDEX index_accounts_on_branch_id ON accounts USING btree(branch_id) INCLUDE (party_id)

注意：仅支持 PostgreSQL。

创建 NULL 值被视为相等的索引¶ ↑

add_index(:people, :last_name, nulls_not_distinct: true)

生成

CREATE INDEX index_people_on_last_name ON people (last_name) NULLS NOT DISTINCT

注意：仅支持 PostgreSQL 版本 15.0.0 及更高版本。

使用特定方法创建索引¶ ↑

add_index(:developers, :name, using: 'btree')

生成

CREATE INDEX index_developers_on_name ON developers USING btree (name) -- PostgreSQL
CREATE INDEX index_developers_on_name USING btree ON developers (name) -- MySQL

注意：仅支持 PostgreSQL 和 MySQL

使用特定操作符类创建索引¶ ↑

add_index(:developers, :name, using: 'gist', opclass: :gist_trgm_ops)
# CREATE INDEX developers_on_name ON developers USING gist (name gist_trgm_ops) -- PostgreSQL

add_index(:developers, [:name, :city], using: 'gist', opclass: { city: :gist_trgm_ops })
# CREATE INDEX developers_on_name_and_city ON developers USING gist (name, city gist_trgm_ops) -- PostgreSQL

add_index(:developers, [:name, :city], using: 'gist', opclass: :gist_trgm_ops)
# CREATE INDEX developers_on_name_and_city ON developers USING gist (name gist_trgm_ops, city gist_trgm_ops) -- PostgreSQL

注意：仅支持 PostgreSQL

使用特定类型创建索引¶ ↑

add_index(:developers, :name, type: :fulltext)

生成

CREATE FULLTEXT INDEX index_developers_on_name ON developers (name) -- MySQL

注意：仅支持 MySQL。

使用特定算法创建索引¶ ↑

add_index(:developers, :name, algorithm: :concurrently)
# CREATE INDEX CONCURRENTLY developers_on_name on developers (name) -- PostgreSQL

add_index(:developers, :name, algorithm: :inplace)
# CREATE INDEX `index_developers_on_name` ON `developers` (`name`) ALGORITHM = INPLACE -- MySQL

注意：仅支持 PostgreSQL 和 MySQL。

并发添加索引不受事务支持。

有关更多信息，请参阅 “事务性迁移”部分。

创建未被查询使用的索引¶ ↑

add_index(:developers, :name, enabled: false)

生成

CREATE INDEX index_developers_on_name ON developers (name) INVISIBLE -- MySQL

CREATE INDEX index_developers_on_name ON developers (name) IGNORED -- MariaDB

注意：仅支持 MySQL 版本 8.0.0 及更高版本，以及 MariaDB 版本 10.6.0 及更高版本。

添加引用。引用列默认为 bigint，可以使用 :type 选项指定不同类型。如果提供了 :polymorphic 选项，则可选地添加一个 _type 列。

options 哈希可以包含以下键

:type

引用列的类型。默认为 :bigint。

:index

添加适当的索引。默认为 true。有关此选项的用法，请参阅 add_index。

:foreign_key

添加适当的外键约束。默认为 false，传入 true 以添加。如果无法从关联中推断出连接表，则传入 :to_table 并指定相应的表名。

:polymorphic

是否应添加额外的 _type 列。默认为 false。

:null

列是否允许 null。默认为 true。

创建一个没有索引的用户 ID bigint 列¶ ↑

add_reference(:products, :user, index: false)

创建用户 ID 字符串列¶ ↑

add_reference(:products, :user, type: :string)

创建供应商 ID、供应商类型列¶ ↑

add_reference(:products, :supplier, polymorphic: true)

创建带有唯一索引的供应商 ID 列¶ ↑

add_reference(:products, :supplier, index: { unique: true })

创建带有命名索引的供应商 ID 列¶ ↑

add_reference(:products, :supplier, index: { name: "my_supplier_index" })

创建供应商 ID 列和适当的外键¶ ↑

add_reference(:products, :supplier, foreign_key: true)

创建供应商 ID 列和指向 firms 表的外键¶ ↑

add_reference(:products, :supplier, foreign_key: { to_table: :firms })

向 table_name 添加时间戳（created_at 和 updated_at）列。其他选项（如 :null）将转发给 add_column。

add_timestamps(:suppliers, null: true)

返回一个 TableDefinition 对象，其中包含如果将相同参数传递给 create_table 将创建的表的定义信息。有关传递 table_name 以及其他可传递的额外选项的信息，请参阅 create_table。

根据新选项更改列的定义。有关您可以使用 的选项的详细信息，请参阅 TableDefinition#column。

change_column(:suppliers, :name, :string, limit: 80)
change_column(:accounts, :description, :text)

更改列的注释，或在 nil 时将其删除。

传递一个包含 :from 和 :to 的哈希将使此更改在迁移中可逆。

change_column_comment(:posts, :state, from: "old_comment", to: "new_comment")

为列设置新的默认值

change_column_default(:suppliers, :qualification, 'new')
change_column_default(:accounts, :authorized, 1)

将默认值设置为 nil 会有效地删除默认值

change_column_default(:users, :email, nil)

传递一个包含 :from 和 :to 的哈希将使此更改在迁移中可逆。

change_column_default(:posts, :state, from: nil, to: "draft")

为列设置或删除 NOT NULL 约束。null 标志指示值是否可以为 NULL。例如

change_column_null(:users, :nickname, false)

表示别名不能为 NULL（添加约束），而

change_column_null(:users, :nickname, true)

允许它们为 NULL（删除约束）。

该方法接受一个可选的第四个参数来替换现有的 NULL 值。如果需要在启用约束时使用此参数，因为否则那些行将无效。

请注意，第四个参数不会设置列的默认值。

用于更改 table 中列的块。

# change_table() yields a Table instance
change_table(:suppliers) do |t|
  t.column :name, :string, limit: 60
  # Other column alterations here
end

options 哈希可以包含以下键

:bulk

将此设置为 true 以进行批量修改查询，例如

ALTER TABLE `users` ADD COLUMN age INT, ADD COLUMN birthdate DATETIME ...

默认为 false。

仅在 MySQL 和 PostgreSQL 适配器上受支持，其他地方被忽略。

添加列¶ ↑

change_table(:suppliers) do |t|
  t.column :name, :string, limit: 60
end

更改列类型¶ ↑

change_table(:suppliers) do |t|
  t.change :metadata, :json
end

添加 2 个整数列¶ ↑

change_table(:suppliers) do |t|
  t.integer :width, :height, null: false, default: 0
end

添加 created_at/updated_at 列¶ ↑

change_table(:suppliers) do |t|
  t.timestamps
end

添加外键列¶ ↑

change_table(:suppliers) do |t|
  t.references :company
end

创建 company_id(bigint) 列。

添加多态外键列¶ ↑

change_table(:suppliers) do |t|
  t.belongs_to :company, polymorphic: true
end

创建 company_type(varchar) 和 company_id(bigint) 列。

删除列¶ ↑

change_table(:suppliers) do |t|
  t.remove :company
end

删除多列¶ ↑

change_table(:suppliers) do |t|
  t.remove :company_id
  t.remove :width, :height
end

删除索引¶ ↑

change_table(:suppliers) do |t|
  t.remove_index :company_id
end

另请参阅 Table 以了解所有各种列转换的详细信息。

更改表的注释，或在 nil 时将其删除。

传递一个包含 :from 和 :to 的哈希将使此更改在迁移中可逆。

change_table_comment(:posts, from: "old_comment", to: "new_comment")

检查表中是否存在给定检查约束定义的检查约束。

check_constraint_exists?(:products, name: "price_check")

返回给定表的检查约束数组。检查约束表示为 CheckConstraintDefinition 对象。

检查给定表中是否存在列。

# Check a column exists
column_exists?(:suppliers, :name)

# Check a column exists of a particular type
#
# This works for standard non-casted types (eg. string) but is unreliable
# for types that may get cast to something else (eg. char, bigint).
column_exists?(:suppliers, :name, :string)

# Check a column exists with a specific definition
column_exists?(:suppliers, :name, :string, limit: 100)
column_exists?(:suppliers, :name, :string, default: 'default')
column_exists?(:suppliers, :name, :string, null: false)
column_exists?(:suppliers, :tax, :decimal, precision: 8, scale: 2)

返回表中 Column 对象的数组，由 table_name 指定。

使用前两个参数的词法顺序生成的名称创建一个新的连接表。这些参数可以是 String 或 Symbol。

# Creates a table called 'assemblies_parts' with no id.
create_join_table(:assemblies, :parts)

# Creates a table called 'paper_boxes_papers' with no id.
create_join_table('papers', 'paper_boxes')

重复的前缀合并为一个前缀。这对于像 Music::Artist 和 Music::Record 这样的命名空间模型很有用

# Creates a table called 'music_artists_records' with no id.
create_join_table('music_artists', 'music_records')

有关 column_options 中可用的选项的详细信息，请参阅 connection.add_reference。column_options 将应用于两个列。

您可以传递一个 options 哈希，其中可以包含以下键

:table_name

设置表名，覆盖默认值。

:options

您想附加到表定义中的任何额外选项。

:temporary

创建一个临时表。

:force

设置为 true 以在创建表之前删除它。默认为 false。

请注意，create_join_table 默认不创建任何索引；您可以使用其块形式自行创建索引

create_join_table :products, :categories do |t|
  t.index :product_id
  t.index :category_id
end

添加带有删除级联的外键¶ ↑

create_join_table(:assemblies, :parts, column_options: { foreign_key: { on_delete: :cascade } })

生成

CREATE TABLE assemblies_parts (
  assembly_id bigint NOT NULL,
  part_id bigint NOT NULL,
  CONSTRAINT fk_rails_0d8a572d89 FOREIGN KEY ("assembly_id") REFERENCES "assemblies" ("id") ON DELETE CASCADE,
  CONSTRAINT fk_rails_ec7b48402b FOREIGN KEY ("part_id") REFERENCES "parts" ("id") ON DELETE CASCADE
)

将后端特定选项添加到生成的 SQL (MySQL)¶ ↑

create_join_table(:assemblies, :parts, options: 'ENGINE=InnoDB DEFAULT CHARSET=utf8')

生成

CREATE TABLE assemblies_parts (
  assembly_id bigint NOT NULL,
  part_id bigint NOT NULL,
) ENGINE=InnoDB DEFAULT CHARSET=utf8

使用 table_name 创建一个新表。table_name 可以是 String 或 Symbol。

有两种使用 create_table 的方法。您可以使用块形式或常规形式，如下所示

块形式¶ ↑

# create_table() passes a TableDefinition object to the block.
# This form will not only create the table, but also columns for the
# table.

create_table(:suppliers) do |t|
  t.column :name, :string, limit: 60
  # Other fields here
end

块形式，带简写¶ ↑

# You can also use the column types as method calls, rather than calling the column method.
create_table(:suppliers) do |t|
  t.string :name, limit: 60
  # Other fields here
end

常规形式¶ ↑

# Creates a table called 'suppliers' with no columns.
create_table(:suppliers)
# Add a column to 'suppliers'.
add_column(:suppliers, :name, :string, {limit: 60})

options 哈希可以包含以下键

:id

是否自动添加主键列。默认为 true。ActiveRecord::Base.has_and_belongs_to_many 的连接表应将其设置为 false。

可以使用 Symbol 来指定生成的主键列的类型。

可以使用 Hash 来指定生成的主键列的创建选项。有关可用选项，请参阅 add_column。

:primary_key

自动添加主键的名称。默认为 id。如果 :id 为 false，则忽略此选项。

如果传入数组，则会创建复合主键。

请注意，Active Record 模型会自动检测其主键。这可以通过在模型上使用 self.primary_key= 来显式定义键来避免。

:options

您想附加到表定义中的任何额外选项。

:temporary

创建一个临时表。

:force

设置为 true 以在创建表之前删除它。设置为 :cascade 以删除相关对象。默认为 false。

:if_not_exists

设置为 true 以避免在表已存在时引发错误。默认为 false。

:as

用于生成表的 SQL。使用此选项时，将忽略块，并且 :id 和 :primary_key 选项也将被忽略。

将后端特定选项添加到生成的 SQL (MySQL)¶ ↑

create_table(:suppliers, options: 'ENGINE=InnoDB DEFAULT CHARSET=utf8mb4')

生成

CREATE TABLE suppliers (
  id bigint auto_increment PRIMARY KEY
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4

重命名主键列¶ ↑

create_table(:objects, primary_key: 'guid') do |t|
  t.column :name, :string, limit: 80
end

生成

CREATE TABLE objects (
  guid bigint auto_increment PRIMARY KEY,
  name varchar(80)
)

更改主键列的类型¶ ↑

create_table(:tags, id: :string) do |t|
  t.column :label, :string
end

生成

CREATE TABLE tags (
  id varchar PRIMARY KEY,
  label varchar
)

创建复合主键¶ ↑

create_table(:orders, primary_key: [:product_id, :client_id]) do |t|
  t.belongs_to :product
  t.belongs_to :client
end

生成

CREATE TABLE orders (
    product_id bigint NOT NULL,
    client_id bigint NOT NULL
);

ALTER TABLE ONLY "orders"
  ADD CONSTRAINT orders_pkey PRIMARY KEY (product_id, client_id);

不添加主键列¶ ↑

create_table(:categories_suppliers, id: false) do |t|
  t.column :category_id, :bigint
  t.column :supplier_id, :bigint
end

生成

CREATE TABLE categories_suppliers (
  category_id bigint,
  supplier_id bigint
)

基于查询创建临时表¶ ↑

create_table(:long_query, temporary: true,
  as: "SELECT * FROM orders INNER JOIN line_items ON order_id=orders.id")

生成

CREATE TEMPORARY TABLE long_query AS
  SELECT * FROM orders INNER JOIN line_items ON order_id=orders.id

有关如何创建列的详细信息，请参阅 TableDefinition#column。

检查数据源 name 是否存在于数据库中。

data_source_exists?(:ebooks)

返回可用于支持 Active Record 模型的关联名称。对于大多数适配器，这意味着所有 tables 和 views。

阻止索引被查询使用。

disable_index(:users, :email)

删除由给定参数指定的连接表。有关详细信息，请参阅 create_join_table 和 drop_table。

虽然此命令会忽略给定的块，但将其提供在迁移的 change 方法中以便回滚可能很有用。在这种情况下，块将被 create_join_table 使用。

从数据库中删除表或多个表。

:force

设置为 :cascade 以便同时删除依赖项。默认为 false。

:if_exists

设置为 true 以仅在表存在时删除它。默认为 false。

虽然此命令会忽略大多数 options 和给定的块，但将其提供在迁移的 change 方法中以便回滚可能很有用。在这种情况下，options 和块将由 create_table 使用，除非您提供多个表，这不受支持。

使索引可被查询使用。

enable_index(:users, :email)

检查表中是否存在给定外键定义的外键。

# Checks to see if a foreign key exists.
foreign_key_exists?(:accounts, :branches)

# Checks to see if a foreign key on a specified column exists.
foreign_key_exists?(:accounts, column: :owner_id)

# Checks to see if a foreign key with a custom name exists.
foreign_key_exists?(:accounts, name: "special_fk_name")

返回给定表的 the foreign keys 数组。外键表示为 ForeignKeyDefinition 对象。

检查表中是否存在给定索引定义的索引。

# Check an index exists
index_exists?(:suppliers, :company_id)

# Check an index on multiple columns exists
index_exists?(:suppliers, [:company_id, :company_type])

# Check a unique index exists
index_exists?(:suppliers, :company_id, unique: true)

# Check an index with a custom name exists
index_exists?(:suppliers, :company_id, name: "idx_company_id")

# Check a valid index exists (PostgreSQL only)
index_exists?(:suppliers, :company_id, valid: true)

验证具有给定名称的索引是否存在。

返回给定表的索引数组。

返回索引名称的最大字节长度。

返回抽象数据类型到本地数据库类型的映射哈希。有关已识别的抽象数据类型的详细信息，请参阅 TableDefinition#column。

仅返回表的 主键

从表中删除给定的检查约束。删除不存在的检查约束将引发错误。

remove_check_constraint :products, name: "price_check"

要静默忽略不存在的检查约束而不是引发错误，请使用 if_exists 选项。

remove_check_constraint :products, name: "price_check", if_exists: true

如果存在 expression 参数，它将被忽略。在迁移的 change 方法中提供此参数可能很有用，以便可以回滚。在这种情况下，expression 将由 add_check_constraint 使用。

从表定义中删除列。

remove_column(:suppliers, :qualification)

type 和 options 参数将被忽略（如果存在）。在迁移的 change 方法中提供这些参数可能很有用，以便可以回滚。在这种情况下，type 和 options 将由 add_column 使用。根据您使用的数据库，使用此列的索引可能会被自动删除或修改以从此索引中删除此列。

如果提供的选项包含 if_exists 键，它将用于检查列是否存在。这将静默忽略迁移，而不是在列已被删除时引发错误。

remove_column(:suppliers, :qualification, if_exists: true)

从表定义中删除给定的列。

remove_columns(:suppliers, :qualification, :experience)

可以传递 type 和其他列选项以使迁移可逆。

remove_columns(:suppliers, :qualification, :experience, type: :string, null: false)

从表中删除给定的外键。在迁移回滚时，提供的任何选项参数都将用于重新添加外键。建议您提供创建外键时使用的所有选项，以便正确地撤消迁移。

删除 accounts.branch_id 上的外键。

remove_foreign_key :accounts, :branches

删除 accounts.owner_id 上的外键。

remove_foreign_key :accounts, column: :owner_id

删除 accounts.owner_id 上的外键。

remove_foreign_key :accounts, to_table: :owners

删除 accounts 表上名为 special_fk_name 的外键。

remove_foreign_key :accounts, name: :special_fk_name

在尝试删除外键之前检查其是否存在。将静默忽略不存在的索引。

remove_foreign_key :accounts, :branches, if_exists: true

options 哈希接受与 SchemaStatements#add_foreign_key 相同的键，并额外有一个

:to_table

包含引用的主键的表的名称。

从表中删除给定的索引。

如果 accounts 表中存在一个 branch_id 索引，则删除它。

remove_index :accounts, :branch_id

如果 accounts 表中存在一个 branch_id 索引，则删除它。

remove_index :accounts, column: :branch_id

如果 accounts 表中存在一个 branch_id 和 party_id 的索引，则删除它。

remove_index :accounts, column: [:branch_id, :party_id]

删除 accounts 表中名为 by_branch_party 的索引。

remove_index :accounts, name: :by_branch_party

删除 accounts 表中名为 by_branch_party 的 branch_id 索引。

remove_index :accounts, :branch_id, name: :by_branch_party

在尝试删除索引之前检查其是否存在。将静默忽略不存在的索引。

remove_index :accounts, if_exists: true

concurrently 删除 accounts 表中名为 by_branch_party 的索引。

remove_index :accounts, name: :by_branch_party, algorithm: :concurrently

注意：仅支持 PostgreSQL。

并发删除索引不受事务支持。

有关更多信息，请参阅 “事务性迁移”部分。

删除引用(s)。如果存在 type 列，也会删除它。

删除引用¶ ↑

remove_reference(:products, :user, index: false)

删除多态引用¶ ↑

remove_reference(:products, :supplier, polymorphic: true)

删除带外键的引用¶ ↑

remove_reference(:products, :user, foreign_key: true)

从表定义中删除时间戳列（created_at 和 updated_at）。

remove_timestamps(:suppliers)

重命名列。

rename_column(:suppliers, :description, :name)

重命名索引。

将 index_people_on_last_name 索引重命名为 index_users_on_last_name

rename_index :people, 'index_people_on_last_name', 'index_users_on_last_name'

重命名表。

rename_table('octopuses', 'octopi')

根据当前适配器的限制截断表别名。

返回存储在数据库元数据中的表注释。

检查表 table_name 是否存在于数据库中。

table_exists?(:developers)

返回数据库中定义的表名数组。

检查视图 view_name 是否存在于数据库中。

view_exists?(:ebooks)

返回数据库中定义的视图名数组。