GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DBIX::SEARCHBUILDER::HANDLE::ORACLE (3)

.ds Aq ’

NAME



  DBIx::SearchBuilder::Handle::Oracle - An oracle specific Handle object



CONTENTS

SYNOPSIS

DESCRIPTION

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

METHODS

    Connect PARAMHASH: Driver, Database, Host, User, Password

Takes a paramhash and connects to your DBI datasource.

    BuildDSN

Customized version of BuildDSN in DBIx::SearchBuilder::Handle method.

Takes additional argument SID. Database argument used unless SID provided. Two forms of DSN are generated depending on whether Host defined or not:



    dbi:Oracle:sid=<SID>;host=...[;port=...]
    dbi:Oracle:<SID>



Read details in documentation for DBD::Oracle module.

    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.

    InsertFromSelect

Customization of InsertFromSelect in DBIx::SearchBuilder::Handle.

Unlike other DBs Oracle needs:
o id generated from sequences for every new record.
o query wrapping in parens.
<B>NOTEB> that on Oracle there is a limitation on the query. Every column in the result should have unique name or alias, for example the following query would generate ORA-00918: column ambiguously defined error:



    SELECT g.id, u.id FROM ...



Solve with aliases:



    SELECT g.id AS group_id, u.id AS user_id FROM ...



    KnowsBLOBs

Returns 1 if the current database supports inserts of BLOBs automatically. Returns undef if the current database must be informed of BLOBs for inserts.

    BLOBParams FIELD_NAME FIELD_TYPE

Returns a hash ref for the bind_param call to identify BLOB types used by the current database for a particular column type. The current Oracle implementation only supports ORA_CLOB types (112).

    ApplyLimits STATEMENTREF ROWS_PER_PAGE FIRST_ROW

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

    DistinctQuery STATEMENTREF

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

    BinarySafeBLOBs

Return undef, as Oracle doesn’t support binary-safe CLOBS

    DatabaseVersion

Returns value of ORA_OCI constant, see Constants in DBI.

    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.

Use the following query to get list of timezones:



    SELECT tzname FROM v$timezone_names;



Read Oracle’s docs about timezone files:



    http://download.oracle.com/docs/cd/B14117_01/server.101/b10749/ch4datetime.htm#i1006667



AUTHOR

Jesse Vincent, jesse@fsck.com

SEE ALSO

perl(1), DBIx::SearchBuilder
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DBIX::SEARCHBUILDER::HANDLE::ORACLE (3) 2014-08-14

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.