---
name: "DBIx::SearchBuilder::Handle::Pg"
section: "3pm"
platform: "linux"
package: "libdbix-searchbuilder-perl"
version: "1.82-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/DBIx::SearchBuilder::Handle::Pg"
---

# DBIx::SearchBuilder::Handle::Pg(3pm)

## 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.