instance method `remove_foreign_key`

Ruby on Rails 4.2.9

Since v4.2.9

Available in: v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

remove_foreign_key(from_table, options_or_to_table = {})

Removes the given foreign key from the table.

Removes the foreign key on accounts.branch_id.

remove_foreign_key :accounts, :branches

Removes the foreign key on accounts.owner_id.

remove_foreign_key :accounts, column: :owner_id

Removes the foreign key named special_fk_name on the accounts table.

remove_foreign_key :accounts, name: :special_fk_name

Parameters

from_table req
options_or_to_table opt = {}

Source

# File activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb, line 793
      def remove_foreign_key(from_table, options_or_to_table = {})
        return unless supports_foreign_keys?

        if options_or_to_table.is_a?(Hash)
          options = options_or_to_table
        else
          options = { column: foreign_key_column_for(options_or_to_table) }
        end

        fk_name_to_delete = options.fetch(:name) do
          fk_to_delete = foreign_keys(from_table).detect {|fk| fk.column == options[:column].to_s }

          if fk_to_delete
            fk_to_delete.name
          else
            raise ArgumentError, "Table '#{from_table}' has no foreign key on column '#{options[:column]}'"
          end
        end

        at = create_alter_table from_table
        at.drop_foreign_key fk_name_to_delete

        execute schema_creation.accept(at)
      end

Defined in activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb line 793 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveRecord::ConnectionAdapters::SchemaStatements

Signature

Parameters