method

add_reference

v4.2.1 - Show latest stable - Class: ActiveRecord::ConnectionAdapters::SchemaStatements

add_reference(table_name, ref_name, options = {})

public

Adds a reference. Optionally adds a type column, if :polymorphic option is provided. The reference column is an integer by default, the :type option can be used to specify a different type. add_reference and add_belongs_to are acceptable.

Create a user_id integer column

add_reference(:products, :user)

Create a user_id string column

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

Create a supplier_id and supplier_type columns

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

Create supplier_id, supplier_type columns and appropriate index

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

# File activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb, line 645
      def add_reference(table_name, ref_name, options = {})
        polymorphic = options.delete(:polymorphic)
        index_options = options.delete(:index)
        type = options.delete(:type) || :integer
        foreign_key_options = options.delete(:foreign_key)

        if polymorphic && foreign_key_options
          raise ArgumentError, "Cannot add a foreign key to a polymorphic relation"
        end

        add_column(table_name, "#{ref_name}_id", type, options)
        add_column(table_name, "#{ref_name}_type", :string, polymorphic.is_a?(Hash) ? polymorphic : options) if polymorphic
        add_index(table_name, polymorphic ? ]type id].map{ |t| "#{ref_name}_#{t}" } : "#{ref_name}_id", index_options.is_a?(Hash) ? index_options : {}) if index_options
        add_foreign_key(table_name, ref_name.to_s.pluralize, foreign_key_options.is_a?(Hash) ? foreign_key_options : {}) if foreign_key_options
      end

1Note

foreign_key option

cmbankester · Jun 7, 2016

It is also possible to specify that +add_foreign_key+ should be added to the schema: add_reference(:products, :supplier, foreign_key: true)