Methods
- begin_db_transaction
- begin_isolated_db_transaction
- commit_db_transaction
- exec_delete
- exec_insert
- exec_query
- exec_rollback_db_transaction
- exec_update
- execute
- explain
Instance Public methods
begin_db_transaction()
Begins a transaction.
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 110
def begin_db_transaction
execute("BEGIN", "TRANSACTION")
end
🔎 See on GitHub
begin_isolated_db_transaction(isolation)
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 114
def begin_isolated_db_transaction(isolation)
begin_db_transaction
execute "SET TRANSACTION ISOLATION LEVEL #{transaction_isolation_levels.fetch(isolation)}"
end
🔎 See on GitHub
commit_db_transaction()
Commits a transaction.
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 120
def commit_db_transaction
execute("COMMIT", "TRANSACTION")
end
🔎 See on GitHub
exec_delete(sql, name = nil, binds = [])
Also aliased as: exec_update
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 71
def exec_delete(sql, name = nil, binds = [])
execute_and_clear(sql, name, binds) { |result| result.cmd_tuples }
end
🔎 See on GitHub
exec_insert(sql, name = nil, binds = [], pk = nil, sequence_name = nil)
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 91
def exec_insert(sql, name = nil, binds = [], pk = nil, sequence_name = nil)
if use_insert_returning? || pk == false
super
else
result = exec_query(sql, name, binds)
unless sequence_name
table_ref = extract_table_ref_from_insert_sql(sql)
if table_ref
pk = primary_key(table_ref) if pk.nil?
pk = suppress_composite_primary_key(pk)
sequence_name = default_sequence_name(table_ref, pk)
end
return result unless sequence_name
end
last_insert_id_result(sequence_name)
end
end
🔎 See on GitHub
exec_query(sql, name = "SQL", binds = [], prepare: false)
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 54
def exec_query(sql, name = "SQL", binds = [], prepare: false)
execute_and_clear(sql, name, binds, prepare: prepare) do |result|
types = {}
fields = result.fields
fields.each_with_index do |fname, i|
ftype = result.ftype i
fmod = result.fmod i
case type = get_oid_type(ftype, fmod, fname)
when Type::Integer, Type::Float, OID::Decimal, Type::String, Type::DateTime, Type::Boolean
# skip if a column has already been type casted by pg decoders
else types[fname] = type
end
end
build_result(columns: fields, rows: result.values, column_types: types)
end
end
🔎 See on GitHub
exec_rollback_db_transaction()
Aborts a transaction.
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 125
def exec_rollback_db_transaction
execute("ROLLBACK", "TRANSACTION")
end
🔎 See on GitHub
execute(sql, name = nil)
Executes an SQL statement, returning a PG::Result object on success or raising a PG::Error exception otherwise. Note: the PG::Result object is manually memory managed; if you don't need it specifically, you may want consider the exec_query
wrapper.
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 39
def execute(sql, name = nil)
if preventing_writes? && write_query?(sql)
raise ActiveRecord::ReadOnlyError, "Write query attempted while in readonly mode: #{sql}"
end
materialize_transactions
mark_transaction_written_if_write(sql)
log(sql, name) do
ActiveSupport::Dependencies.interlock.permit_concurrent_loads do
@connection.async_exec(sql)
end
end
end
🔎 See on GitHub
explain(arel, binds = [])
📝 Source code
# File activerecord/lib/active_record/connection_adapters/postgresql/database_statements.rb, line 7
def explain(arel, binds = [])
sql = "EXPLAIN #{to_sql(arel, binds)}"
PostgreSQL::ExplainPrettyPrinter.new.pp(exec_query(sql, "EXPLAIN", binds))
end
🔎 See on GitHub