Matthew Simon Cavalletto > DBIx-SQLEngine > DBIx::SQLEngine::Driver::Oracle

Download:
DBIx-SQLEngine-0.93.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Source  

NAME ^

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

SYNOPSIS ^

DBI Wrapper: Adds methods to a DBI database handle.

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

Portability Subclasses: 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.

syntax highlighting: