class ActiveRecord::ConnectionAdapters::PostgreSQLAdapter
The PostgreSQL adapter works with the native C (bitbucket.org/ged/ruby-pg) driver.
Options:
-
:host
- Defaults to a Unix-domain socket in /tmp. On machines without Unix-domain sockets, the default is to connect to localhost. -
:port
- Defaults to 5432. -
:username
- Defaults to be the same as the operating system name of the user running the application. -
:password
- Password to be used if the server demands password authentication. -
:database
- Defaults to be the same as the user name. -
:schema_search_path
- An optional schema search path for the connection given as a string of comma-separated schema names. This is backward-compatible with the:schema_order
option. -
:encoding
- An optional client encoding that is used in aSET client_encoding TO <encoding>
call on the connection. -
:min_messages
- An optional client min messages that is used in aSET client_min_messages TO <min_messages>
call on the connection. -
:variables
- An optional hash of additional parameters that will be used inSET SESSION key = val
calls on the connection. -
:insert_returning
- An optional boolean to control the use ofRETURNING
forINSERT
statements defaults to true.
Any further options are used as connection parameters to libpq. See www.postgresql.org/docs/9.1/static/libpq-connect.html for the list of parameters.
In addition, default connection parameters of libpq can be set per environment variables. See www.postgresql.org/docs/9.1/static/libpq-envars.html .
Constants
- ADAPTER_NAME
- FOREIGN_KEY_VIOLATION
-
See www.postgresql.org/docs/9.1/static/errcodes-appendix.html
- NATIVE_DATABASE_TYPES
- UNIQUE_VIOLATION
Public Class Methods
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 226 def initialize(connection, logger, connection_parameters, config) super(connection, logger) @visitor = Arel::Visitors::PostgreSQL.new self if self.class.type_cast_config_to_boolean(config.fetch(:prepared_statements) { true }) @prepared_statements = true else @prepared_statements = false end @connection_parameters, @config = connection_parameters, config # @local_tz is initialized as nil to avoid warnings when connect tries to use it @local_tz = nil @table_alias_length = nil connect @statements = StatementPool.new @connection, self.class.type_cast_config_to_integer(config.fetch(:statement_limit) { 1000 }) if postgresql_version < 80200 raise "Your version of PostgreSQL (#{postgresql_version}) is too old, please upgrade!" end @type_map = Type::HashLookupTypeMap.new initialize_type_map(type_map) @local_tz = execute('SHOW TIME ZONE', 'SCHEMA').first["TimeZone"] @use_insert_returning = @config.key?(:insert_returning) ? self.class.type_cast_config_to_boolean(@config[:insert_returning]) : true end
Initializes and connects a PostgreSQL adapter.
Public Instance Methods
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 266 def active? @connection.query 'SELECT 1' true rescue PGError false end
Is this connection alive and ready for queries?
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 257 def clear_cache! @statements.clear end
Clears the prepared statements cache.
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 343 def disable_extension(name) exec_query("DROP EXTENSION IF EXISTS \"#{name}\" CASCADE").tap { reload_type_map } end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 292 def disconnect! super @connection.close rescue nil end
Disconnects from the database if already connected. Otherwise, this method does nothing.
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 337 def enable_extension(name) exec_query("CREATE EXTENSION IF NOT EXISTS \"#{name}\"").tap { reload_type_map } end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 349 def extension_enabled?(name) if supports_extensions? res = exec_query "SELECT EXISTS(SELECT * FROM pg_available_extensions WHERE name = '#{name}' AND installed_version IS NOT NULL) as enabled", 'SCHEMA' res.cast_values.first end end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 357 def extensions if supports_extensions? exec_query("SELECT extname from pg_extension", "SCHEMA").cast_values else super end end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 168 def index_algorithms { concurrently: 'CONCURRENTLY' } end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 138 def migration_keys super + [:array] end
Adds :array
as a valid migration key
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 274 def reconnect! super @connection.reset configure_connection end
Close then reopen the connection.
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 280 def reset! clear_cache! reset_transaction unless @connection.transaction_status == ::PG::PQTRANS_IDLE @connection.query 'ROLLBACK' end @connection.query 'DISCARD ALL' configure_connection end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 371 def session_auth=(user) clear_cache! exec_query "SET SESSION AUTHORIZATION #{user}" end
Set the authorized user for this session
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 311 def set_standard_conforming_strings execute('SET standard_conforming_strings = on', 'SCHEMA') end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 315 def supports_ddl_transactions? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 319 def supports_explain? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 324 def supports_extensions? postgresql_version >= 90100 end
Returns true if pg > 9.1
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 160 def supports_foreign_keys? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 148 def supports_index_sort_order? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 333 def supports_materialized_views? postgresql_version >= 90300 end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 302 def supports_migrations? true end
Returns true, since this connection adapter supports migrations.
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 152 def supports_partial_index? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 329 def supports_ranges? postgresql_version >= 90200 end
Range datatypes weren't introduced until PostgreSQL 9.2
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 144 def supports_statement_cache? true end
Returns true
, since this connection adapter supports prepared statement caching.
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 156 def supports_transaction_isolation? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 164 def supports_views? true end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 366 def table_alias_length @table_alias_length ||= query('SHOW max_identifier_length', 'SCHEMA')[0][0].to_i end
Returns the configured supported identifier length supported by PostgreSQL
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 261 def truncate(table_name, name = nil) exec_query "TRUNCATE TABLE #{quote_table_name(table_name)}", name, [] end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 376 def use_insert_returning? @use_insert_returning end
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 380 def valid_type?(type) !native_database_types[type].nil? end
Protected Instance Methods
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 406 def postgresql_version @connection.server_version end
Returns the version of the connected PostgreSQL server.
# File activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb, line 414 def translate_exception(exception, message) return exception unless exception.respond_to?(:result) case exception.result.try(:error_field, PGresult::PG_DIAG_SQLSTATE) when UNIQUE_VIOLATION RecordNotUnique.new(message, exception) when FOREIGN_KEY_VIOLATION InvalidForeignKey.new(message, exception) else super end end
© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.