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.