Module: ActiveRecord::ConnectionAdapters::PostgreSQL::Quoting

Included in:
ActiveRecord::ConnectionAdapters::PostgreSQLAdapter
Defined in:
activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb

Instance Method Summary collapse

Instance Method Details

#escape_bytea(value) ⇒ Object

Escapes binary strings for bytea input to the database.


6
7
8
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 6

def escape_bytea(value)
  @connection.escape_bytea(value) if value
end

#quote_column_name(name) ⇒ Object

Quotes column names for use in SQL queries.


39
40
41
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 39

def quote_column_name(name) #:nodoc:
  PGconn.quote_ident(name.to_s)
end

#quote_default_value(value, column) ⇒ Object

Does not quote function default values for UUID columns


59
60
61
62
63
64
65
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 59

def quote_default_value(value, column) #:nodoc:
  if column.type == :uuid && value =~ /\(\)/
    value
  else
    quote(value, column)
  end
end

#quote_string(s) ⇒ Object

Quotes strings for use in SQL input.


18
19
20
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 18

def quote_string(s) #:nodoc:
  @connection.escape(s)
end

#quote_table_name(name) ⇒ Object

Checks the following cases:

  • table_name

  • “table.name”

  • schema_name.table_name

  • schema_name.“table.name”

  • “schema.name”.table_name

  • “schema.name”.“table.name”


30
31
32
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 30

def quote_table_name(name)
  Utils.extract_schema_qualified_name(name.to_s).quoted
end

#quote_table_name_for_assignment(table, attr) ⇒ Object


34
35
36
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 34

def quote_table_name_for_assignment(table, attr)
  quote_column_name(attr)
end

#quoted_date(value) ⇒ Object

Quote date/time values for use in SQL input. Includes microseconds if the value is a Time responding to usec.


45
46
47
48
49
50
51
52
53
54
55
56
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 45

def quoted_date(value) #:nodoc:
  result = super
  if value.acts_like?(:time) && value.respond_to?(:usec)
    result = "#{result}.#{sprintf("%06d", value.usec)}"
  end

  if value.year <= 0
    bce_year = format("%04d", -value.year + 1)
    result = result.sub(/^-?\d+/, bce_year) + " BC"
  end
  result
end

#unescape_bytea(value) ⇒ Object

Unescapes bytea output from a database to the binary string it represents. NOTE: This is NOT an inverse of escape_bytea! This is only to be used on escaped binary output from database drive.


13
14
15
# File 'activerecord/lib/active_record/connection_adapters/postgresql/quoting.rb', line 13

def unescape_bytea(value)
  @connection.unescape_bytea(value) if value
end