DBIx::SearchBuilder::Handle::Pg(3p)

NAME
  DBIx::SearchBuilder::Handle::Pg - A Postgres specific Handle object

SYNOPSIS

DESCRIPTION
This module provides a subclass of DBIx::SearchBuilder::Handle that compensates for some of the idiosyncrasies of Postgres.

METHODS

  Connect
Connect takes a hashref and passes it off to SUPER::Connect; Forces the timezone to GMT it returns a database handle.

  BuildDSN
Extend "BuildDNS" in DBIx::SearchBuilder::Handle to force "client_encoding" to be UTF-8, so that character strings can be safely passed to, and retrieved from, the database. See "Encoding" in DBD::Pg.

  Insert
Takes a table name as the first argument and assumes that the rest of the arguments are an array of key-value pairs to be inserted.

In case of insert failure, returns a Class::ReturnValue object preloaded with error info.

  InsertQueryString
Postgres sepcific overriding method for "InsertQueryString" in DBIx::SearchBuilder::Handle.

  IdSequenceName TABLE
Takes a TABLE name and returns the name of the sequence of the primary key for that table.

  BinarySafeBLOBs
Return undef, as no current version of postgres supports binary-safe blobs

  ApplyLimits STATEMENTREF ROWS_PER_PAGE FIRST_ROW
takes an SQL SELECT statement and massages it to return ROWS_PER_PAGE starting with FIRST_ROW;

  _MakeClauseCaseInsensitive FIELD OPERATOR VALUE
Takes a field, operator and value. performs the magic necessary to make your database treat this clause as case insensitive.

Returns a FIELD OPERATOR VALUE triple.

  DistinctQuery STATEMENTREF
takes an incomplete SQL SELECT statement and massages it to return a DISTINCT result set.

  SimpleDateTimeFunctions
Returns hash reference with specific date time functions of this database for "DateTimeFunction" in DBIx::SearchBuilder::Handle.

  ConvertTimezoneFunction
Custom implementation of "ConvertTimezoneFunction" in DBIx::SearchBuilder::Handle.

In Pg time and timestamp data types may be "with time zone" or "without time zone". So if Field argument is timestamp "with time zone" then From argument is not required and is useless. Otherwise From argument identifies time zone of the Field argument that is "without time zone".

For consistency with other DBs use timestamp columns without time zones and provide From argument.