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.

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.