pg_saurus 2.6.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ac981228ed8e84757476a5e00555cdf6ff508899
-  data.tar.gz: 025dc5a547d596936f29462d1d7e66aaeee69a45
+  metadata.gz: dabef7560c6d27d491206e5ba2f067d23d05c8bd
+  data.tar.gz: 8199a937694563d6a5fd411bff53485720280419
 SHA512:
-  metadata.gz: 1a9d3eda759d78807d7f49588e618c008f7fdb8598bd4e3bce70094da71788ba15688b06ed098fa3d276ad4d30e22b9fba3e14d87545a0f9e186e9b028f03e61
-  data.tar.gz: 00478b86f83957ccd27042eb6eca4d88749868e1afeebcdce1fc97c54a3721157161d7045ee5e8909429e458bb2de5b9e9f07e8dd2e74636d79a13aabcec7359
+  metadata.gz: 7dadad30b8423ca3ac3ac500542e09d3cfceef0e37d77e7d5747e46f193c157cd7340573d4d64c3002e2d24ba3b9b52f859fbe7f0072b04d8dfc5eac083bdae2
+  data.tar.gz: d9906693fe2dc28b459dc18fa263714343355c252eb53c9c63264f8cb077c76c41106c79c1b29e9acdd92adf403cc7e2c599befc44c53380b418f3ab09bbbb5e

data/README.markdown

@@ -1,27 +1,43 @@
 # PgSaurus
 
 [![Build Status](https://secure.travis-ci.org/HornsAndHooves/pg_saurus.png)](http://travis-ci.org/HornsAndHooves/pg_saurus)
-[![Dependency Status](https://gemnasium.com/HornsAndHooves/pg_saurus.png)](https://gemnasium.com/HornsAndHooves/pg_saurus)
 [![Code Climate](https://codeclimate.com/github/HornsAndHooves/pg_saurus/badges/gpa.svg)](https://codeclimate.com/github/HornsAndHooves/pg_saurus)
-ActiveRecord extension to get more from PostgreSQL:
 
-* Create/drop schemas.
-* Set/remove comments on columns and tables.
-* Use foreign keys.
-* Use partial indexes.
-* Run index creation concurrently.
-* Create/drop functions.
-* Create/drop triggers.
+An ActiveRecord extension to get more from PostgreSQL:
+
+* Create/drop [schemas](#schemas).
+* Use existing functionality in the context of [schemas](#schemas).
+* Set/remove [comments on columns and tables](#table-and-column-comments).
+* [Enhancements to the Rails 4.2 foreign key support](#foreign-keys).
+* Use [partial indexes](#partial-indexes).
+* Use [indexes on expressions](#indexes-on-expressions).
+* [Run index creation concurrently](#concurrent-index-creation).
+* Create/drop [views](#views).
+* Create/drop [functions](#functions).
+* Create/drop [triggers](#triggers).
+* [Load/unload postgres extensions](#loadingunloading-postgresql-extension-modules).
+* [Select a specific DB role to conduct a migration](#roles).
+* Use yet more [tools](#tools).
 
 PgSaurus is a fork of PgPower.
 
+### More information
+
+* [Environment notes](#environment-notes)
+* [Running tests](#running-tests)
+* [TODO](#todo)
+* [Credits](#credits)
+* [Copyright and License](#copyright-and-license)
+* [Contributing](#contributing)
+
 ## Environment notes
 
-PgSaurus was tested with Rails 4.0.x, Ruby 2.1.2.
+PgSaurus v3 was tested with Rails 4.2, Ruby 2.2.4. For Rails 4.1, use PgSaurus v2.5+.
+
+NOTE: JRuby is not supported. The current ActiveRecord JDBC adapter has its own Rails4-compatible
+method named "create_schema" which conflicts with this gem.
 
-NOTE: JRuby is not yet supported. The current ActiveRecord JDBC
-adapter has its own Rails4-compatible method named "create_schema" which
-conflicts with this gem.
+NOTE: PgSaurus does not support Rails 3.
 
 ## Schemas
 
@@ -45,7 +61,7 @@ end
 Use schema `:schema` option to specify schema name:
 
 ```ruby
-create_table "countries", :schema => "demography" do |t|
+create_table "countries", schema: "demography" do |t|
   # columns goes here
 end
 ```
@@ -93,15 +109,15 @@ remove_column_comment :phone_numbers, :npa
 Set comments on multiple columns in the table.
 
 ```ruby
-set_column_comments :phone_numbers, :npa => 'Numbering Plan Area Code - Allowed ranges: [2-9] for first digit, [0-9] for second and third digit.',
-                                    :nxx => 'Central Office Number'
+set_column_comments :phone_numbers, npa: 'Numbering Plan Area Code - Allowed ranges: [2-9] for first digit, [0-9] for second and third digit.',
+                                    nxx: 'Central Office Number'
 ```
 Remove comments from multiple columns in the table.
 
 ```ruby
 remove_column_comments :phone_numbers, :npa, :nxx
 ```
-PgSaurus also adds extra methods to change_table.
+PgSaurus also adds extra table methods to the `change_table` block.
 
 Set comments:
 
@@ -112,8 +128,8 @@ change_table :phone_numbers do |t|
 end
 
 change_table :phone_numbers do |t|
-  t.set_column_comments :npa => 'Numbering Plan Area Code - Allowed ranges: [2-9] for first digit, [0-9] for second and third digit.',
-                        :nxx => 'Central Office Number'
+  t.set_column_comments npa: 'Numbering Plan Area Code - Allowed ranges: [2-9] for first digit, [0-9] for second and third digit.',
+                        nxx: 'Central Office Number'
 end
 ```
 Remove comments:
@@ -130,46 +146,63 @@ end
 ```
 ## Foreign keys
 
-PgPower imported some code of [foreigner](https://github.com/matthuhiggins/foreigner)
-gem and patched it to be schema-aware. Support was also added for index auto-generation.
-
-You should disable `foreigner` in your Gemfile if you want to use `pg_saurus`.
-
-If you do not want to generate an index, pass the :exclude_index => true option.
+PgSaurus v3 augments Rails 4.2's foreign key methods with:
 
-The syntax is compatible with `foreigner`:
+* schema support
+* index auto-generation
 
+When you create a foreign key PgSaurus automatically creates an index.
+If you do not want to generate an index, pass the `exclude_index: true` option.
+The syntax is compatible with Rails 4.2's foreign key handling methods.
 
-Add foreign key from `comments` to `posts` using `post_id` column as key by default:
+It works with schemas as expected:
 
 ```ruby
-add_foreign_key(:comments, :posts)
+add_foreign_key('blog.comments', 'blog.posts')
 ```
-Specify key explicitly:
+Adds the index `'index_comments_on_post_id'`:
 
 ```ruby
-add_foreign_key(:comments, :posts, :column => :blog_post_id)
+add_foreign_key(:comments, :posts)
 ```
-Specify name of foreign key constraint:
+Does not add an index:
 
 ```ruby
-add_foreign_key(:comments, :posts, :name => "comments_posts_fk")
+add_foreign_key(:comments, :posts, exclude_index: true)
 ```
-It works with schemas as expected:
+
+Note that removing a foreign key does not drop the index of the foreign key column.
+If you want to remove the index, pass in the `remove_index: true` option.
 
 ```ruby
-add_foreign_key('blog.comments', 'blog.posts')
+remove_foreign_key(:comments, column: :post_id, remove_index: true)
 ```
-Adds the index 'index_comments_on_post_id':
+
+
+### Migration notes - upgrading from Rails 4.1
+
+PgSaurus v3+ now uses the Rails 4.2 semantics for `add_foreign_key` and `remove_foreign_key`. See http://api.rubyonrails.org/v4.2/classes/ActiveRecord/ConnectionAdapters/SchemaStatements.html
+
+A few things have changed. The most breaking change is that the syntax `remove_foreign_key :from_table, :to_table, options` no longer works.
 
 ```ruby
-add_foreign_key(:comments, :posts)
+#THIS FAILS
+remove_foreign_key :comments, :posts, remove_index: true
+
+#DO THIS INSTEAD
+remove_foreign_key :comments, column: :post_id, remove_index: true
 ```
-Does not add an index:
+
+For adding foreign keys, the `:dependent` option is replaced with `:on_delete` and `:on_update`. The `:delete` value is replaced with `:cascade`.
 
 ```ruby
-add_foreign_key(:comments, :posts, :exclude_index => true)
+#OLD STYLE - NO LONGER WORKS
+add_foreign_key :comments, :posts, dependent: :delete
+
+#NEW STYLE - DO THIS INSTEAD
+add_foreign_key :comments, :posts, on_delete: :cascade
 ```
+
 ## Partial Indexes
 
 Rails 4.x [pull request](https://github.com/rails/rails/pull/4956) was used as a
@@ -177,15 +210,15 @@ starting point to patch it to be schema-aware.
 
 ### Examples
 
-Add a partial index to a table
+Add a partial index to a table:
 
 ```ruby
-add_index(:comments, [:country_id, :user_id], :where => 'active')
+add_index(:comments, [:country_id, :user_id], where: 'active')
 ```
-Add a partial index to a schema table
+Add a partial index to a schema table:
 
 ```ruby
-add_index('blog.comments', :user_id, :where => 'active')
+add_index('blog.comments', :user_id, where: 'active')
 ```
 ## Indexes on Expressions
 
@@ -194,67 +227,67 @@ expressions are supported.
 
 ### Examples
 
-Add an index to a column with a function
+Add an index to a column with a function:
 
 ```ruby
 add_index(:comments, "lower(text)")
 ```
 
-You can also specify index access method
+You can also specify the index access method:
 
 ```ruby
 create_extension 'btree_gist'
 create_extension 'fuzzystrmatch'
-add_index(:comments, 'dmetaphone(author)', :using => 'gist')
+add_index(:comments, 'dmetaphone(author)', using: 'gist')
 ```
 
 ## Concurrent index creation
 
-PostgreSQL supports concurent index creation. We added that feature to migration
-DSL on index and foreign keys creation.
+PostgreSQL supports concurrent index creation. PgSaurus supports that feature by adding support
+to the migration DSL on index and foreign key creation.
 
 ### Examples
 
-Add an index concurrently to a table
+Add an index concurrently to a table:
 
 ```ruby
-add_index :table, :column_id, :concurrently => true
+add_index :table, :column_id, concurrently: true
 ```
 
-Add an index concurrently along with foreign key
+Add an index concurrently along with foreign key:
 
 ```ruby
-add_foreign_key :table1, :table2, :column => :column_id, :concurrent_index => true
+add_foreign_key :table1, :table2, column: :column_id, concurrent_index: true
 ```
 
 ## Loading/Unloading postgresql extension modules
 
-Postgresql is shipped with a number of [extension modules](http://www.postgresql.org/docs/9.1/static/contrib.html).
+PostgreSQL ships with a number of [extension modules](http://www.postgresql.org/docs/9.4/static/contrib.html).
 PgSaurus provides some tools
-to [load](http://www.postgresql.org/docs/9.1/static/sql-createextension.html)/[unload](http://www.postgresql.org/docs/9.1/static/sql-dropextension.html)
-such modules by the means of migrations.
+to [load](http://www.postgresql.org/docs/9.4/static/sql-createextension.html) and
+[unload](http://www.postgresql.org/docs/9.4/static/sql-dropextension.html)
+such modules using migrations.
 
-Please note. CREATE/DROP EXTENSION command has been introduced in postgresql 9.1 only.
-So this functionality will not be available for the previous versions.
+Please note: `CREATE`/`DROP EXTENSION` command was introduced in PostgreSQL 9.1.
+So this functionality is not available in previous versions.
 
 ### Examples
 
-Load [fuzzystrmatch](http://www.postgresql.org/docs/9.1/static/fuzzystrmatch.html) extension module
-and create its objects in schema *public*:
+Load [fuzzystrmatch](http://www.postgresql.org/docs/9.4/static/fuzzystrmatch.html)
+extension module; and create its objects in schema *public*:
 
 ```ruby
 create_extension "fuzzystrmatch"
 ```
 
-
-Load version *1.0* of the [btree_gist](http://www.postgresql.org/docs/9.1/static/btree-gist.html) extension module
-and create its objects in schema *demography*.
+Load version *1.0* of the [btree_gist](http://www.postgresql.org/docs/9.4/static/btree-gist.html)
+extension module; and create its objects in schema *demography*.
 
 ```ruby
-create_extension "btree_gist", :schema_name => "demography", :version => "1.0"
+create_extension "btree_gist", schema_name: "demography", version: "1.0"
 ```
 
-Unload extension module:
+Unload an extension module:
 
 ```ruby
 drop_extension "fuzzystrmatch"
@@ -262,13 +295,15 @@ drop_extension "fuzzystrmatch"
 
 ## Views
 
-Version 1.6.0 introduces experimental support for creating views. This API should only be used
+PgSaurus v1.6.0 introduced experimental support for creating views. This API should only be used
 with the understanding that it is preliminary 'alpha' at best.
 
-### Example
+### Examples
 
 ```ruby
 create_view "demography.citizens_view", "select * from demography.citizens"
+
+drop_view "demography.citizens_view"
 ```
 
 ## Roles
@@ -303,10 +338,10 @@ end
 ```
 
 You may force all migrations to have `set_role`, for this, configure PgSaurus with
-`ensure_role_set=true`:
+`ensure_role_set = true`:
 
 ```ruby
-PgSaurus.configre do |config|
+PgSaurus.configure do |config|
   config.ensure_role_set = true
 end
 ```
@@ -317,8 +352,9 @@ You can create, list, and drop functions.
 
 ### Examples
 
+Create a function:
+
 ```ruby
-# Create a function
 pets_not_empty_function = <<-SQL
 BEGIN
   IF (SELECT COUNT(*) FROM pets) > 0
@@ -329,13 +365,18 @@ BEGIN
   END IF;
 END;
 SQL
+
 # Arguments are: function_name, return_type, function_definition, options (currently, only :schema)
 create_function 'pets_not_empty()', :boolean, pets_not_empty_function, schema: 'public'
+```
+Drop a function:
 
-# Drop a function
+```ruby
 drop_function 'pets_not_empty()'
+```
+Get a list of defined functions:
 
-# Get a list of defined functions
+```ruby
 ActiveRecord::Base.connection.functions
 ```
 
@@ -345,28 +386,34 @@ You can create and remove triggers on tables and views.
 
 ### Examples
 
+Create a trigger:
+
 ```ruby
-# Create a trigger
 create_trigger :pets,                           # Table or view name
                :pets_not_empty_trigger_proc,    # Procedure name. Parentheses are optional if you have no arguments.
                'AFTER INSERT',                  # Trigger event
-               for_each: 'ROW',                 # Can be row or statement. Default is row.
+               for_each: 'ROW',                 # Can be a row or a statement. Default is row.
                schema: 'public',                # Optional schema name
-               constraint: true,                # Sets if the trigger is a constraint. Default is false.
-               deferrable: true,                # Sets if the trigger is immediate or deferrable. Default is immediate.
-               initially_deferred: true,        # Sets if the trigger is initially deferred. Default is immediate. Only relevant if the trigger is deferrable.
+               constraint: true,                # Sets whether the trigger is a constraint. Default is false.
+               deferrable: true,                # Sets whether the trigger is immediate or deferrable. Default is immediate.
+               initially_deferred: true,        # Sets whether the trigger is initially deferred. Default is immediate.
+                                                # Only relevant if the trigger is deferrable.
                condition: "new.name = 'fluffy'" # Optional when condition. Default is none.
+```
+Drop a trigger:
 
-# Drop a trigger
+```ruby
 remove_trigger :pets, :pets_not_empty_trigger_proc
+```
+Get a list of defined triggers on a table or view:
 
-# Get a list of defined triggers on a table or view
+```ruby
 ActiveRecord::Base.connection.triggers
 ```
 
 ## Tools
 
-PgSaurus::Tools provides a number of useful methods:
+PgSaurus::Tools provides a number of useful methods for managing schemas, etc.:
 
 ```ruby
 PgSaurus::Tools.create_schema "services"                 # => create new PG schema "services"
@@ -378,51 +425,47 @@ PgSaurus::Tools.schemas                                  # => ["public", "inform
 PgSaurus::Tools.index_exists?(table, columns, options)   # => returns true if an index exists for the given params
 ```
 
-## Rails 3
-
-PgSaurus does not support Rails 3.
-
-## Running tests:
+## Running tests
 
-* Ensure your postgresql has postgres-contrib (Ubuntu) package installed. Tests depend on btree_gist and fuzzystrmatch extensions
- * If on Mac, see below for installing contrib packages
+* Ensure your `postgresql` has `postgres-contrib` (if you're on Ubuntu) package installed. Tests depend on the `btree_gist` and `fuzzystrmatch` extensions
+ * If you're on a Mac, see below for installing contrib packages
 * Configure `spec/dummy/config/database.yml` for development and test environments.
 * Run `rake spec`.
 * Make sure migrations don't raise exceptions and all specs pass.
 
 ### Installing contrib packages on Mac OS X:
-* This assumes you are using MacPorts to install Postgres.  If using homebrew or the Postgres App, you will need to adjust the instructions accordingly (please add to this README when you do)
-* Assuming you installed with default options (including auto-clean), you will need to rebuild the postgresql port and keep the build files
- * `sudo port -k -s build postgresql91`
+* This assumes you are using [MacPorts](https://www.macports.org) to install `postgresql`. If you're using [Homebrew](http://brew.sh) or the Postgres App, you will need to adjust the instructions accordingly (please add to this README when you do)
+* Assuming you installed with default options (including auto-clean), you will need to rebuild the `postgresql` port and keep the build files
+ * `sudo port -k -s build postgresql94`
  * (adjust the version number above appropriately)
-* Now you can make and install the btree_gist and any other contrib modules
- * `cd ```port work postgresql91```/postgresql-9.1.7/contrib/btree_gist`
+* Now you can make and install the `btree_gist` and any other contrib modules
+ * `cd $(port work postgresql94)/postgresql-9.4.7/contrib/btree_gist`
  * (again, you may need to adjust the version number to your specific version)
  * `sudo make all`
  * `sudo make install`
 * Done!
 
-## TODO:
+## TODO
 
-Support for Rails 4.2+
+Support for Rails 5+
 
-* This will likely necessitate a major rewrite.
+* Rails 5 introduces its own schema support. PgSaurus v4+ will have to drop any conflicting support and modify its other features to accommodate Rails 5's schema support.
 
-Support for JRuby:
+Possible support for JRuby:
 
 * Jdbc driver provides its own `create_schema(schema, user)` method - solve conflicts.
 
 ## Credits
 
-* [Potapov Sergey](https://github.com/greyblake) - schema support
-* [Arthur Shagall](https://github.com/albertosaurus) - function support - and thanks for [pg_comment](https://github.com/albertosaurus/pg_comment)
-* [Matthew Higgins](https://github.com/matthuhiggins) - thanks for [foreigner](https://github.com/matthuhiggins/foreigner), which was used as a base for the foreign key support
+* [Potapov Sergey](https://github.com/greyblake) - schema support, role support
+* [Arthur Shagall](https://github.com/albertosaurus) - function and trigger support, Rails 4.2 support - and thanks for [pg_comment](https://github.com/albertosaurus/pg_comment)
+* [Mitya Lyubarskyy](https://github.com/MityaLiu) - view support, Rails 4.2 support
 * [Artem Ignatyev](https://github.com/cryo28) - extension modules load/unload support
 * [Marcelo Silveira](https://github.com/mhfs) - thanks for rails partial index support that was backported into this gem
 
 ## Copyright and License
 
-* Copyright (c) 2015 HornsAndHooves.
+* Copyright (c) 2016 HornsAndHooves.
 * Initial foreign key code taken from foreigner, Copyright (c) 2009 Matthew Higgins
 * pg_comment Copyright (c) 2011 Arthur Shagall
 * Partial index Copyright (c) 2012 Marcelo Silveira

data/lib/core_ext/active_record/connection_adapters/postgresql_adapter.rb

@@ -30,7 +30,8 @@ module ActiveRecord # :nodoc:
       # Search using provided schema if table_name includes schema name.
       #
       def index_name_exists?(table_name, index_name, default)
-        schema, table = Utils.extract_schema_and_table(table_name)
+        postgre_sql_name = PostgreSQL::Utils.extract_schema_qualified_name(table_name)
+        schema, table = postgre_sql_name.schema, postgre_sql_name.identifier
         schemas = schema ? "ARRAY['#{schema}']" : 'current_schemas(false)'
 
         exec_query(<<-SQL, 'SCHEMA').rows.first[0].to_i > 0
@@ -65,7 +66,8 @@ module ActiveRecord # :nodoc:
       # the custom {PgSaurus::ConnectionAdapters::IndexDefinition}
       #
       def indexes(table_name, name = nil)
-        schema, table = Utils.extract_schema_and_table(table_name)
+        postgre_sql_name = PostgreSQL::Utils.extract_schema_qualified_name(table_name)
+        schema, table = postgre_sql_name.schema, postgre_sql_name.identifier
         schemas = schema ? "ARRAY['#{schema}']" : 'current_schemas(false)'
 
         result = query(<<-SQL, name)

data/lib/pg_saurus/connection_adapters/abstract_adapter.rb

@@ -4,14 +4,12 @@ module PgSaurus::ConnectionAdapters::AbstractAdapter
   extend ActiveSupport::Concern
 
   autoload :CommentMethods
-  autoload :ForeignerMethods
   autoload :SchemaMethods
   autoload :IndexMethods
   autoload :FunctionMethods
   autoload :TriggerMethods
 
   include CommentMethods
-  include ForeignerMethods
   include SchemaMethods
   include IndexMethods
   include FunctionMethods

data/lib/pg_saurus/connection_adapters/postgresql_adapter/foreign_key_methods.rb

@@ -0,0 +1,105 @@
+module PgSaurus # :nodoc:
+  # Provides methods to extend {ActiveRecord::ConnectionAdapters::PostgreSQLAdapter}
+  # to support foreign keys feature.
+  module ConnectionAdapters::PostgreSQLAdapter::ForeignKeyMethods
+
+    # Drop table and optionally disable triggers.
+    # Changes adapted from https://github.com/matthuhiggins/foreigner/blob/e72ab9c454c156056d3f037d55e3359cd972af32/lib/foreigner/connection_adapters/sql2003.rb
+    # NOTE: Disabling referential integrity requires superuser access in postgres.
+    #       Default AR behavior is just to drop_table.
+    #
+    # == Options:
+    # * :force - force disabling of referential integrity
+    #
+    # Note: I don't know a good way to test this -mike 20120420
+    def drop_table(*args)
+      options = args.clone.extract_options!
+      if options[:force]
+        disable_referential_integrity { super }
+      else
+        super
+      end
+    end
+
+    # See activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb
+    # Creates index on the FK column by default. Pass in the option :exclude_index => true
+    # to disable this.
+    def add_foreign_key_with_index(from_table, to_table, options = {})
+      exclude_index = (options.has_key?(:exclude_index) ? options.delete(:exclude_index) : false)
+      column        = options[:column] || foreign_key_column_for(to_table)
+
+      if index_exists?(from_table, column) && !exclude_index
+        raise PgSaurus::IndexExistsError,
+              "The index, #{index_name(from_table, column)}, already exists." \
+          "  Use :exclude_index => true when adding the foreign key."
+      end
+
+      add_foreign_key_without_index from_table, to_table, options
+
+      unless exclude_index
+        add_index from_table, column
+      end
+    end
+
+    # See activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb
+    def remove_foreign_key_with_index(from_table, options_or_to_table = {})
+      if options_or_to_table.is_a?(Hash) && options_or_to_table[:remove_index]
+        column = options_or_to_table[:column]
+        remove_index from_table, column
+      end
+
+      remove_foreign_key_without_index(from_table, options_or_to_table)
+    end
+
+    # See: activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb
+    def foreign_key_column_for_with_schema(table_name)
+      table = table_name.to_s.split('.').last
+
+      foreign_key_column_for_without_schema table
+    end
+
+    # see activerecord/lib/active_record/connection_adapters/postgresql/schema_statements.rb
+    def foreign_keys_with_schema(table_name)
+      namespace  = table_name.to_s.split('.').first
+      table_name = table_name.to_s.split('.').last
+
+      namespace  = if namespace == table_name
+                     "ANY (current_schemas(false))"
+                   else
+                     quote(namespace)
+                   end
+
+      sql = <<-SQL.strip_heredoc
+            SELECT t2.oid::regclass::text AS to_table, a1.attname AS column, a2.attname AS primary_key, c.conname AS name, c.confupdtype AS on_update, c.confdeltype AS on_delete, t3.nspname AS from_schema
+            FROM pg_constraint c
+            JOIN pg_class t1 ON c.conrelid = t1.oid
+            JOIN pg_class t2 ON c.confrelid = t2.oid
+            JOIN pg_attribute a1 ON a1.attnum = c.conkey[1] AND a1.attrelid = t1.oid
+            JOIN pg_attribute a2 ON a2.attnum = c.confkey[1] AND a2.attrelid = t2.oid
+            JOIN pg_namespace t3 ON c.connamespace = t3.oid
+            WHERE c.contype = 'f'
+              AND t1.relname = #{quote(table_name)}
+              AND t3.nspname = #{namespace}
+            ORDER BY c.conname
+      SQL
+
+      fk_info = select_all(sql)
+
+      fk_info.map do |row|
+        options = {
+          column:      row['column'],
+          name:        row['name'],
+          primary_key: row['primary_key'],
+          from_schema: row['from_schema']
+        }
+
+        options[:on_delete] = extract_foreign_key_action(row['on_delete'])
+        options[:on_update] = extract_foreign_key_action(row['on_update'])
+
+        ::ActiveRecord::ConnectionAdapters::ForeignKeyDefinition.new(table_name, row['to_table'], options)
+      end
+    end
+
+
+  end
+end

data/lib/pg_saurus/connection_adapters/postgresql_adapter/schema_methods.rb

@@ -34,6 +34,14 @@ module PgSaurus::ConnectionAdapters::PostgreSQLAdapter::SchemaMethods
     ::PgSaurus::Tools.drop_schema_if_exists(schema_name)
   end
 
+  # Provide :schema option to +drop_table+ method.
+  def drop_table_with_schema_option(table_name, options = {})
+    options     = options.dup
+    schema_name = options.delete(:schema)
+    table_name  = "#{schema_name}.#{table_name}" if schema_name
+    drop_table_without_schema_option(table_name, options)
+  end
+
   # Make method +tables+ return tables not only from public schema.
   #
   # @note

data/lib/pg_saurus/connection_adapters/postgresql_adapter.rb

@@ -8,7 +8,7 @@ module PgSaurus::ConnectionAdapters::PostgreSQLAdapter
   autoload :ExtensionMethods,   'pg_saurus/connection_adapters/postgresql_adapter/extension_methods'
   autoload :SchemaMethods,      'pg_saurus/connection_adapters/postgresql_adapter/schema_methods'
   autoload :CommentMethods,     'pg_saurus/connection_adapters/postgresql_adapter/comment_methods'
-  autoload :ForeignerMethods,   'pg_saurus/connection_adapters/postgresql_adapter/foreigner_methods'
+  autoload :ForeignKeyMethods,  'pg_saurus/connection_adapters/postgresql_adapter/foreign_key_methods'
   autoload :IndexMethods,       'pg_saurus/connection_adapters/postgresql_adapter/index_methods'
   autoload :TranslateException, 'pg_saurus/connection_adapters/postgresql_adapter/translate_exception'
   autoload :ViewMethods,        'pg_saurus/connection_adapters/postgresql_adapter/view_methods'
@@ -18,7 +18,7 @@ module PgSaurus::ConnectionAdapters::PostgreSQLAdapter
   include ExtensionMethods
   include SchemaMethods
   include CommentMethods
-  include ForeignerMethods
+  include ForeignKeyMethods
   include IndexMethods
   include TranslateException
   include ViewMethods
@@ -28,6 +28,18 @@ module PgSaurus::ConnectionAdapters::PostgreSQLAdapter
   included do
     alias_method_chain :tables, :non_public_schema_tables
     alias_method_chain :add_index, :concurrently
+    alias_method_chain :drop_table, :schema_option
     alias_method_chain :rename_table, :schema_option
+
+    alias_method_chain :add_foreign_key, :index
+    alias_method_chain :remove_foreign_key, :index
+    alias_method_chain :foreign_key_column_for, :schema
+    alias_method_chain :foreign_keys, :schema
+
+    ::ActiveRecord::ConnectionAdapters::ForeignKeyDefinition.module_eval do
+      def from_schema
+        options[:from_schema] || 'public'
+      end
+    end
   end
 end