class ActiveRecord::ConnectionAdapters::TableDefinition

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 230
def [](name)
  @columns_hash[name.to_s]
end

Возвращает ColumnDefinition для столбца с именем name.

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 301
def column(name, type, options = {})
  name = name.to_s
  type = type.to_sym if type
  options = options.dup

  if @columns_hash[name] && @columns_hash[name].primary_key?
    raise ArgumentError, "you can't redefine the primary key column '#{name}'. To define a custom primary key, pass { id: false } to create_table."
  end

  index_options = options.delete(:index)
  index(name, index_options.is_a?(Hash) ? index_options : {}) if index_options
  @columns_hash[name] = new_column_definition(name, type, options)
  self
end

Создаёт новый столбец для таблицы. См. connection.add_column для доступных параметров.

Дополнительные параметры:

• :index - Создаёт индекс для столбца. Может быть как true , так и хэш параметров.

Этот метод возвращает self.

Примеры

# Assuming +td+ is an instance of TableDefinition
td.column(:granted, :boolean, index: true)

Примеры с сокращениями

Вместо прямого вызова column, можно использовать сокращенные определения для стандартных типов. Они используют тип в качестве имени метода вместо параметра и позволяют определить несколько столбцов в одном выражении.

Что можно записать так с обычными вызовами column:

create_table :products do |t|
  t.column :shop_id,     :integer
  t.column :creator_id,  :integer
  t.column :item_number, :string
  t.column :name,        :string, default: "Untitled"
  t.column :value,       :string, default: "Untitled"
  t.column :created_at,  :datetime
  t.column :updated_at,  :datetime
end
add_index :products, :item_number

можно записать следующим образом, используя сокращённые записи:

create_table :products do |t|
  t.integer :shop_id, :creator_id
  t.string  :item_number, index: true
  t.string  :name, :value, default: "Untitled"
  t.timestamps null: false
end

Для каждого значения типа, объявленного вверху, есть сокращённый метод. А затем есть #timestamps, который добавит created_at и updated_at как даты и время.

#references добавит столбец с соответствующим именем _id, а также столбец _type, если указан параметр :polymorphic. Если :polymorphic — хэш параметров, эти параметры будут использованы при создании столбца _type. Параметр :index также создаст индекс, аналогично вызову add_index. Поэтому то, что можно записать так:

create_table :taggings do |t|
  t.integer :tag_id, :tagger_id, :taggable_id
  t.string  :tagger_type
  t.string  :taggable_type, default: 'Photo'
end
add_index :taggings, :tag_id, name: 'index_taggings_on_tag_id'
add_index :taggings, [:tagger_id, :tagger_type]

Также можно записать так, используя references:

create_table :taggings do |t|
  t.references :tag, index: { name: 'index_taggings_on_tag_id' }
  t.references :tagger, polymorphic: true, index: true
  t.references :taggable, polymorphic: { default: 'Photo' }
end

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 227
def columns; @columns_hash.values; end

Возвращает массив объектов ColumnDefinition для столбцов таблицы.

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 326
def index(column_name, options = {})
  indexes << [column_name, options]
end

Добавляет параметры индекса в хэш indexes, с ключом имя столбца. Это используется в первую очередь для отслеживания индексов, которые нужно создать после создания таблицы

index(:account_id, name: 'index_projects_on_account_id')

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 356
def references(*args, **options)
  args.each do |col|
    ReferenceDefinition.new(col, **options).add_to(self)
  end
end

Добавляет ссылку.

t.references(:user)
t.belongs_to(:supplier, foreign_key: true)

См. connection.add_reference для подробностей о параметрах, которые можно использовать.

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 318
def remove_column(name)
  @columns_hash.delete name.to_s
end

удаляет столбец name из таблицы.

remove_column(:account_id)

# File activerecord/lib/active_record/connection_adapters/abstract/schema_definitions.rb, line 341
def timestamps(*args)
  options = args.extract_options!

  options[:null] = false if options[:null].nil?

  column(:created_at, :datetime, options)
  column(:updated_at, :datetime, options)
end

Добавляет столбцы :datetime :created_at и :updated_at в таблицу. См. connection.add_timestamps

t.timestamps null: false