Oracle DBMS_SQL Dynamic SQL

Search the Reference Library pages:

Oracle DBMS_SQL

Version 11.1

General

Note: DBMS_SQL is the traditional form of dynamic SQL in Oracle.

For most purposes native dynamic sql (NDS) will suffice but there are some things the DBMS_SQL package does that can not be done any other way. This page emphasizes those areas where there is no substitute.

Source

{ORACLE_HOME}/rdbms/admin/dbmssql.sql

First Available

7.3.4

Constants

Name	Data Type	Value
v6	INTEGER	0
native	INTEGER	1
v7	INTEGER	2

Defined Data Types

General Types
TYPE desc_rec IS RECORD (
col_type binary_integer := 0,
col_max_len binary_integer := 0,
col_name varchar2(32) := '',
col_name_len binary_integer := 0,
col_schema_name varchar2(32) := '',
col_schema_name_len binary_integer := 0,
col_precision binary_integer := 0,
col_scale binary_integer := 0,
col_charsetid binary_integer := 0,
col_charsetform binary_integer := 0,
col_null_ok boolean := TRUE);

TYPE desc_rec2 IS RECORD (
col_type binary_integer := 0,
col_max_len binary_integer := 0,
col_name varchar2(32767) := '',
col_name_len binary_integer := 0,
col_schema_name varchar2(32) := '',
col_schema_name_len binary_integer := 0,
col_precision binary_integer := 0,
col_scale binary_integer := 0,
col_charsetid binary_integer := 0,
col_charsetform binary_integer := 0,
col_null_ok boolean := TRUE);

TYPE desc_tab IS TABLE OF desc_rec
INDEX BY binary_integer;

TYPE desc_tab2 IS TABLE OF desc_rec2
INDEX BY binary_integer;

TYPE varchar2a IS TABLE OF VARCHAR2(32767)
INDEX BY binary_integer;

TYPE varchar2s IS TABLE OF VARCHAR2(256)
INDEX BY binary_integer;

Bulk SQL Types
TYPE bfile_table IS TABLE OF bfile
INDEX BY binary_integer;

TYPE binary_double_table IS TABLE OF binary_double
INDEX BY binary_integer;

TYPE binary_float_table IS TABLE OF binary_float
INDEX BY binary_integer;

TYPE blob_table IS TABLE OF blob
INDEX BY binary_integer;

TYPE clob_table IS TABLE OF clob
INDEX BY binary_integer;

TYPE date_table IS TABLE OF date
INDEX BY binary_integer;

TYPE interval_day_to_second_table IS TABLE OF
dsinterval_unconstrained INDEX BY binary_integer;

TYPE interval_year_to_MONTH_Table IS TABLE OF
yminterval_unconstrained
INDEX BY binary_integer;

TYPE number_table IS TABLE OF NUMBER
INDEX BY binary_integer;

TYPE time_table IS TABLE OF time_unconstrained
INDEX BY binary_integer;

TYPE time_with_time_zone_Table IS TABLE OF TIME_TZ_UNCONSTRAINED INDEX BY binary_integer;

TYPE timestamp_table IS TABLE OF timestamp_unconstrained
INDEX BY binary_integer;

TYPE timestamp_with_ltz_table IS TABLE OF
TIMESTAMP_LTZ_UNCONSTRAINED
INDEX BY binary_integer;

TYPE urowid_table IS TABLE OF urowid
INDEX BY binary_integer;

TYPE timestamp_with_time_zone_table IS TABLE OF
TIMESTAMP_TZ_UNCONSTRAINED
INDEX BY binary_integer;

TYPE varchar2_table IS TABLE OF VARCHAR2(2000)
INDEX BY binary_integer;

Dependencies

SELECT name
FROM dba_dependencies
WHERE referenced_name = 'DBMS_SQL'
UNION
SELECT referenced_name
FROM dba_dependencies
WHERE name = 'DBMS_SQL';

Exceptions

Error Code	Reason
ORA-06562	Inconsistent types: Raised by procedure "column_value" or "variable_value" if the type of out argument where to put the requested value is different from the type of the value

Flow

--
--                      -----------
--                    | open_cursor |
--                      -----------
--                           |
--                           |
--                           v
--                         -----
--          ------------>| parse |
--          |              -----
--          |                |
--          |                | ---------
--          |                v          |
--          |           -------------- |
--          |-------->| bind_variable | |
--          |     ^     -------------   |
--          |     |           |         |
--          |      -----------|         |
--          |                 |<--------
--          |                 v
--          |               query?---------- yes ---------
--          |                 |                           |
--          |                no                           |
--          |                 |                           |
--          |                 v                           v
--          |              -------                  -------------
--          |----------->| execute |            ->| define_column |
--          |              -------             |    -------------
--          |                 |------------    |          |
--          |                 |            |    ----------|
--          |                 v            |              v
--          |           --------------     |           -------
--          |       ->| variable_value |   | ------>| execute |
--          |      |    --------------     | |         -------
--          |      |          |            | |            |
--          |       ----------|            | |            |
--          |                 |            | |            v
--          |                 |            | |        ----------
--          |                 |<----------- |----->| fetch_rows |
--          |                 |              |        ----------
--          |                 |              |            |
--          |                 |              |            v
--          |                 |              | -----------------
--          |                 |              | | column_value    |
--          |                 |              | | variable_value |
--          |                 |              | -----------------
--          |                 |              |            |
--          |                 |<--------------------------
--          |                 |
--           -----------------|
--                            |
--                            v
--                       ------------
--                     | close_cursor |
--                       ------------
--

BIND_ARRAY

Binds a given value to a given collection

Overload 1

dbms_sql.BIND_ARRAY(
c IN INTEGER,
name IN VARCHAR2,
n_tab IN NUMBER_TABLE);

conn scott/tiger

DECLARE
stmt          VARCHAR2(200);
dept_no_array dbms_sql.number_table;
c             NUMBER;
dummy         NUMBER;
BEGIN
dept_no_array(1) := 10; dept_no_array(2) := 20;
dept_no_array(3) := 30; dept_no_array(4) := 40;
dept_no_array(5) := 30; dept_no_array(6) := 40;
stmt := 'delete from emp where deptno = :dept_array';
c := dbms_sql.open_cursor;
dbms_sql.parse(c, stmt, dbms_sql.NATIVE);
dbms_sql.bind_array(c, ':dept_array', dept_no_array, 1, 4);
dummy := dbms_sql.execute(c);
dbms_sql.close_cursor(c);

EXCEPTION
WHEN OTHERS THEN
    IF dbms_sql.is_open(c) THEN
      dbms_sql.close_cursor(c);
    END IF;
    RAISE;
END;
/

Overload 2

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
c_tab IN VARCHAR2_TABLE);

TBD

Overload 3

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
d_tab IN DATE_TABLE);

TBD

Overload 4

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bl_tab IN BLOB_TABLE);

TBD

Overload 5

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
cl_tab IN CLOB_TABLE);

TBD

Overload 6

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bf_tab IN BFILE_TABLE);

TBD

Overload 7

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
n_tab IN NUMBER_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 8

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
c_tab IN VARCHAR2_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 9

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
d_tab IN DATE_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 10

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bl_tab IN BLOB_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 11

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
cl_tab IN CLOB_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 12

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bf_tab IN BFILE_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 13

dbms_sql.bind_array(
c IN INTEGER,
name IN VARCHAR2,
ur_tab IN UROWID_TABLE);

TBD

Overload 14

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
ur_tab IN UROWID_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 15

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
tm_tab IN TIME_TABLE);

TBD

Overload 16

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
tm_tab IN TIME_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 17

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
tms_tab IN TIMESTAMP_TABLE);

TBD

Overload 18

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
tms_tab IN TIMESTAMP_TABLE
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 19

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
ttz_tab IN TIME_WITH_TIME_ZONE_TABLE);

TBD

Overload 20

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
ttz_tab IN TIME_WITH_TIME_ZONE_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 21

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
tstz_tab IN TIMESTAMP_WITH_TIME_ZONE_TABLE);

TBD

Overload 22

dbms_sql.bind_array (
c       IN INTEGER,
name      IN VARCHAR2,
tstz_tab IN TIMESTAMP_WITH_TIME_ZONE_TABLE,
index1   IN INTEGER,
index2   IN INTEGER);

TBD

Overload 23

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
tstz_tab IN TIMESTAMP_WITH_LTZ_TABLE);

TBD

Overload 24

dbms_sql.bind_array (
c       IN INTEGER,
name      IN VARCHAR2,
tstz_tab IN TIMESTAMP_WITH_LTZ_TABLE,
index1   IN INTEGER,
index2   IN INTEGER);

TBD

Overload 25

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
iym_tab IN INTERVAL_YEAR_TO_MONTH_TABLE);

TBD

Overload 26

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
iym_tab IN INTERVAL_YEAR_TO_MONTH_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 27

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
ids_tab IN INTERVAL_DAY_TO_SECOND_TABLE);

TBD

Overload 28

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
ids_tab IN INTERVAL_DAY_TO_SECOND_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 29

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bflt_tab IN BINARY_FLOAT_TABLE);

TBD

Overload 30

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bflt_tab IN BINARY_FLOAT_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

Overload 31

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bdbl_tab IN BINARY_DOUBLE_TABLE);

TBD

Overload 32

dbms_sql.bind_array (
c IN INTEGER,
name IN VARCHAR2,
bdbl_tab IN BINARY_DOUBLE_TABLE,
index1 IN INTEGER,
index2 IN INTEGER);

TBD

BIND_VARIABLE

Binds a given value to a given variable

Overload 1

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN NUMBER);

conn scott/tiger

SELECT COUNT(*) FROM emp;

CREATE OR REPLACE PROCEDURE demo(salary IN NUMBER) AS
cursor_name INTEGER;
rows_processed INTEGER;
BEGIN
cursor_name := dbms_sql.open_cursor;
dbms_sql.parse(cursor_name, 'DELETE FROM emp WHERE sal > :x',
dbms_sql.NATIVE);
dbms_sql.bind_variable(cursor_name, ':x', salary);
rows_processed := dbms_sql.execute(cursor_name);
dbms_sql.close_cursor(cursor_name);
EXCEPTION
WHEN OTHERS THEN
dbms_sql.close_cursor(cursor_name);
END demo;
/

exec demo(30001)

SELECT COUNT(*) FROM emp;

rollback;

Overload 2

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN VARCHAR2 CHARACTER SET ANY_CS);

TBD

Overload 3

dbms_sql.bind_variable(
c              IN INTEGER,
name           IN VARCHAR2,
value          IN VARCHAR2 CHARACTER SET ANY_CS,
out_value_size IN INTEGER);

TBD

Overload 4

dbms_sql.bind_variable (
c IN INTEGER,
name IN VARCHAR2,
value IN DATE);

TBD

Overload 5

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN BLOB);

TBD

Overload 6

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN CLOB CHARACTER SET ANY_CS);

TBD

Overload 7

dbms_sql.bind_variable (
c IN INTEGER,
name IN VARCHAR2,
value IN BFILE);

TBD

Overload 8

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN UROWID);

TBD

Overload 9

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN TIME_UNCONSTRAINED);

TBD

Overload 10

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN TIMESTAMP_UNCONSTRAINED);

TBD

Overload 11

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN TIME_TZ_UNCONSTRAINED);

TBD

Overload 12

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN TIMESTAMP_TZ_UNCONSTRAINED);

TBD

Overload 13

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN TIMESTAMP_LTZ_UNCONSTRAINED);

TBD

Overload 14

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN YMINTERVAL_UNCONSTRAINED);

TBD

Overload 15

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN DSINTERVAL_UNCONSTRAINED);

TBD

Overload 16

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN BINARY_FLOAT);

TBD

Overload 17

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN BINARY_DOUBLE);

TBD

Overload 18

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN <ADT_1>);

TBD

Overload 19

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN REF <ADT_1>);

TBD

Overload 20

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN <TABLE_1>);

TBD

Overload 21

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN <VARRAY_1>);

TBD

Overload 22

dbms_sql.bind_variable(
c IN INTEGER,
name IN VARCHAR2,
value IN <OPAQUE_1>);

TBD

BIND_VARIABLE_CHAR

Binds a given value to a given variable

Overload 1

dbms_sql.bind_variable_char(
c IN INTEGER,
name IN VARCHAR2,
value IN CHAR CHARACTER SET ANY_CS);

See bind_variable demo

Overload 2

dbms_sql.bind_variable_char(
c              IN INTEGER,
name           IN VARCHAR2,
value          IN CHAR CHARACTER SET ANY_CS,
out_value_size IN INTEGER);

TBD

BIND_VARIABLE_RAW

Binds a given value to a given variable

Overload 1

dbms_sql.bind_variable_raw(
c IN INTEGER,
name IN VARCHAR2,
value IN RAW);

See bind_variable demo

Overload 2

dbms_sql.bind_variable_raw(
c              IN INTEGER,
name           IN VARCHAR2,
value          IN RAW,
out_value_size IN INTEGER);

TBD

BIND_VARIABLE_ROWID

Binds a given value to a given variable

Overload 1

dbms_sql.bind_variable_rowid(
c IN INTEGER,
name IN VARCHAR2,
value IN ROWID);

See bind_variable demo

Overload 2

dbms_sql.bind_variable_rowid(
c              IN INTEGER,
name           IN VARCHAR2,
value          IN ROWID,
out_value_size IN INTEGER);

TBD

CLOSE_CURSOR

Closes cursor and free memory

dbms_sql.close_cursor(c IN OUT INTEGER);

See is_open demo

COLUMN_VALUE

Returns value of the cursor element for a given position in a cursor

Overload 1

dbms_sql.column_value
c IN INTEGER,
position IN INTEGER,
value OUT NUMBER);

See final demo

Overload 2

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT VARCHAR2 CHARACTER SET ANY_CS);

TBD

Overload 3

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT DATE);

TBD

Overload 4

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT BLOB);

TBD

Overload 5

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT CLOB CHARACTER SET ANY_CS);

TBD

Overload 6

dbms_sql.column_value (
c IN INTEGER,
position IN INTEGER,
value OUT BFILE);

TBD

Overload 7

dbms_sql.column_value(
c             IN INTEGER,
position      IN INTEGER,
value         OUT NUMBER,
column_error OUT NUMBER,
actual_length OUT INTEGER);

TBD

Overload 8

dbms_sql.column_value(
c             IN INTEGER,
position      IN INTEGER,
value         OUT VARCHAR2 CHARACTER SET ANY_CS,
column_error OUT NUMBER,
actual_length OUT INTEGER);

TBD

Overload 9

dbms_sql.column_value(
c             IN INTEGER,
position      IN INTEGER,
value         OUT DATE,
column_error OUT NUMBER,
actual_length OUT INTEGER);

TBD

Overload 10

dbms_sql.column_value(
c        IN     INTEGER,
position IN     INTEGER,
n_tab    IN OUT NOCOPY NUMBER_TABLE);

TBD

Overload 11

dbms_sql.column_value(
c        IN     INTEGER,
position IN     INTEGER,
c_tab    IN OUT NOCOPY VARCHAR2_TABLE);

TBD

Overload 12

dbms_sql.column_value(
c        IN     INTEGER,
position IN     INTEGER,
d_tab    IN OUT NOCOPY DATE_TABLE);

TBD

Overload 13

dbms_sql.column_value(
c        IN     INTEGER,
position IN     INTEGER,
bl_tab   IN OUT NOCOPY BLOB_TABLE);

TBD

Overload 14

dbms_sql.column_value(
c        IN     INTEGER,
position IN     INTEGER,
cl_tab   IN OUT NOCOPY CLOB_TABLE);

TBD

Overload 15

dbms_sql.column_value (
c        IN     INTEGER,
position IN     INTEGER,
bf_tab   IN OUT NOCOPY BFILE_TABLE);

TBD

Overload 16

dbms_sql.column_value (
c IN INTEGER,
position IN INTEGER,
value OUT UROWID);

TBD

Overload 17

dbms_sql.column_value (
c        IN     INTEGER,
position IN     INTEGER,
ur_tab   IN OUT NOCOPY UROWID_TABLE);

TBD

Overload 18

dbms_sql.column_value (
c IN INTEGER,
position IN INTEGER,
value OUT TIME_UNCONSTRAINED);

TBD

Overload 19

dbms_sql.column_value(
c        IN     INTEGER,
position IN    INTEGER,
tm_tab   IN OUT NOCOPY TIME_TABLE);

TBD

Overload 20

dbms_sql.column_value (
c IN INTEGER,
position IN INTEGER,
value OUT TIMESTAMP_UNCONSTRAINED);

TBD

Overload 21

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
tms_tab IN OUT NOCOPY TIMESTAMP_TABLE);

TBD

Overload 22

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT TIME_TZ_UNCONSTRAINED);

TBD

Overload 23

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
ttz_tab IN OUT NOCOPY TIME_WITH_TIME_ZONE_TABLE);

TBD

Overload 24

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT TIMESTAMP_TZ_UNCONSTRAINED);

TBD

Overload 25

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
tstz_tab IN OUT NOCOPY TIMESTAMP_WITH_TIME_ZONE_TABLE);

TBD

Overload 26

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT TIMESTAMP_LTZ_UNCONSTRAINED);

TBD

Overload 27

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
tstz_tab IN OUT NOCOPY TIMESTAMP_WITH_LTZ_TABLE);

TBD

Overload 28

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT YMINTERVAL_UNCONSTRAINED);

TBD

Overload 29

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
iym_tab IN OUT NOCOPY INTERVAL_YEAR_TO_MONTH_TABLE);

TBD

Overload 30

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT DSINTERVAL_UNCONSTRAINED);

TBD

Overload 31

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
ids_tab IN OUT NOCOPY INTERVAL_DAY_TO_SECOND_TABLE);

TBD

Overload 32

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT BINARY_FLOAT);

TBD

Overload 33

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
bflt_tab IN OUT NOCOPY BINARY_FLOAT_TABLE);

TBD

Overload 34

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
value OUT BINARY_DOUBLE);

TBD

Overload 35

dbms_sql.column_value(
c IN INTEGER,
position IN INTEGER,
bdbl_tab IN OUT NOCOPY BINARY_DOUBLE_TABLE);

TBD

Overload 36

dbms_sql.column_value(
c IN INTEGER,
position IN BINARY_INTEGER,
value OUT "<ADT_1>");

TBD

Overload 37

dbms_sql.column_value(
c IN INTEGER,
position IN BINARY_INTEGER,
value OUT REF "<ADT_1>");

TBD

Overload 38

dbms_sql.column_value(
c IN INTEGER,
position IN BINARY_INTEGER,
value OUT "<TABLE_1>");

TBD

Overload 39

dbms_sql.column_value(
c IN INTEGER,
position IN BINARY_INTEGER,
value OUT "<VARRAY_1>");

TBD

Overload 40

dbms_sql.column_value(
c IN INTEGER,
position IN BINARY_INTEGER,
value OUT "<OPAQUE_1>");

TBD

COLUMN_VALUE_CHAR

Returns value of the cursor element for a given position in a cursor

Overload 1

dbms_sql.column_value_char(
c IN INTEGER,
position IN INTEGER,
value OUT CHAR CHARACTER SET ANY_CS);

See column_value in final demo

Overload 2

dbms_sql.column_value_char(
c             IN INTEGER,
position      IN INTEGER,
value         OUT CHAR CHARACTER SET ANY_CS,
column_error OUT NUMBER,
actual_length OUT INTEGER);

TBD

COLUMN_VALUE_LONG

Returns a selected part of a LONG column, that has been defined using DEFINE_COLUMN_LONG

dbms_sql.column_value_long(
c            IN INTEGER,
position     IN INTEGER,
length       IN INTEGER,
offset       IN INTEGER,
value        OUT VARCHAR2,
value_length OUT INTEGER);

See column_value in final demo

COLUMN_VALUE_RAW

Returns value of the cursor element for a given position in a cursor

Overload 1

dbms_sql.column_value_raw(
c IN INTEGER,
position IN INTEGER,
value OUT RAW);

See column_value in final demo

Overload 2

dbms_sql.column_value_raw(
c             IN INTEGER,
position      IN INTEGER,
value         OUT RAW,
column_error OUT NUMBER,
actual_length OUT INTEGER);

TBD

COLUMN_VALUE_ROWID

Undocumented

Overload 1

dbms_sql.column_value_rowid(
c               IN INTEGER,
position        IN INTEGER,
value           OUT ROWID);

See column_value in final demo

Overload 2

dbms_sql.column_value_rowid(
c             IN INTEGER,
position      IN INTEGER,
value         OUT ROWID,
column_error OUT NUMBER,
actual_length OUT INTEGER);

TBD

DEFINE_ARRAY

Defines a collection to be selected from the given cursor, used only with SELECT statements

Overload 1

dbms_sql.define_array(
c         IN INTEGER,
position  IN INTEGER,
n_tab     IN NUMBER_TABLE,
cnt       IN INTEGER,
lower_bnd IN INTEGER);

DECLARE
c     NUMBER;
d     NUMBER;
n_tab dbms_sql.number_table;
indx NUMBER := -10;
BEGIN
c := dbms_sql.open_cursor;
dbms_sql.parse(c,'select n from t order by 1',dbms_sql.NATIVE);

dbms_sql.define_array(c, 1, n_tab, 10, indx);

d := dbms_sql.execute(c);

LOOP
    d := dbms_sql.fetch_rows(c);
    dbms_sql.column_value(c, 1, n_tab);
    exit when d != 10;
END LOOP;

dbms_sql.close_cursor(c);
EXCEPTIONS
WHEN OTHERS THEN
    IF dbms_sql.is_open(c) THEN
      dbms_sql.close_cursor(c);
    END IF;
    RAISE;
END;
/

Overload 2

dbms_sql.define_array (
c           IN INTEGER,
position    IN INTEGER,
c_tab       IN VARCHAR2_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 3

dbms_sql.define_array (
c           IN INTEGER,
position    IN INTEGER,
d_tab       IN DATE_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 4

dbms_sql.define_array (
c           IN INTEGER,
position    IN INTEGER,
bl_tab      IN BLOB_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 5

dbms_sql.define_array (
c           IN INTEGER,
position    IN INTEGER,
cl_tab      IN CLOB_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 6

dbms_sql.define_array (
c           IN INTEGER,
position    IN INTEGER,
bf_tab      IN BFILE_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 7

dbms_sql.define_array (
c           IN INTEGER,
position    IN INTEGER,
ur_tab      IN UROWID_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 8

dbms_sql.define_array(
c           IN INTEGER,
position    IN INTEGER,
tm_tab      IN TIME_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 9

dbms_sql.define_array(
c           IN INTEGER,
position    IN INTEGER,
tms_tab     IN TIMESTAMP_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 10

dbms_sql.define_array(
c           IN INTEGER,
position    IN INTEGER,
ttz_tab     IN TIME_WITH_TIME_ZONE_TABLE,
cnt         IN INTEGER,
lower_bound IN INTEGER);

TBD

Overload 11

dbms_sql.define_array(

TBD

Overload 12

dbms_sql.define_array(

TBD

Overload 13

dbms_sql.define_array(

TBD

Overload 14

dbms_sql.define_array(

TBD

Overload 15

dbms_sql.define_array(

TBD

Overload 16

dbms_sql.define_array(

TBD

DEFINE_COLUMN

Defines a column to be selected from the given cursor, used only with SELECT statements

Overload 1

dbms_sql.define_column (
c IN INTEGER,
position IN INTEGER,
column IN NUMBER)

See final demo

Overload 2

dbms_sql.define_column (
c           IN INTEGER,
position    IN INTEGER,
column      IN VARCHAR2 CHARACTER SET ANY_CS,
column_size IN INTEGER);

TBD

Overload 3

dbms_sql.define_column (
c           IN INTEGER,
position    IN INTEGER,
column      IN DATE);

TBD

Overload 4

dbms_sql.define_column (
c           IN INTEGER,
position    IN INTEGER,
column      IN BLOB);

TBD

Overload 5

dbms_sql.define_column (
c           IN INTEGER,
position    IN INTEGER,
column      IN CLOB);

TBD

Overload 6

dbms_sql.define_column (
c           IN INTEGER,
position    IN INTEGER,
column      IN BFILE);

TBD

Overload 7

dbms_sql.define_column (
c           IN INTEGER,
position    IN INTEGER,
column      IN UROWID);

TBD

Overload 8

dbms_sql.define_column(
c           IN INTEGER,
position    IN INTEGER,
column      IN TIME_UNCONSTRAINED);

TBD

Overload 9

dbms_sql.define_column(
c           IN INTEGER,
position    IN INTEGER,
column      IN TIMESTAMP_UNCONSTRAINED);

TBD

Overload 10

dbms_sql.define_column(
c IN INTEGER,
position IN INTEGER,
column IN TIME_TZ_UNCONSTRAINED);

TBD

Overload 11

dbms_sql.define_column(

TBD

Overload 12

dbms_sql.define_column(

TBD

Overload 13

dbms_sql.define_column(

TBD

Overload 14

dbms_sql.define_column(

TBD

Overload 15

dbms_sql.define_column(

TBD

Overload 16

dbms_sql.define_column(

TBD

Overload 17

dbms_sql.define_column(

TBD

Overload 18

dbms_sql.define_column(

TBD

Overload 19

dbms_sql.define_column(

TBD

Overload 20

dbms_sql.define_column(

TBD

Overload 21

dbms_sql.define_column(

TBD

DEFINE_COLUMN_CHAR

Undocumented

dbms_sql.define_column_char(
c           IN INTEGER,
position    IN INTEGER,
column      IN CHAR CHARACTER SET ANY_CS,
column_size IN INTEGER);

See define_column in final demo

DEFINE_COLUMN_LONG

Defines a LONG column to be selected from the given cursor, used only with SELECT statements

dbms_sql.define_column_long(c IN INTEGER, position IN INTEGER);

See define_column in final demo

DEFINE_COLUMN_RAW

Undocumented

dbms_sql.define_column_raw(
c           IN INTEGER,
position    IN INTEGER,
column      IN RAW,
column_size IN INTEGER);

See define_column in final demo

DEFINE_COLUMN_ROWID

Undocumented

dbms_sql.define_column_rowid(
c IN INTEGER,
position IN INTEGER,
column IN ROWID);

See define_column in final demo

DESCRIBE_COLUMNS

Describes the columns for a cursor opened and parsed through DBMS_SQL

dbms_sql.describe_columns(
c IN INTEGER,
col_cnt OUT INTEGER,
desc_t OUT DESC_TAB);

DECLARE
c       NUMBER;
d       NUMBER;
col_cnt PLS_INTEGER;
f       BOOLEAN;
rec_tab dbms_sql.desc_tab;
col_num NUMBER;

PROCEDURE print_rec(rec in dbms_sql.desc_rec) IS
BEGIN
dbms_output.new_line;
dbms_output.put_line('col_type = ' || rec.col_type);
dbms_output.put_line('col_maxlen = ' || rec.col_max_len);
dbms_output.put_line('col_name = ' || rec.col_name);
dbms_output.put_line('col_name_len = ' || rec.col_name_len);
dbms_output.put_line('col_schema_name= ' || rec.col_schema_name);
dbms_output.put_line('col_schema_name_len= ' || rec.col_schema_name_len);
dbms_output.put_line('col_precision = ' || rec.col_precision);
dbms_output.put_line('col_scale = ' || rec.col_scale);
dbms_output.put('col_null_ok = ');

IF (rec.col_null_ok) THEN
    dbms_output.put_line('True');
ELSE
    dbms_output.put_line('False');
END IF;
END;

BEGIN
c := dbms_sql.open_cursor;
dbms_sql.parse(c,'select * from scott.bonus',dbms_sql.NATIVE);
d := dbms_sql.execute(c);
dbms_sql.describe_columns(c, col_cnt, rec_tab);

/*
Following loop could simply be for j in 1..col_cnt loop.
Here we are simply illustrating some of the PL/SQL table features.
*/
col_num := rec_tab.first;

IF (col_num IS NOT NULL) THEN
    LOOP
      print_rec(rec_tab(col_num));
      col_num := rec_tab.next(col_num);
    EXIT WHEN (col_num is null);
    END LOOP;
END IF;

dbms_sql.close_cursor(c);
END;
/

DESCRIBE_COLUMNS2

Describes the specified column, an alternative method fixing a bug

dbms_sql.describe_columns2(
c IN INTEGER,
col_cnt OUT INTEGER,
desc_tab2 OUT DESC_TAB2);

TBD

DESCRIBE_COLUMNS3 (new 11g)

Describes the specified column, an alternative method

dbms_sql.describe_columns2(
c IN INTEGER,
col_cnt OUT INTEGER,
desc_t OUT DESC_TAB3);

TBD

EXECUTE

Execute dynamic SQL cursor

dbms_sql.execute(c IN INTEGER) RETURN INTEGER;

DECLARE
sqlstr VARCHAR2(50);
tCursor PLS_INTEGER;
RetVal NUMBER;
BEGIN
sqlstr := 'DROP SYNONYM my_synonym';
tCursor := dbms_sql.open_cursor;
dbms_sql.parse(tCursor, sqlstr, dbms_sql.NATIVE);
RetVal := dbms_sql.execute(tCursor);
dbms_sql.close_cursor(tCursor);
END;
/

EXECUTE_AND_FETCH

Executes a given cursor and fetch rows

dbms_sql.execute_and_fetch(
c IN INTEGER,
exact IN BOOLEAN DEFAULT FALSE)
RETURN INTEGER;

Combine demo w/ last_row_count and last_row_id demos

FETCH_ROWS

Fetches a row from a given cursor

dbms_sql.fetch_rows(c IN INTEGER) RETURN INTEGER;

See final demo

IS_OPEN

Determine whether a cursor is open

dbms_sql.is_open(c IN INTEGER) RETURN BOOLEAN;

set serveroutput on

DECLARE
tCursor PLS_INTEGER;
BEGIN
tCursor := dbms_sql.open_cursor;

IF dbms_sql.is_open(tCursor) THEN
    dbms_output.put_line('1-OPEN');
ELSE
    dbms_output.put_line('1-CLOSED');
END IF;

dbms_sql.close_cursor(tCursor);

IF dbms_sql.is_open(tCursor) THEN
    dbms_output.put_line('2-OPEN');
ELSE
    dbms_output.put_line('2-CLOSED');
END IF;
END;
/

LAST_ERROR_POSITION

Returns byte offset in the SQL statement text where the error occurred

dbms_sql.last_error_position RETURN INTEGER;

TBD

LAST_ROW_COUNT

Returns cumulative count of the number of rows fetched

dbms_sql.last_row_count RETURN INTEGER;

TBD

LAST_ROW_ID

Returns ROWID of last row processed

dbms_sql.last_row_id RETURN ROWID;

TBD

LAST_SQL_FUNCTION_CODE

Returns SQL function code for statement

dbms_sql.last_sql_function_code RETURN INTEGER;

TBD

OPEN_CURSOR

Open dynamic SQL cursor and return cursor ID number of new cursor

Overload 1

dbms_sql.open_cursor RETURN INTEGER;

See is_open demo

Overload 2

dbms_sql.open_cursor ??? HELP

TBD

PARSE

Parse statement

Overload 1

dbms_sql.parse(
c IN INTEGER,
statement IN VARCHAR2,
language_flag IN INTEGER);

CREATE SYNONYM test_syn FOR dual;

SELECT *
FROM test_syn;

SELECT synonym_name
FROM user_synonyms;

DECLARE
sqlstr VARCHAR2(50);
tCursor PLS_INTEGER;
BEGIN
sqlstr := 'DROP SYNONYM test_syn';
tCursor := dbms_sql.open_cursor;
dbms_sql.parse(tCursor, sqlstr, dbms_sql.NATIVE);
dbms_sql.close_cursor(tCursor);
END;
/

SELECT synonym_name
FROM user_synonyms;

-- with returning clause

CREATE OR REPLACE PROCEDURE single_row_insert(c1 NUMBER, c2 NUMBER, r OUT NUMBER) IS
c NUMBER;
n NUMBER;
BEGIN
c := dbms_sql.open_cursor;

dbms_sql.parse(c, 'INSERT INTO tab VALUES (:bnd1, :bnd2) ' ||
'returning c1*c2 into :bnd3', 2);

dbms_sql.bind_variable(c, 'bnd1', c1);
dbms_sql.bind_variable(c, 'bnd2', c2);
dbms_sql.bind_variable(c, 'bnd3', r);

n := dbms_sql.execute(c);

dbms_sql.variable_value(c, 'bnd3', r); -- get value of outbind
dbms_sql.close_cursor(c);
END single_row_insert;
/

Overload 2

dbms_sql.parse(
c             IN INTEGER,
statement     IN VARCHAR2A,
lb            IN INTEGER,
ub            IN INTEGER,
lfflg         IN BOOLEAN,
language_flag IN INTEGER);

TBD

Overload 3

dbms_sql.parse(
c             IN INTEGER,
statement     IN VARCHAR2S,
lb            IN INTEGER,
ub            IN INTEGER,
lfflg         IN BOOLEAN,
language_flag IN INTEGER);

TBD

Overload 4

dbms_sql.parse(

TBD

Overload 5

dbms_sql.parse(

TBD

Overload 6

dbms_sql.parse(

TBD

Overload 7

dbms_sql.parse(

TBD

Overload 8

dbms_sql.parse(

TBD

Overload 9

dbms_sql.parse(

TBD

Overload 10

dbms_sql.parse(

TBD

Overload 11

dbms_sql.parse(

TBD

Overload 12

dbms_sql.parse(

TBD

TO_CURSOR_NUMBER

Takes a REF CURSOR generated by TO_REFCURSOR and returns its handle.

dbms_sql.rc in out sys_refcursor) RETURN INTEGER;

TBD

TO_REFCURSOR

Takes a DBMS_SQL OPENed, PARSEd, and EXECUTEd cursor
and transforms/migrates it into a PL/SQL manageable REF CURSOR.

dbms_sql.cursor_number IN OUT INTEGER) RETURN SYS_REFCURSOR;

TBD

VARIABLE_VALUE

Returns value of named variable for given cursor

Overload 1

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT NUMBER);

TBD

Overload 2

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT VARCHAR2 CHARACTER SET ANY_CS);

TBD

Overload 3

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT DATE);

TBD

Overload 4

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT BLOB);

TBD

Overload 5

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT CLOB CHARACTER SET ANY_CS);

TBD

Overload 6

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT BFILE);

TBD

Overload 7

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value IN NUMBER_TABLE);

TBD

Overload 8

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value IN VARCHAR2_TABLE);

TBD

Overload 9

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value IN DATE_TABLE);

TBD

Overload 10

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value IN BLOB_TABLE);

TBD

Overload 11

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value IN CLOB_TABLE);

TBD

Overload 12

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value IN BFILE_TABLE);

TBD

Overload 13

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT UROWID);

TBD

Overload 14

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT NOCOPY UROWID_TABLE);

TBD

Overload 15

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT TIME_UNCONSTRAINED);

TBD

Overload 16

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT NOCOPY TIME_TABLE);

TBD

Overload 17

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT TIMESTAMP_TABLE);

TBD

Overload 18

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT NOCOPY TIMESTAMP_TABLE);

TBD

Overload 19

dbms_sql.variable_value(
c IN INTEGER,
name IN VARCHAR2,
value OUT TIME_TZ_UNCONSTRAINED);

TBD

Overload 20

dbms_sql.variable_value(

TBD

Overload 21

dbms_sql.variable_value(

TBD

Overload 22

dbms_sql.variable_value(

TBD

Overload 23

dbms_sql.variable_value(

TBD

Overload 24

dbms_sql.variable_value(

TBD

Overload 25

dbms_sql.variable_value(

TBD

Overload 26

dbms_sql.variable_value(

TBD

Overload 27

dbms_sql.variable_value(

TBD

Overload 28

dbms_sql.variable_value(

TBD

Overload 29

dbms_sql.variable_value(

TBD

Overload 30

dbms_sql.variable_value(

TBD

Overload 31

dbms_sql.variable_value(

TBD

Overload 32

dbms_sql.variable_value(

TBD

Overload 33

dbms_sql.variable_value(

TBD

Overload 34

dbms_sql.variable_value(

TBD

Overload 35

dbms_sql.variable_value(

TBD

Overload 36

dbms_sql.variable_value(

TBD

Overload 37

dbms_sql.variable_value(

TBD

VARIABLE_VALUE_CHAR

Undocumented

dbms_sql.variable_value_char(
c IN INTEGER,
name IN VARCHAR2,
value OUT CHAR CHARACTER SET ANY_CS);

TBD

VARIABLE_VALUE_RAW

Undocumented

dbms_sql.variable_value_raw(
c IN INTEGER,
name IN VARCHAR2,
value OUT RAW);

TBD

VARIABLE_VALUE_ROWID

Undocumented

dbms_sql.variable_value_rowid(
c IN INTEGER,
name IN VARCHAR2,
value OUT ROWID);

TBD

Demos

Drop Synonym Demo

SELECT synonym_name
FROM user_synonyms;

CREATE SYNONYM d FOR dept;
CREATE SYNONYM e FOR emp;

SELECT synonym_name
FROM user_synonyms;

DECLARE
CURSOR syn_cur IS
SELECT synonym_name
FROM user_synonyms;

RetVal NUMBER;
sqlstr VARCHAR2(200);
tCursor PLS_INTEGER;
BEGIN
FOR syn_rec IN syn_cur
LOOP
    sqlstr := 'DROP SYNONYM ' || syn_rec.synonym_name;
    tCursor := dbms_sql.open_cursor;
    dbms_sql.parse(tCursor, sqlstr, dbms_sql.NATIVE);
    RetVal := dbms_sql.execute(tCursor);
    dbms_sql.close_cursor(tCursor);
END LOOP;
END dropsyn;
/

SELECT synonym_name
FROM user_synonyms;

Executing CLOBS Demo Tables

CREATE TABLE workstations (
srvr_id     NUMBER(10),
ws_id       NUMBER(10),
location_id NUMBER(10),
cust_id     VARCHAR2(15),
status      VARCHAR2(1),
latitude    FLOAT(20),
longitude   FLOAT(20),
netaddress VARCHAR2(15));

CREATE TABLE test (test VARCHAR2(50));

Demonstration dynamic SQL

CREATE OR REPLACE PROCEDURE execute_plsql_block(plsql_code_block CLOB) IS

ds_cur    PLS_INTEGER := dbms_sql.open_cursor;
sql_table dbms_sql.VARCHAR2S;

c_buf_len CONSTANT BINARY_INTEGER := 256;
v_accum   INTEGER := 0;
v_beg     INTEGER := 1;
v_end     INTEGER := 256;
v_loblen PLS_INTEGER;
v_RetVal PLS_INTEGER;

---------------------------
-- local function to the execute_plsql_block procedure
FUNCTION next_row(
clob_in IN CLOB,
len_in IN INTEGER,
off_in IN INTEGER) RETURN VARCHAR2 IS
BEGIN
RETURN DBMS_LOB.SUBSTR(clob_in, len_in, off_in);
END next_row;
---------------------------

BEGIN
v_loblen := DBMS_LOB.GETLENGTH(plsql_code_block);
INSERT INTO test
(test)
VALUES
('Demo block is ' || TO_CHAR(v_loblen) || ' bytes in length');
COMMIT;

LOOP
    -- Set the length to the remaining size
    -- if there are < c_buf_len characters remaining.
    IF v_accum + c_buf_len > v_loblen THEN
      v_end := v_loblen - v_accum;
    END IF;

    sql_table(NVL(sql_table.LAST, 0) + 1) :=
    next_row(plsql_code_block, v_end, v_beg);

    v_beg := v_beg + c_BUF_LEN;
    v_accum := v_accum + v_end;

    IF v_accum >= v_loblen THEN
      EXIT;
    END IF;
END LOOP;

  -- Parse the pl/sql and execute it
   dbms_sql.parse(ds_cur, sql_table, sql_table.FIRST, sql_table.LAST,
FALSE, dbms_sql.NATIVE);

  v_RetVal := dbms_sql.execute(ds_cur);

   dbms_sql.close_cursor(ds_cur);
END execute_plsql_block;
/

Executing CLOBS Demo Data

SQL> commit;

SQL> ed

-- delete "commit" and paste in colored section

DECLARE
clob_in CLOB;
BEGIN
clob_in := CAST( 'BEGIN
INSERT INTO WORKSTATIONS VALUES (1,1,20075,'''',''Y'',32.97948,-117.2569,'''');
INSERT INTO WORKSTATIONS VALUES (1,10,20077,'''',''N'',32.97125,-117.2675,'''');
INSERT INTO WORKSTATIONS VALUES (1,11,20078,'''',''N'',33.03865,-96.83579,'''');
INSERT INTO WORKSTATIONS VALUES (1,12,20079,'''',''Y'',32.97413,-117.2694,''10.128.48.121'');
INSERT INTO WORKSTATIONS VALUES (1,2,20081,'''',''N'',32.97948,-117.2569,'''');
INSERT INTO WORKSTATIONS VALUES (1,3,20082,'''',''Y'',32.97948,-117.2569,''10.128.0.1'');
INSERT INTO WORKSTATIONS VALUES (1,4,20083,''15689'',''N'',32.98195,-117.2636,'''');
INSERT INTO WORKSTATIONS VALUES (1,5,20085,'''',''Y'',32.98195,-117.2636,''10.128.16.105'');
INSERT INTO WORKSTATIONS VALUES (1,6,20086,'''',''N'',32.97096,-117.2689,'''');
INSERT INTO WORKSTATIONS VALUES (1,7,20077,'''',''Y'',32.97125,-117.2675,''10.128.48.105'');
INSERT INTO WORKSTATIONS VALUES (1,8,20090,'''',''N'',32.97124,-117.2676,'''');
INSERT INTO WORKSTATIONS VALUES (1,9,20092,'''',''N'',32.97023,-117.2688,'''');
INSERT INTO WORKSTATIONS VALUES (10,1,20094,'''',''Y'',61.2224,-149.8047,''10.128.112.1'');
INSERT INTO WORKSTATIONS VALUES (10,2,20095,'''',''N'',61.2224,-149.8047,'''');
INSERT INTO WORKSTATIONS VALUES (10,3,20096,'''',''Y'',61.2224,-149.8047,''10.128.112.113'');
INSERT INTO WORKSTATIONS VALUES (10,4,13545,'''',''Y'',61.14104,-149.9519,''10.128.112.121'');
INSERT INTO WORKSTATIONS VALUES (10,5,20104,'''',''N'',61.2224,-149.8047,'''');
INSERT INTO WORKSTATIONS VALUES (10,6,20106,'''',''Y'',61.21685,-149.8002,''10.128.80.113'');
INSERT INTO WORKSTATIONS VALUES (11,1,20110,'''',''N'',61.137,-149.9395,'''');
INSERT INTO WORKSTATIONS VALUES (11,10,20113,'''',''N'',61.14104,-149.9519,'''');
INSERT INTO WORKSTATIONS VALUES (11,11,20116,'''',''N'',61.14104,-149.9519,'''');
INSERT INTO WORKSTATIONS VALUES (11,12,20117,'''',''Y'',61.137,-149.9395,''10.128.32.193'');
INSERT INTO WORKSTATIONS VALUES (11,13,20118,'''',''Y'',61.137,-149.9395,''10.128.16.129'');
INSERT INTO WORKSTATIONS VALUES (11,14,20119,'''',''Y'',61.137,-149.9395,'''');
INSERT INTO WORKSTATIONS VALUES (11,15,20121,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,16,20122,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,17,13545,'''',''Y'',61.14104,-149.9519,'''');
INSERT INTO WORKSTATIONS VALUES (11,18,19922,'''',''Y'',61.13549,-149.959,''10.128.48.153'');
INSERT INTO WORKSTATIONS VALUES (11,19,19923,'''',''N'',61.13422,-149.962,'''');
INSERT INTO WORKSTATIONS VALUES (11,2,19924,'''',''N'',61.137,-149.9395,'''');
INSERT INTO WORKSTATIONS VALUES (11,20,19925,'''',''N'',61.146,-149.9799,'''');
INSERT INTO WORKSTATIONS VALUES (11,21,19926,'''',''N'',61.146,-149.9799,'''');
INSERT INTO WORKSTATIONS VALUES (11,22,19927,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,23,19928,'''',''N'',61.14104,-149.9519,'''');
INSERT INTO WORKSTATIONS VALUES (11,24,19930,'''',''N'',61.13422,-149.962,'''');
INSERT INTO WORKSTATIONS VALUES (11,25,19931,'''',''N'',61.13678,-149.9644,'''');
INSERT INTO WORKSTATIONS VALUES (11,26,20033,'''',''N'',61.14477,-149.9586,'''');
INSERT INTO WORKSTATIONS VALUES (11,27,20034,'''',''N'',61.13466,-149.975,'''');
INSERT INTO WORKSTATIONS VALUES (11,28,20035,'''',''N'',61.14142,-149.9668,'''');
INSERT INTO WORKSTATIONS VALUES (11,29,20036,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,3,20037,'''',''Y'',61.137,-149.9395,''10.128.16.105'');
INSERT INTO WORKSTATIONS VALUES (11,30,20038,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,31,20039,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,32,20040,'''',''N'',61.13695,-149.9396,'''');
INSERT INTO WORKSTATIONS VALUES (11,33,20042,'''',''N'',61.12887,-149.9578,'''');
INSERT INTO WORKSTATIONS VALUES (11,4,20043,'''',''N'',61.137,-149.9395,'''');
INSERT INTO WORKSTATIONS VALUES (11,5,20044,'''',''Y'',61.137,-149.9395,''10.128.32.129'');
INSERT INTO WORKSTATIONS VALUES (11,6,20045,'''',''N'',61.137,-149.9395,'''');
INSERT INTO WORKSTATIONS VALUES (11,7,20046,'''',''N'',61.137,-149.9395,'''');
INSERT INTO WORKSTATIONS VALUES (11,8,20047,'''',''N'',61.137,-149.9395,'''');
--====
INSERT INTO WORKSTATIONS VALUES (11,9,20048,'''',''Y'',61.137,-149.9395,''10.128.32.169'');
INSERT INTO WORKSTATIONS VALUES (12,1,20051,''15706'',''Y'',32.75604,-117.1201,'''');
INSERT INTO WORKSTATIONS VALUES (12,10,20053,'''',''N'',32.75689,-117.12,'''');
INSERT INTO WORKSTATIONS VALUES (12,100,20054,'''',''N'',32.7596,-117.124,'''');
INSERT INTO WORKSTATIONS VALUES (12,101,20056,'''',''N'',32.75689,-117.129,'''');
INSERT INTO WORKSTATIONS VALUES (12,102,20057,'''',''Y'',32.75677,-117.1241,''10.129.112.25'');
INSERT INTO WORKSTATIONS VALUES (12,103,20058,'''',''Y'',32.75662,-117.124,''10.129.112.33'');
INSERT INTO WORKSTATIONS VALUES (12,104,20060,'''',''N'',32.7571,-117.1242,'''');
INSERT INTO WORKSTATIONS VALUES (12,105,20061,'''',''N'',32.75316,-117.1253,'''');
INSERT INTO WORKSTATIONS VALUES (12,106,20063,'''',''N'',32.76154,-117.1251,'''');
--====
COMMIT;
END;' AS CLOB);

execute_plsql_block(clob_in);

END;
/

set linesize 121

SELECT * FROM workstations;

Final Demo

CREATE TABLE one (
id    NUMBER(5),
name VARCHAR2(30),
dob   DATE);

CREATE TABLE two (
id    NUMBER(5),
name VARCHAR2(30),
dob   DATE);

INSERT INTO one
(id, name, dob)
VALUES
(100, 'Dan Morgan', SYSDATE+10);

INSERT INTO one
(id, name, dob)
VALUES
(200, 'Joze Senegacnik', SYSDATE-10);
COMMIT;

CREATE OR REPLACE PROCEDURE copy_proc(src_tab VARCHAR2,
dest_tab VARCHAR2) IS

col1     NUMBER(5);
col2     VARCHAR2(30);
col3    DATE;
src_cur INTEGER;
dest_cur INTEGER;
ignore   INTEGER;

BEGIN
-- open cursor on source table
src_cur := dbms_sql.open_cursor;

-- parse the SELECT statement
dbms_sql.parse(src_cur, 'SELECT id, name, dob FROM ' || src_tab,
dbms_sql.NATIVE);

-- define the column type
dbms_sql.define_column(src_cur, 1, col1);
dbms_sql.define_column(src_cur, 2, col2, 30);
dbms_sql.define_column(src_cur, 3, col3);

ignore := dbms_sql.execute(src_cur);

-- open cursor on destination table
dest_cur := dbms_sql.open_cursor;

-- parse the INSERT statement
dbms_sql.parse(dest_cur, 'INSERT INTO ' || dest_tab || ' VALUES
(:n_bind, :c_bind, :d_bind)', dbms_sql.NATIVE);

LOOP
      -- Fetch a row from the source table
    IF dbms_sql.fetch_rows(src_cur) > 0 THEN
      -- get column values of the row
        dbms_sql.column_value(src_cur, 1, col1);
      dbms_sql.column_value(src_cur, 2, col2);
        dbms_sql.column_value(src_cur, 3, col3);

        -- bind in the values to be inserted
        dbms_sql.bind_variable(dest_cur, ':n_bind', col1);
      dbms_sql.bind_variable(dest_cur, ':c_bind', col2);
        dbms_sql.bind_variable(dest_cur, ':d_bind', col3);
      ignore := dbms_sql.execute(dest_cur);
    ELSE
        -- No more rows to copy
        EXIT;
    END IF;
    END LOOP;

-- Commit and close all cursors
COMMIT;
dbms_sql.close_cursor(src_cur);
dbms_sql.close_cursor(dest_cur);
EXCEPTION
WHEN OTHERS THEN
    IF dbms_sql.is_open(src_cur) THEN
      dbms_sql.close_cursor(src_cur);
END IF;
    IF dbms_sql.is_open(dest_cur) THEN
      dbms_sql.close_cursor(dest_cur);
END IF;
    RAISE;
END copy_proc;
/

exec copy_proc('ONE', 'TWO');

SELECT * FROM one;
SELECT * FROM two;

Bulk Insert Demo

CREATE TABLE obj (
objno   INTEGER,
objname VARCHAR2(30));

CREATE OR REPLACE FUNCTION objname(rnum INTEGER) RETURN VARCHAR2 IS
retval VARCHAR2(30);
BEGIN
SELECT object_name
INTO retval
FROM (
    SELECT rownum X, object_name
    FROM all_objects
    WHERE rownum < 11)
WHERE x = rnum+1;
RETURN retval;
END objname;
/

DECLARE
sqlstr        VARCHAR2(200);
objno_array   dbms_sql.number_table;
objname_array dbms_sql.varchar2_table;
handle        NUMBER;
dummy         NUMBER;
BEGIN
FOR i IN 0..9
LOOP
    objno_array(i) := 1000 + i;
    objname_array(i) := objname(i);
END LOOP;

sqlstr := 'INSERT INTO obj VALUES (:num_array, :name_array)';
handle := dbms_sql.open_cursor;
dbms_sql.parse(handle, sqlstr, dbms_sql.NATIVE);
dbms_sql.bind_array(handle, ':num_array', objno_array);
dbms_sql.bind_array(handle, ':name_array', objname_array);
dummy := dbms_sql.execute(handle);
dbms_sql.close_cursor(handle);

EXCEPTION
WHEN OTHERS THEN
    IF dbms_sql.is_open(handle) THEN
      dbms_sql.close_cursor(handle);
END IF;
    RAISE;
END;
/

SELECT * FROM obj;

Related Topics

Native Dynamic SQL

-----