edge badge
Methods
B
C
E
I
R
S
U
Constants
MONEY_COLUMN_TYPE_OID = 790
 

The internal PostgreSQL identifier of the money data type.

BYTEA_COLUMN_TYPE_OID = 17
 

The internal PostgreSQL identifier of the BYTEA data type.

Instance Public methods
begin_db_transaction()

Begins a transaction.

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 215
def begin_db_transaction
  execute "BEGIN"
end
begin_isolated_db_transaction(isolation)
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 219
def begin_isolated_db_transaction(isolation)
  begin_db_transaction
  execute "SET TRANSACTION ISOLATION LEVEL #{transaction_isolation_levels.fetch(isolation)}"
end
commit_db_transaction()

Commits a transaction.

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 225
def commit_db_transaction
  execute "COMMIT"
end
create()
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 93
def create
  super.insert
end
exec_delete(sql, name = 'SQL', binds = [])
Also aliased as: exec_update
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 176
def exec_delete(sql, name = 'SQL', binds = [])
  execute_and_clear(sql, name, binds) {|result| result.cmd_tuples }
end
exec_insert(sql, name, binds, pk = nil, sequence_name = nil)
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 195
def exec_insert(sql, name, binds, pk = nil, sequence_name = nil)
  val = exec_query(sql, name, binds)
  if !use_insert_returning? && pk
    unless sequence_name
      table_ref = extract_table_ref_from_insert_sql(sql)
      sequence_name = default_sequence_name(table_ref, pk)
      return val unless sequence_name
    end
    last_insert_id_result(sequence_name)
  else
    val
  end
end
exec_query(sql, name = 'SQL', binds = [])
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 163
def exec_query(sql, name = 'SQL', binds = [])
  execute_and_clear(sql, name, binds) do |result|
    types = {}
    fields = result.fields
    fields.each_with_index do |fname, i|
      ftype = result.ftype i
      fmod  = result.fmod i
      types[fname] = get_oid_type(ftype, fmod, fname)
    end
    ActiveRecord::Result.new(fields, result.values, types)
  end
end
exec_update(sql, name = 'SQL', binds = [])
Alias for: exec_delete
execute(sql, name = nil)

Executes an SQL statement, returning a PGresult object on success or raising a PGError exception otherwise.

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 153
def execute(sql, name = nil)
  log(sql, name) do
    @connection.async_exec(sql)
  end
end
explain(arel, binds = [])
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 5
def explain(arel, binds = [])
  sql = "EXPLAIN #{to_sql(arel, binds)}"
  ExplainPrettyPrinter.new.pp(exec_query(sql, 'EXPLAIN', binds))
end
insert_sql(sql, name = nil, pk = nil, id_value = nil, sequence_name = nil)

Executes an INSERT query and returns the new record's ID

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 76
def insert_sql(sql, name = nil, pk = nil, id_value = nil, sequence_name = nil)
  unless pk
    # Extract the table from the insert sql. Yuck.
    table_ref = extract_table_ref_from_insert_sql(sql)
    pk = primary_key(table_ref) if table_ref
  end

  if pk && use_insert_returning?
    select_value("#{sql} RETURNING #{quote_column_name(pk)}")
  elsif pk
    super
    last_insert_id_value(sequence_name || default_sequence_name(table_ref, pk))
  else
    super
  end
end
rollback_db_transaction()

Aborts a transaction.

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 230
def rollback_db_transaction
  execute "ROLLBACK"
end
select_rows(sql, name = nil, binds = [])

Executes a SELECT query and returns an array of rows. Each row is an array of field values.

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 69
def select_rows(sql, name = nil, binds = [])
  execute_and_clear(sql, name, binds) do |result|
    result.values
  end
end
select_value(arel, name = nil, binds = [])
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 47
def select_value(arel, name = nil, binds = [])
  arel, binds = binds_from_relation arel, binds
  sql = to_sql(arel, binds)
  execute_and_clear(sql, name, binds) do |result|
    result.getvalue(0, 0) if result.ntuples > 0 && result.nfields > 0
  end
end
select_values(arel, name = nil)
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 55
def select_values(arel, name = nil)
  arel, binds = binds_from_relation arel, []
  sql = to_sql(arel, binds)
  execute_and_clear(sql, name, binds) do |result|
    if result.nfields > 0
      result.column_values(0)
    else
      []
    end
  end
end
sql_for_insert(sql, pk, id_value, sequence_name, binds)
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 181
def sql_for_insert(sql, pk, id_value, sequence_name, binds)
  unless pk
    # Extract the table from the insert sql. Yuck.
    table_ref = extract_table_ref_from_insert_sql(sql)
    pk = primary_key(table_ref) if table_ref
  end

  if pk && use_insert_returning?
    sql = "#{sql} RETURNING #{quote_column_name(pk)}"
  end

  [sql, binds]
end
substitute_at(column, index = 0)
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 159
def substitute_at(column, index = 0)
  Arel::Nodes::BindParam.new "$#{index + 1}"
end
update_sql(sql, name = nil)

Executes an UPDATE query and returns the number of affected tuples.

# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 210
def update_sql(sql, name = nil)
  super.cmd_tuples
end