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::SQLENGINE::DRIVER::ORACLE (3)

.ds Aq ’

NAME

DBIx::SQLEngine::Driver::Oracle - Support DBD::Oracle and DBD::ODBC/Oracle

CONTENTS

SYNOPSIS

<B>DBI WrapperB>: Adds methods to a DBI database handle.



  my $sqldb = DBIx::SQLEngine->new( dbi:oracle:test );



<B>Portability Subclasses:B> Uses driver’s idioms or emulation.



  $hash_ary = $sqldb->fetch_select(
    table => students
    limit => 5, offset => 10
  );



DESCRIPTION

This package provides a subclass of DBIx::SQLEngine which compensates for Oracle’s idiosyncrasies.

    About Driver Subclasses

You do not need to use this package directly; when you connect to a database, the SQLEngine object is automatically re-blessed in to the appropriate subclass.

FETCHING DATA (SQL DQL)

    Methods Used By Complex Queries

sql_limit() Adds support for SQL select limit clause.

Implemented as a subselect with ROWNUM.

EDITING DATA (SQL DML)

    Insert to Add Data

do_insert_with_sequence()


  $sqldb->do_insert_with_sequence( $sequence_name, %sql_clauses ) : $row_count



Implemented using _seq_do_insert_preinc and seq_increment.

    seq_increment



  $sqldb->seq_increment( $table, $field ) : $new_value



Increments the sequence, and returns the newly allocated value.

DEFINING STRUCTURES (SQL DDL)

    Detect Tables and Columns

sql_detect_table()


  $sqldb->sql_detect_table ( $tablename )  : %sql_select_clauses



Implemented using Oracle’s select * from $tablename limit 1.

    Column Type Methods

The following methods are used by sql_create_table to specify column information in a DBMS-specific fashion.
dbms_create_column_types()


  $sqldb->dbms_create_column_types () : %column_type_codes



Implemented using Oracle’s blob and number types.

Portability: Note that this capability is currently limited, and additional steps need to be taken to manually define sequences in Oracle.

dbms_create_column_text_long_type()


  $sqldb->dbms_create_column_text_long_type () : $col_type_str



Implemented using Oracle’s clob type.

ADVANCED CAPABILITIES

    Call, Create and Drop Stored Procedures

Note: this feature has been added recently, and not yet tested in real-world conditions.
fetch_storedproc()


  $sqldb->fetch_storedproc( $proc_name, @arguments ) : $rows



Not yet supported.

See Binding Cursors in DBD::Oracle for more information.

do_storedproc()


  $sqldb->do_storedproc( $proc_name, @arguments ) : $row_count



Calls do_sql with execute procedure, the procedure name, and the arguments using placeholders.

create_storedproc()


  $sqldb->create_storedproc( $proc_name, $definition )



Calls do_sql with create or replace procedure, the procedure name, and the definition.

drop_storedproc()


  $sqldb->drop_storedproc( $proc_name )



Calls do_sql with drop procedure and the procedure name.

INTERNAL CONNECTION METHODS (DBI DBH)

    Checking For Connection

sql_detect_any()


  $sqldb->sql_detect_any : %sql_select_clauses



Implemented using Oracle’s select 1 from dual.

    Statement Error Handling

recoverable_query_exceptions()


  $sqldb->recoverable_query_exceptions() : @common_error_messages



Provides a list of error messages which represent common communication failures or other incidental errors.

SEE ALSO

See DBIx::SQLEngine for the overall interface and developer documentation.

See DBIx::SQLEngine::Docs::ReadMe for general information about this distribution, including installation and license information.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 87: You forgot a ’=back’ before ’=head2’
Around line 93: =back without =over
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 SQLENGINE::DRIVER::ORACLE (3) 2004-11-06

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