Oracle PL/SQL 优化与调整 -- Bulk 说明

 

. Bulk 概述

       本来只想测试一下Bulk Collect update性能的,但发现Bulk 的东西还是很多的,在OTN上搜了一些,整理如下。

 

1.1 Bulk Binding Bulk SQL

From:  http://download.oracle.com/docs/cd/E11882_01/appdev.112/e17125/adfns_packages.htm#ADFNS343

 

       Oracle Database uses two engines to run PL/SQL blocks and subprograms. The PL/SQL engine runs procedural statements, while the SQL engine runs SQL statements. During execution, every SQL statement causes a context switch between the two engines, resulting in performance overhead.

       -- Oracle 使用2个引擎来执行SQL和代码块:SQL 引擎和PL/SQL 引擎,SQL 语句会导致在两个引擎之间进行context switch,从而影响性能。

 

       Performance can be improved substantially by minimizing the number of context switches required to run a particular block or subprogram. When a SQL statement runs inside a loop that uses collection elements as bind variables, the large number of context switches required by the block can cause poor performance. Collections include:

       1Varrays

       2Nested tables

       3Index-by tables

       4Host arrays

 

       -- 从本质上讲,使用特殊的block 或者 subprogram 来降低context switches 可以提高性能。 SQL 语句在loop 内使用 collection elements 作为bind variables 来运行时,就会产生大量的context switches

 

       Bulk SQL minimizes the performance overhead of the communication between PL/SQL and SQL.

       PL/SQL and SQL communicate as follows:

       To run a SELECT INTO or DML statement, the PL/SQL engine sends the query or DML statement to the SQL engine. The SQL engine runs the query or DML statement and returns the result to the PL/SQL engine.

       -- PL/SQL SQL 引擎的交流方式

 

       The PL/SQL features that comprise bulk SQL are the FORALL statement and the BULK COLLECT clause.

       The FORALL statement sends DML statements from PL/SQL to SQL in batches rather than one at a time.

       The BULK COLLECT clause returns results from SQL to PL/SQL in batches rather than one at a time. If a query or DML statement affects four or more database rows, then bulk SQL can significantly improve performance.

       Assigning values to PL/SQL variables that appear in SQL statements is called binding.

 

PL/SQL binding operations fall into these categories:

Binding Category

When This Binding Occurs

In-bind

When an INSERT or UPDATE statement stores a PL/SQL or host variable in the database

Out-bind

When the RETURNING INTO clause of an INSERT, UPDATE, or DELETE statement assigns a database value to a PL/SQL or host variable

DEFINE

When a SELECT or FETCH statement assigns a database value to a PL/SQL or host variable

 

       For in-binds and out-binds, bulk SQL uses bulk binding; that is, it binds an entire collection of values at once.

       For a collection of n elements, bulk SQL uses a single operation to perform the equivalent of n SELECT INTO or DML statements. A query that uses bulk SQL can return any number of rows, without using a FETCH statement for each one.

 

       Binding is the assignment of values to PL/SQL variables in SQL statements. Bulk binding is binding an entire collection at once. Bulk binds pass the entire collection back and forth between the two engines in a single operation.

       --Binding 是在SQL 语句里分配一个value PL/SQL 变量

       --Bulk Binding 是一次分配所有的数据,然后通过这个entire collection,在一个操作就可以完成两个引擎处理。

 

       Typically, using bulk binds improves performance for SQL statements that affect four or more database rows. The more rows affected by a SQL statement, the greater the performance gain from bulk binds.

 

注意:

       Parallel DML statements are disabled with bulk binds and bulk SQL.

       并行的DML 操作会禁用bulk binds bulk SQL.

 

Note:

       This section provides an overview of bulk binds to help you decide whether to use them in your PL/SQL applications. For detailed information about using bulk binds, including ways to handle exceptions that occur in the middle of a bulk bind operation, see Oracle Database PL/SQL Language Reference.

 

1.2 When to Use Bulk Binds

Consider using bulk binds to improve the performance of:

       DML Statements that Reference Collections

       SELECT Statements that Reference Collections

       FOR Loops that Reference Collections and Return DML

 

1.2.1  DML Statements that Reference Collections

       A bulk bind, which uses the FORALL keyword, can improve the performance of INSERT, UPDATE, or DELETE statements that reference collection elements.

 

      The PL/SQL block in Example 6-9 increases the salary for employees whose manager's ID number is 7902, 7698, or 7839, with and without bulk binds. Without bulk bind, PL/SQL sends a SQL statement to the SQL engine for each updated employee, leading to context switches that slow performance.

 

Example 6-9 DML Statements that Reference Collections

declare

  type numlist is varray (100) of number;

  id numlist := numlist(7902, 7698, 7839);

begin

-- Efficient method, using bulk bind:

  forall i in id.first..id.last

  update employees

  set salary = 1.1 * salary

  where manager_id = id(i);

 

 -- Slower method:

 for i in id.first..id.last loop

    update employees

    set salary = 1.1 * salary

    where manager_id = id(i);

 end loop;

end;

/

1.2.2  SELECT Statements that Reference Collections

       The BULK COLLECT INTO clause can improve the performance of queries that reference collections. You can use BULK COLLECT INTO with tables of scalar values, or tables of %TYPE values.

 

       The PL/SQL block in Example 6-10 queries multiple values into PL/SQL tables, with and without bulk binds. Without bulk bind, PL/SQL sends a SQL statement to the SQL engine for each selected employee, leading to context switches that slow performance.

 

Example 6-10 SELECT Statements that Reference Collections

declare

  type var_tab is table of varchar2(20)

  index by pls_integer;

 

  empno    var_tab;

  ename    var_tab;

  counter  number;

 

  cursor c is

    select employee_id, last_name

    from employees

    where manager_id = 7698;

begin

-- Efficient method, using bulk bind:

 select employee_id, last_name bulk collect

 into empno, ename

 from employees

 where manager_id = 7698;

 

 -- Slower method:

 counter := 1;

 for rec in c loop

    empno(counter) := rec.employee_id;

    ename(counter) := rec.last_name;

    counter := counter + 1;

 end loop;

end;

/

1.2.3  FOR Loops that Reference Collections and Return DML

       You can use the FORALL keyword with the BULK COLLECT INTO keywords to improve the performance of FOR loops that reference collections and return DML.

 

       The PL/SQL block in Example 6-11 updates the EMPLOYEES table by computing bonuses for a collection of employees. Then it returns the bonuses in a column called bonus_list_inst. The actions are performed with and without bulk binds. Without bulk bind, PL/SQL sends a SQL statement to the SQL engine for each updated employee, leading to context switches that slow performance.

 

Example 6-11 FOR Loops that Reference Collections and Return DML

 

declare

  type emp_list is varray(100) of employees.employee_id%type;

  empids emp_list := emp_list(182, 187, 193, 200, 204, 206);

 

  type bonus_list is table of employees.salary%type;

  bonus_list_inst  bonus_list;

 

begin

-- Efficient method, using bulk bind:

 forall i in empids.first..empids.last

 update employees

 set salary = 0.1 * salary

 where employee_id = empids(i)

 returning salary bulk collect into bonus_list_inst;

 

 -- Slower method:

 for i in empids.first..empids.last loop

   update employees

   set salary = 0.1 * salary

   where employee_id = empids(i)

   returning salary into bonus_list_inst(i);

 end loop;

end;

/

1.3 Triggers

       A trigger is a special kind of PL/SQL anonymous block. You can define triggers to fire before or after SQL statements, either on a statement level or for each row that is affected. You can also define INSTEAD OF triggers or system triggers (triggers on DATABASE and SCHEMA).

 

 

. 有关Bulk SQL Bulk Binding 的更多示例

From

Bulk SQL and Bulk Binding

http://download.oracle.com/docs/cd/E11882_01/appdev.112/e17126/tuning.htm

 

2.1 FORALL Statement

       The FORALL statement, a feature of bulk SQL, sends DML statements from PL/SQL to SQL in batches rather than one at a time.

       To understand the FORALL statement, first consider the FOR LOOP statement in Example 12-7. It sends these DML statements from PL/SQL to SQL one at a time:

       delete from employees_temp where department_id = depts(10);

       delete from employees_temp where department_id = depts(30);

       delete from employees_temp where department_id = depts(70);

 

Example 12-7 DELETE Statement in FOR LOOP Statement

DROP TABLE employees_temp;

CREATE TABLE employees_temp AS SELECT * FROM employees;

 

DECLARE

  TYPE NumList IS VARRAY(20) OF NUMBER;

  depts NumList := NumList(10, 30, 70);  -- department numbers

BEGIN

  FOR i IN depts.FIRST..depts.LAST LOOP

    DELETE FROM employees_temp

    WHERE department_id = depts(i);

  END LOOP;

END;

/

 

       Now consider the FORALL statement in Example 12-8. It sends the same three DML statements from PL/SQL to SQL as a batch.

 

Example 12-8 DELETE Statement in FORALL Statement

DROP TABLE employees_temp;

CREATE TABLE employees_temp AS SELECT * FROM employees;

 

DECLARE

  TYPE NumList IS VARRAY(20) OF NUMBER;

  depts NumList := NumList(10, 30, 70);  -- department numbers

BEGIN

  FORALL i IN depts.FIRST..depts.LAST

    DELETE FROM employees_temp

    WHERE department_id = depts(i);

END;

/

       A FORALL statement is usually much faster than an equivalent FOR LOOP statement. However, a FOR LOOP statement can contain multiple DML statements, while a FORALL statement can contain only one.

       --FORALL 只能包含一条DML 语句,而FOR LOOP 可以包含多条

 

       The batch of DML statements that a FORALL statement sends to SQL differ only in their VALUES and WHERE clauses. The values in those clauses must come from existing, populated collections.

 

Note:

       The DML statement in a FORALL statement can reference multiple collections, but performance benefits apply only to collection references that use the FORALL index variable as an index.

 

       Example 12-9 inserts the same collection elements into two database tables, using a FOR LOOP statement for the first table and a FORALL statement for the second table and showing how long each statement takes. (Times vary from run to run.)

 

Example 12-9 Time Difference for INSERT Statement in FOR LOOP and FORALL Statements

DROP TABLE parts1;

CREATE TABLE parts1 (

  pnum INTEGER,

  pname VARCHAR2(15)

);

 

DROP TABLE parts2;

CREATE TABLE parts2 (

  pnum INTEGER,

  pname VARCHAR2(15)

);

 

DECLARE

  TYPE NumTab IS TABLE OF parts1.pnum%TYPE INDEX BY PLS_INTEGER;

  TYPE NameTab IS TABLE OF parts1.pname%TYPE INDEX BY PLS_INTEGER;

  pnums   NumTab;

  pnames  NameTab;

  iterations  CONSTANT PLS_INTEGER := 50000;

  t1  INTEGER;

  t2  INTEGER;

  t3  INTEGER;

BEGIN

  FOR j IN 1..iterations LOOP  -- populate collections

    pnums(j) := j;

    pnames(j) := 'Part No. ' || TO_CHAR(j);

  END LOOP;

 

  t1 := DBMS_UTILITY.get_time;

 

  FOR i IN 1..iterations LOOP

    INSERT INTO parts1 (pnum, pname)

    VALUES (pnums(i), pnames(i));

  END LOOP;

 

  t2 := DBMS_UTILITY.get_time;

 

  FORALL i IN 1..iterations

    INSERT INTO parts2 (pnum, pname)

    VALUES (pnums(i), pnames(i));

 

  t3 := DBMS_UTILITY.get_time;

 

  DBMS_OUTPUT.PUT_LINE('Execution Time (secs)');

  DBMS_OUTPUT.PUT_LINE('---------------------');

  DBMS_OUTPUT.PUT_LINE('FOR LOOP: ' || TO_CHAR((t2 - t1)/100));

  DBMS_OUTPUT.PUT_LINE('FORALL:   ' || TO_CHAR((t3 - t2)/100));

  COMMIT;

END;

/

 

Result is similar to:

Execution Time (secs)

---------------------

FOR LOOP: 2.16

FORALL:   .11

 

PL/SQL procedure successfully completed.

 

In Example 12-10, the FORALL statement applies to a subset of a collection.

 

Example 12-10 FORALL Statement for Subset of Collection

DROP TABLE employees_temp;

CREATE TABLE employees_temp AS SELECT * FROM employees;

 

DECLARE

  TYPE NumList IS VARRAY(10) OF NUMBER;

  depts NumList := NumList(5,10,20,30,50,55,57,60,70,75);

BEGIN

  FORALL j IN 4..7

    DELETE FROM employees_temp WHERE department_id = depts(j);

END;

/

2.2  FORALL Statements for Sparse Collections

       If the FORALL statement bounds clause references a sparse collection, then specify only existing index values, using either the INDICES OF or VALUES OF clause. You can use INDICES OF for any collection except an associative array indexed by string. You can use VALUES OF only for a collection of PLS_INTEGER elements indexed by PLS_INTEGER.

 

       A collection of PLS_INTEGER elements indexed by PLS_INTEGER can be an index collection; that is, a collection of pointers to elements of another collection (the indexed collection).

       Index collections are useful for processing different subsets of the same collection with different FORALL statements. Instead of copying elements of the original collection into new collections that represent the subsets (which can use significant time and memory), represent each subset with an index collection and then use each index collection in the VALUES OF clause of a different FORALL statement.

 

       Example 12-11 uses a FORALL statement with the INDICES OF clause to populate a table with the elements of a sparse collection. Then it uses two FORALL statements with VALUES OF clauses to populate two tables with subsets of a collection.

 

Example 12-11 FORALL Statements for Sparse Collection and Its Subsets

DROP TABLE valid_orders;

CREATE TABLE valid_orders (

  cust_name  VARCHAR2(32),

  amount     NUMBER(10,2)

);

 

DROP TABLE big_orders;

CREATE TABLE big_orders AS

  SELECT * FROM valid_orders

  WHERE 1 = 0;

 

DROP TABLE rejected_orders;

CREATE TABLE rejected_orders AS

  SELECT * FROM valid_orders

  WHERE 1 = 0;

 

DECLARE

  SUBTYPE cust_name IS valid_orders.cust_name%TYPE;

  TYPE cust_typ IS TABLE OF cust_name;

  cust_tab  cust_typ;  -- Collection of customer names

 

  SUBTYPE order_amount IS valid_orders.amount%TYPE;

  TYPE amount_typ IS TABLE OF NUMBER;

  amount_tab  amount_typ;  -- Collection of order amounts

 

  TYPE index_pointer_t IS TABLE OF PLS_INTEGER;

 

  /* Collections for pointers to elements of cust_tab collection

     (to represent two subsets of cust_tab): */

 

  big_order_tab       index_pointer_t := index_pointer_t();

  rejected_order_tab  index_pointer_t := index_pointer_t();

 

  PROCEDURE populate_data_collections IS

  BEGIN

    cust_tab := cust_typ(

      'Company1','Company2','Company3','Company4','Company5'

    );

    amount_tab := amount_typ(5000.01, 0, 150.25, 4000.00, NULL);

  END;

 

BEGIN

       populate_data_collections;

 

  DBMS_OUTPUT.PUT_LINE ('--- Original order data ---');

 

  FOR i IN 1..cust_tab.LAST LOOP

    DBMS_OUTPUT.PUT_LINE (

      'Customer #' || i || ', ' || cust_tab(i) || ': $' || amount_tab(i)

    );

  END LOOP;

 

  -- Delete invalid orders:

  FOR i IN 1..cust_tab.LAST LOOP

    IF amount_tab(i) IS NULL OR amount_tab(i) = 0 THEN

      cust_tab.delete(i);

      amount_tab.delete(i);

    END IF;

  END LOOP;

 

  -- cust_tab is now a sparse collection.

  DBMS_OUTPUT.PUT_LINE ('--- Order data with invalid orders deleted ---');

 

  FOR i IN 1..cust_tab.LAST LOOP

    IF cust_tab.EXISTS(i) THEN

      DBMS_OUTPUT.PUT_LINE (

        'Customer #' || i || ', ' || cust_tab(i) || ': $' || amount_tab(i)

      );

    END IF;

  END LOOP;

 

  -- Using sparse collection, populate valid_orders table:

   FORALL i IN INDICES OF cust_tab

    INSERT INTO valid_orders (cust_name, amount)

    VALUES (cust_tab(i), amount_tab(i));

 

  populate_data_collections;  -- Restore original order data

 

  -- cust_tab is a dense collection again.

 

  /* Populate collections of pointers to elements of cust_tab collection

     (which represent two subsets of cust_tab): */

 

  FOR i IN cust_tab.FIRST .. cust_tab.LAST LOOP

    IF amount_tab(i) IS NULL OR amount_tab(i) = 0 THEN

      rejected_order_tab.EXTEND;

      rejected_order_tab(rejected_order_tab.LAST) := i;

    END IF;

 

    IF amount_tab(i) > 2000 THEN

      big_order_tab.EXTEND;

      big_order_tab(big_order_tab.LAST) := i;

    END IF;

  END LOOP;

 

  /* Using each subset in a different FORALL statement,

     populate rejected_orders and big_orders tables: */

 

  FORALL i IN VALUES OF rejected_order_tab

    INSERT INTO rejected_orders (cust_name, amount)

    VALUES (cust_tab(i), amount_tab(i));

 

  FORALL i IN VALUES OF big_order_tab

    INSERT INTO big_orders (cust_name, amount)

    VALUES (cust_tab(i), amount_tab(i));

END;

/

 

2.3  Unhandled Exceptions in FORALL Statements

       In a FORALL statement without the SAVE EXCEPTIONS clause, if one DML statement raises an unhandled exception, then PL/SQL stops the FORALL statement and rolls back all changes made by previous DML statements.

       For example, the FORALL statement in Example 12-8 executes these DML statements in this order, unless one of them raises an unhandled exception:

       DELETE FROM employees_temp WHERE department_id = depts(10);

       DELETE FROM employees_temp WHERE department_id = depts(30);

       DELETE FROM employees_temp WHERE department_id = depts(70);

 

       If the third statement raises an unhandled exception, then PL/SQL rolls back the changes that the first and second statements made. If the second statement raises an unhandled exception, then PL/SQL rolls back the changes that the first statement made and never runs the third statement.

 

You can handle exceptions raised in a FORALL statement in either of these ways:

       1As each exception is raised (see "Handling FORALL Exceptions Immediately")

       2After the FORALL statement completes execution, by including the SAVE EXCEPTIONS clause (see "Handling FORALL Exceptions After FORALL Statement Completes")

 

2.4 Handling FORALL Exceptions Immediately

       To handle exceptions raised in a FORALL statement immediately, omit the SAVE EXCEPTIONS clause and write the appropriate exception handlers. (For information about exception handlers, see Chapter 11, "PL/SQL Error Handling.") If one DML statement raises a handled exception, then PL/SQL rolls back the changes made by that statement, but does not roll back changes made by previous DML statements.

       In Example 12-12, the FORALL statement is designed to run three UPDATE statements. However, the second one raises an exception. An exception handler handles the exception, displaying the error message and committing the change made by the first UPDATE statement. The third UPDATE statement never runs.

 

Example 12-12 Handling FORALL Exceptions Immediately

DROP TABLE emp_temp;

CREATE TABLE emp_temp (

  deptno NUMBER(2),

  job VARCHAR2(18)

);

 

CREATE OR REPLACE PROCEDURE p AUTHID DEFINER AS

  TYPE NumList IS TABLE OF NUMBER;

 

  depts          NumList := NumList(10, 20, 30);

  error_message  VARCHAR2(100);

 

BEGIN

  -- Populate table:

 

  INSERT INTO emp_temp (deptno, job) VALUES (10, 'Clerk');

  INSERT INTO emp_temp (deptno, job) VALUES (20, 'Bookkeeper');

  INSERT INTO emp_temp (deptno, job) VALUES (30, 'Analyst');

  COMMIT;

 

  -- Append 9-character string to each job:

 

  FORALL j IN depts.FIRST..depts.LAST

    UPDATE emp_temp SET job = job || ' (Senior)'

    WHERE deptno = depts(j);

 

EXCEPTION

  WHEN OTHERS THEN

    error_message := SQLERRM;

    DBMS_OUTPUT.PUT_LINE (error_message);

 

    COMMIT;  -- Commit results of successful updates

    RAISE;

END;

/

Result:

Procedure created.

Invoke procedure:

BEGIN

  p;

END;

/

 

Result:

ORA-12899: value too large for column "HR"."EMP_TEMP"."JOB" (actual: 19,

maximum: 18)

ORA-06512: at "HR.P", line 27

ORA-06512: at line 2

 

PL/SQL procedure successfully completed.

 

Query:

SELECT * FROM emp_temp;

Result:

DEPTNO JOB

---------- ------------------

        10 Clerk (Senior)

        20 Bookkeeper

        30 Analyst

 

3 rows selected.

 

2.5 Handling FORALL Exceptions After FORALL Statement Completes

       To allow a FORALL statement to continue even if some of its DML statements fail, include the SAVE EXCEPTIONS clause. When a DML statement fails, PL/SQL does not raise an exception; instead, it saves information about the failure. After the FORALL statement completes, PL/SQL raises a single exception for the FORALL statement (ORA-24381). In the exception handler for ORA-24381, you can get information about each individual DML statement failure from the implicit cursor attribute SQL%BULK_EXCEPTIONS.

       SQL%BULK_EXCEPTIONS is like an associative array of information about the DML statements that failed during the most recently run FORALL statement.

       SQL%BULK_EXCEPTIONS.COUNT is the number of DML statements that failed. If SQL%BULK_EXCEPTIONS.COUNT is not zero, then for each index value i from 1 through SQL%BULK_EXCEPTIONS.COUNT:

       1SQL%BULK_EXCEPTIONS(i).ERROR_INDEX is the number of the DML statement that failed.

       2SQL%BULK_EXCEPTIONS(i).ERROR_CODE is the Oracle Database error code for the failure.

 

       For example, if a FORALL SAVE EXCEPTIONS statement runs 100 DML statements, and the tenth and sixty-fourth ones fail with error codes ORA-12899 and ORA-19278, respectively, then:

       SQL%BULK_EXCEPTIONS.COUNT = 2

       SQL%BULK_EXCEPTIONS(1).ERROR_INDEX = 10

       SQL%BULK_EXCEPTIONS(1).ERROR_CODE = 12899

       SQL%BULK_EXCEPTIONS(2).ERROR_INDEX = 64

       SQL%BULK_EXCEPTIONS(2).ERROR_CODE = 19278

 

Note:

       After a FORALL statement without the SAVE EXCEPTIONS clause raises an exception, SQL%BULK_EXCEPTIONS.COUNT = 1.

       With the error code, you can get the associated error message with the SQLERRM function (described in "SQLERRM Function"):

       SQLERRM(-(SQL%BULK_EXCEPTIONS(i).ERROR_CODE))

      

       However, the error message that SQLERRM returns excludes any substitution arguments (compare the error messages in Example 12-12 and Example 12-13).

 

Example 12-13 is like Example 12-12 except:

       1The FORALL statement includes the SAVE EXCEPTIONS clause.

       2The exception-handling part has an exception handler for ORA-24381, the internally defined exception that PL/SQL raises implicitly when a bulk operation raises and saves exceptions. The example gives ORA-24381 the user-defined name dml_errors.

       3The exception handler for dml_errors uses SQL%BULK_EXCEPTIONS and SQLERRM (and some local variables) to show the error message and which statement, collection item, and string caused the error.

 

Example 12-13 Handling FORALL Exceptions After FORALL Statement Completes

CREATE OR REPLACE PROCEDURE p AUTHID DEFINER AS

  TYPE NumList IS TABLE OF NUMBER;

  depts        NumList := NumList(10, 20, 30);

 

  error_message  VARCHAR2(100);

  bad_stmt_no    PLS_INTEGER;

  bad_deptno     emp_temp.deptno%TYPE;

  bad_job        emp_temp.job%TYPE;

 

  dml_errors  EXCEPTION;

  PRAGMA EXCEPTION_INIT(dml_errors, -24381);

BEGIN

  -- Populate table:

 

  INSERT INTO emp_temp (deptno, job) VALUES (10, 'Clerk');

  INSERT INTO emp_temp (deptno, job) VALUES (20, 'Bookkeeper');

  INSERT INTO emp_temp (deptno, job) VALUES (30, 'Analyst');

  COMMIT;

 

  -- Append 9-character string to each job:

 

  FORALL j IN depts.FIRST..depts.LAST SAVE EXCEPTIONS

    UPDATE emp_temp SET job = job || ' (Senior)'

    WHERE deptno = depts(j);

 

EXCEPTION

  WHEN dml_errors THEN

    FOR i IN 1..SQL%BULK_EXCEPTIONS.COUNT LOOP

      error_message := SQLERRM(-(SQL%BULK_EXCEPTIONS(i).ERROR_CODE));

      DBMS_OUTPUT.PUT_LINE (error_message);

 

      bad_stmt_no := SQL%BULK_EXCEPTIONS(i).ERROR_INDEX;

      DBMS_OUTPUT.PUT_LINE('Bad statement #: ' || bad_stmt_no);

 

      bad_deptno := depts(bad_stmt_no);

      DBMS_OUTPUT.PUT_LINE('Bad department #: ' || bad_deptno);

 

      SELECT job INTO bad_job FROM emp_temp WHERE deptno = bad_deptno;

 

      DBMS_OUTPUT.PUT_LINE('Bad job: ' || bad_job);

    END LOOP;

 

    COMMIT;  -- Commit results of successful updates

 

    WHEN OTHERS THEN

      DBMS_OUTPUT.PUT_LINE('Unrecognized error.');

      RAISE;

END;

/

 

Result:

Procedure created.

Invoke procedure:

BEGIN

  p;

END;

/

Result:

ORA-12899: value too large for column  (actual: , maximum: )

Bad statement #: 2

Bad department #: 20

Bad job: Bookkeeper

PL/SQL procedure successfully completed.

 

Query:

SELECT * FROM emp_temp;

Result:

DEPTNO JOB

---------- ------------------

        10 Clerk (Senior)

        20 Bookkeeper

        30 Analyst (Senior)

 

3 rows selected.

 

2.6 Sparse Collections and SQL%BULK_EXCEPTIONS

       If the FORALL statement bounds clause references a sparse collection, then to find the collection element that caused a DML statement to fail, you must step through the elements one by one until you find the element whose index is SQL%BULK_EXCEPTIONS(i).ERROR_INDEX. Then, if the FORALL statement uses the VALUES OF clause to reference a collection of pointers into another collection, you must find the element of the other collection whose index is SQL%BULK_EXCEPTIONS(i).ERROR_INDEX.

 

2.7 Getting Number of Rows Affected by FORALL Statement

       After a FORALL statement completes, you can get the number of rows that each DML statement affected from the implicit cursor attribute SQL%BULK_ROWCOUNT. (To get the total number of rows affected by the FORALL statement, use the implicit cursor attribute SQL%ROWCOUNT, described in "SQL%ROWCOUNT Attribute: How Many Rows Were Affected?".)

       SQL%BULK_ROWCOUNT is like an associative array whose ith element is the number of rows affected by the ith DML statement in the most recently completed FORALL statement.

       Example 12-14 uses SQL%BULK_ROWCOUNT to show how many rows each DELETE statement in the FORALL statement deleted and SQL%ROWCOUNT to show the total number of rows deleted.

 

Example 12-14 Showing Number of Rows Affected by Each DELETE in FORALL

 

DROP TABLE emp_temp;

CREATE TABLE emp_temp AS SELECT * FROM employees;

 

DECLARE

  TYPE NumList IS TABLE OF NUMBER;

  depts NumList := NumList(30, 50, 60);

BEGIN

  FORALL j IN depts.FIRST..depts.LAST

    DELETE FROM emp_temp WHERE department_id = depts(j);

 

  FOR i IN depts.FIRST..depts.LAST LOOP

    DBMS_OUTPUT.PUT_LINE (

      'Statement #' || i || ' deleted ' ||

      SQL%BULK_ROWCOUNT(i) || ' rows.'

    );

  END LOOP;

 

  DBMS_OUTPUT.PUT_LINE('Total rows deleted: ' || SQL%ROWCOUNT);

END;

/

Result:

Statement #1 deleted 6 rows.

Statement #2 deleted 45 rows.

Statement #3 deleted 5 rows.

Total rows deleted: 56

 

       Example 12-15 uses SQL%BULK_ROWCOUNT to show how many rows each INSERT SELECT construct in the FORALL statement inserted and SQL%ROWCOUNT to show the total number of rows inserted.

 

Example 12-15 Showing Number of Rows Affected by Each INSERT SELECT in FORALL

DROP TABLE emp_by_dept;

CREATE TABLE emp_by_dept AS

  SELECT employee_id, department_id

  FROM employees

  WHERE 1 = 0;

 

DECLARE

  TYPE dept_tab IS TABLE OF departments.department_id%TYPE;

  deptnums  dept_tab;

BEGIN

  SELECT department_id BULK COLLECT INTO deptnums FROM departments;

 

  FORALL i IN 1..deptnums.COUNT

    INSERT INTO emp_by_dept (employee_id, department_id)

      SELECT employee_id, department_id

      FROM employees

      WHERE department_id = deptnums(i)

      ORDER BY department_id, employee_id;

 

  FOR i IN 1..deptnums.COUNT LOOP

    -- Count how many rows were inserted for each department; that is,

    -- how many employees are in each department.

    DBMS_OUTPUT.PUT_LINE (

      'Dept '||deptnums(i)||': inserted '||

      SQL%BULK_ROWCOUNT(i)||' records'

    );

  END LOOP;

  DBMS_OUTPUT.PUT_LINE('Total records inserted: ' || SQL%ROWCOUNT);

END;

/

Result:

Dept 10: inserted 1 records

...

Dept 280: inserted 0 records

Total records inserted: 106

 

2.8 BULK COLLECT Clause

       The BULK COLLECT clause, a feature of bulk SQL, returns results from SQL to PL/SQL in batches rather than one at a time. The BULK COLLECT clause can appear in:

1SELECT INTO statement

2FETCH statement

3RETURNING INTO clause of:

       ADELETE statement

       BINSERT statement

       CUPDATE statement

       DEXECUTE IMMEDIATE statement

 

       With the BULK COLLECT clause, each of the preceding statements retrieves an entire result set and stores it in one or more collection variables in a single operation (which is more efficient than using a loop statement to retrieve one result row at a time).

 

Note:

       PL/SQL processes the BULK COLLECT clause similar to the way it processes a FETCH statement inside a LOOP statement. PL/SQL does not raise an exception when a statement with a BULK COLLECT clause returns no rows. You must check the target collections for emptiness (if they are associative arrays) or nullness (if they are varrays or nested tables), as in Example 12-22.

 

2.9  SELECT INTO Statement with BULK COLLECT Clause

       The SELECT INTO statement with the BULK COLLECT clause (also called the SELECT BULK COLLECT INTO statement) selects an entire result set into one or more collection variables. For more information, see "SELECT INTO Statement".

 

Caution:

       The SELECT BULK COLLECT INTO statement is vulnerable to aliasing, which can cause unexpected results. For details, see "SELECT BULK COLLECT INTO Statements and Aliasing".

 

Example 12-16 uses a SELECT BULK COLLECT INTO statement to select two database columns into two collections (nested tables).

 

Example 12-16 Bulk-Selecting Two Database Columns into Two Nested Tables

DECLARE

  TYPE NumTab IS TABLE OF employees.employee_id%TYPE;

  TYPE NameTab IS TABLE OF employees.last_name%TYPE;

 

  enums NumTab;

  names NameTab;

 

  PROCEDURE print_first_n (n POSITIVE) IS

  BEGIN

    IF enums.COUNT = 0 THEN

      DBMS_OUTPUT.PUT_LINE ('Collections are empty.');

    ELSE

      DBMS_OUTPUT.PUT_LINE ('First ' || n || ' employees:');

 

      FOR i IN 1 .. n LOOP

        DBMS_OUTPUT.PUT_LINE (

          '  Employee #' || enums(i) || ': ' || names(i));

      END LOOP;

    END IF;

  END;

 

BEGIN

  SELECT employee_id, last_name

  BULK COLLECT INTO enums, names

  FROM employees

  ORDER BY employee_id;

 

  print_first_n(3);

  print_first_n(6);

END;

/

 

Example 12-17 uses a SELECT BULK COLLECT INTO statement to select a result set into a nested table of records.

Example 12-17 Bulk-Selecting into Nested Table of Records

 

DECLARE

  CURSOR c1 IS

    SELECT first_name, last_name, hire_date

    FROM employees;

 

  TYPE NameSet IS TABLE OF c1%ROWTYPE;

 

  stock_managers  NameSet;  -- nested table of records

 

BEGIN

  -- Assign values to nested table of records:

 

  SELECT first_name, last_name, hire_date

    BULK COLLECT INTO stock_managers

    FROM employees

    WHERE job_id = 'ST_MAN'

    ORDER BY hire_date;

 

  -- Print nested table of records:

 

    FOR i IN stock_managers.FIRST .. stock_managers.LAST LOOP

      DBMS_OUTPUT.PUT_LINE (

        stock_managers(i).hire_date || ' ' ||

        stock_managers(i).last_name  || ', ' ||

        stock_managers(i).first_name

      );

    END LOOP;END;

/

 

2.10 SELECT BULK COLLECT INTO Statements and Aliasing

In a statement of the form

       SELECT column BULK COLLECT INTO collection FROM table ...

column and collection are analogous to IN NOCOPY and OUT NOCOPY subprogram parameters, respectively, and PL/SQL passes them by reference. As with subprogram parameters that are passed by reference, aliasing can cause unexpected results.

 

See Also:

"Subprogram Parameter Aliasing with Parameters Passed by Reference"

 

       In Example 12-18, the intention is to select specific values from a collection, numbers1, and then store them in the same collection. The unexpected result is that all elements of numbers1 are deleted. For workarounds, see Example 12-19 and Example 12-20.

 

Example 12-18 SELECT BULK COLLECT INTO Statement with Unexpected Results

CREATE OR REPLACE TYPE numbers_type IS

  TABLE OF INTEGER

/

CREATE OR REPLACE PROCEDURE p (i IN INTEGER) IS

  numbers1  numbers_type := numbers_type(1,2,3,4,5);

BEGIN

  DBMS_OUTPUT.PUT_LINE('Before SELECT statement');

  DBMS_OUTPUT.PUT_LINE('numbers1.COUNT() = ' || numbers1.COUNT());

 

  FOR j IN 1..numbers1.COUNT() LOOP

    DBMS_OUTPUT.PUT_LINE('numbers1(' || j || ') = ' || numbers1(j));

  END LOOP;

 

  --Self-selecting BULK COLLECT INTO clause:

 

  SELECT a.COLUMN_VALUE

  BULK COLLECT INTO numbers1

  FROM TABLE(numbers1) a

  WHERE a.COLUMN_VALUE > p.i

  ORDER BY a.COLUMN_VALUE;

 

  DBMS_OUTPUT.PUT_LINE('After SELECT statement');

  DBMS_OUTPUT.PUT_LINE('numbers1.COUNT() = ' || numbers1.COUNT());

END p;

/

Invoke p:

BEGIN

  p(2);

END;

/

Result:

Before SELECT statement

numbers1.COUNT() = 5

numbers1(1) = 1

numbers1(2) = 2

numbers1(3) = 3

numbers1(4) = 4

numbers1(5) = 5

After SELECT statement

numbers1.COUNT() = 0

 

Invoke p:

BEGIN

  p(10);

END;

/

Result:

Before SELECT statement

numbers1.COUNT() = 5

numbers1(1) = 1

numbers1(2) = 2

numbers1(3) = 3

numbers1(4) = 4

numbers1(5) = 5

After SELECT statement

numbers1.COUNT() = 0

 

Example 12-19 uses a cursor to achieve the result intended by Example 12-18.

Example 12-19 Cursor Workaround for Example 12-18

 

CREATE OR REPLACE TYPE numbers_type IS

  TABLE OF INTEGER

/

CREATE OR REPLACE PROCEDURE p (i IN INTEGER) IS

  numbers1  numbers_type := numbers_type(1,2,3,4,5);

  

  CURSOR c IS

    SELECT a.COLUMN_VALUE

    FROM TABLE(numbers1) a

    WHERE a.COLUMN_VALUE > p.i

    ORDER BY a.COLUMN_VALUE;

  BEGIN

    DBMS_OUTPUT.PUT_LINE('Before FETCH statement');

    DBMS_OUTPUT.PUT_LINE('numbers1.COUNT() = ' || numbers1.COUNT());

 

    FOR j IN 1..numbers1.COUNT() LOOP

      DBMS_OUTPUT.PUT_LINE('numbers1(' || j || ') = ' || numbers1(j));

    END LOOP;

 

  OPEN c;

  FETCH c BULK COLLECT INTO numbers1;

  CLOSE c;

 

  DBMS_OUTPUT.PUT_LINE('After FETCH statement');

  DBMS_OUTPUT.PUT_LINE('numbers1.COUNT() = ' || numbers1.COUNT());

 

  IF numbers1.COUNT() > 0 THEN

    FOR j IN 1..numbers1.COUNT() LOOP

      DBMS_OUTPUT.PUT_LINE('numbers1(' || j || ') = ' || numbers1(j));

    END LOOP;

  END IF;

END p;

/

Invoke p:

BEGIN

  p(2);

END;

/

Result:

Before FETCH statement

numbers1.COUNT() = 5

numbers1(1) = 1

numbers1(2) = 2

numbers1(3) = 3

numbers1(4) = 4

numbers1(5) = 5

After FETCH statement

numbers1.COUNT() = 3

numbers1(1) = 3

numbers1(2) = 4

numbers1(3) = 5

 

      Example 12-20 selects specific values from a collection, numbers1, and then stores them in a different collection, numbers2. Example 12-20 runs faster than Example 12-19.

Example 12-20 Second Collection Workaround for Example 12-18

 

CREATE OR REPLACE TYPE numbers_type IS

  TABLE OF INTEGER

/

CREATE OR REPLACE PROCEDURE p (i IN INTEGER) IS

  numbers1  numbers_type := numbers_type(1,2,3,4,5);

 numbers2  numbers_type := numbers_type(0,0,0,0,0);

  

BEGIN

  DBMS_OUTPUT.PUT_LINE('Before SELECT statement');

 

  DBMS_OUTPUT.PUT_LINE('numbers1.COUNT() = ' || numbers1.COUNT());

 

  FOR j IN 1..numbers1.COUNT() LOOP

    DBMS_OUTPUT.PUT_LINE('numbers1(' || j || ') = ' || numbers1(j));

  END LOOP;

 

  DBMS_OUTPUT.PUT_LINE('numbers2.COUNT() = ' || numbers2.COUNT());

 

  FOR j IN 1..numbers2.COUNT() LOOP

    DBMS_OUTPUT.PUT_LINE('numbers2(' || j || ') = ' || numbers2(j));

  END LOOP;

 

  SELECT a.COLUMN_VALUE

  BULK COLLECT INTO numbers2      -- numbers2 appears here

  FROM TABLE(numbers1) a        -- numbers1 appears here

  WHERE a.COLUMN_VALUE > p.i

  ORDER BY a.COLUMN_VALUE;

 

  DBMS_OUTPUT.PUT_LINE('After SELECT statement');

  DBMS_OUTPUT.PUT_LINE('numbers1.COUNT() = ' || numbers1.COUNT());

 

  IF numbers1.COUNT() > 0 THEN

    FOR j IN 1..numbers1.COUNT() LOOP

      DBMS_OUTPUT.PUT_LINE('numbers1(' || j || ') = ' || numbers1(j));

    END LOOP;

  END IF;

 

  DBMS_OUTPUT.PUT_LINE('numbers2.COUNT() = ' || numbers2.COUNT());

 

  IF numbers2.COUNT() > 0 THEN

    FOR j IN 1..numbers2.COUNT() LOOP

      DBMS_OUTPUT.PUT_LINE('numbers2(' || j || ') = ' || numbers2(j));

    END LOOP;

  END IF;

END p;

/

 

2.11 Row Limits for SELECT BULK COLLECT INTO Statements

       A SELECT BULK COLLECT INTO statement that returns a large number of rows produces a large collection. To limit the number of rows and the collection size, use either the ROWNUM pseudocolumn (described in Oracle Database SQL Language Reference) or SAMPLE clause (described in Oracle Database SQL Language Reference).

 

       In Example 12-21, the first SELECT BULK COLLECT INTO statement uses ROWNUM to limit the number of rows to 50, and the second SELECT BULK COLLECT INTO statement uses SAMPLE to limit the number of rows to approximately 10% of the total.

 

Example 12-21 Limiting Bulk Selection with ROWNUM and SAMPLE

DECLARE

  TYPE SalList IS TABLE OF employees.salary%TYPE;

  sals SalList;

BEGIN

  SELECT salary BULK COLLECT INTO sals

  FROM employees

  WHERE ROWNUM <= 50;

 

  SELECT salary BULK COLLECT INTO sals FROM employees SAMPLE (10);

END;

/

 

2.12 Guidelines for Looping Through Collections

       When a result set is stored in a collection, it is easy to loop through the rows and refer to different columns. This technique can be very fast, but also very memory-intensive. If you use it often:

       1To loop once through the result set, use a cursor FOR LOOP (see "Query Result Set Processing With Cursor FOR LOOP Statements"). This technique avoids the memory overhead of storing a copy of the result set.

       2Instead of looping through the result set to search for certain values or filter the results into a smaller set, do the searching or filtering in the query of the SELECT INTO statement.

       For example, in simple queries, use WHERE clauses; in queries that compare multiple result sets, use set operators such as INTERSECT and MINUS. For information about set operators, see Oracle Database SQL Language Reference.

       3Instead of looping through the result set and running another query for each result row, use a subquery in the query of the SELECT INTO statement (see "Query Result Set Processing with Subqueries").

       4Instead of looping through the result set and running another DML statement for each result row, use the FORALL statement (see "FORALL Statement").

 

2.13 FETCH Statement with BULK COLLECT Clause

      The FETCH statement with the BULK COLLECT clause (also called the FETCH BULK COLLECT statement) fetches an entire result set into one or more collection variables. For more information, see "FETCH Statement".

 

Example 12-22 uses a FETCH BULK COLLECT statement to fetch an entire result set into two collections (nested tables).

Example 12-22 Bulk-Fetching into Two Nested Tables

DECLARE

  TYPE NameList IS TABLE OF employees.last_name%TYPE;

  TYPE SalList IS TABLE OF employees.salary%TYPE;

 

  CURSOR c1 IS

    SELECT last_name, salary FROM employees  WHERE salary > 10000

    ORDER BY last_name;

 

  names  NameList;

  sals   SalList;

 

  TYPE RecList IS TABLE OF c1%ROWTYPE;

  recs RecList;

 

  v_limit PLS_INTEGER := 10;

 

  PROCEDURE print_results IS

  BEGIN

    -- Check if collections are empty:

 

    IF names IS NULL OR names.COUNT = 0 THEN

      DBMS_OUTPUT.PUT_LINE('No results!');

    ELSE

      DBMS_OUTPUT.PUT_LINE('Result: ');

      FOR i IN names.FIRST .. names.LAST

      LOOP

        DBMS_OUTPUT.PUT_LINE('  Employee ' || names(i) || ': $' || sals(i));

      END LOOP;

    END IF;

  END;

 

BEGIN

  DBMS_OUTPUT.PUT_LINE ('--- Processing all results simultaneously ---');

  OPEN c1;

  FETCH c1 BULK COLLECT INTO names, sals;

  CLOSE c1;

  print_results();

  DBMS_OUTPUT.PUT_LINE ('--- Processing ' || v_limit || ' rows at a time ---');

  OPEN c1;

  LOOP

    FETCH c1 BULK COLLECT INTO names, sals LIMIT v_limit;

    EXIT WHEN names.COUNT = 0;

    print_results();

  END LOOP;

  CLOSE c1;

  DBMS_OUTPUT.PUT_LINE ('--- Fetching records rather than columns ---');

  OPEN c1;

  FETCH c1 BULK COLLECT INTO recs;

  FOR i IN recs.FIRST .. recs.LAST

  LOOP

    -- Now all columns from result set come from one record

    DBMS_OUTPUT.PUT_LINE (

      '  Employee ' || recs(i).last_name || ': $' || recs(i).salary

    );

  END LOOP;

END;

/

       Example 12-23 uses a FETCH BULK COLLECT statement to fetch a result set into a collection (nested table) of records.

Example 12-23 Bulk-Fetching into Nested Table of Records

DECLARE

  CURSOR c1 IS

    SELECT first_name, last_name, hire_date FROM employees;

 

  TYPE NameSet IS TABLE OF c1%ROWTYPE;

  stock_managers  NameSet;  -- nested table of records

 

  TYPE cursor_var_type is REF CURSOR;

  cv cursor_var_type;

 

BEGIN

  -- Assign values to nested table of records:

 

  OPEN cv FOR

    SELECT first_name, last_name, hire_date FROM employees

    WHERE job_id = 'ST_MAN'  ORDER BY hire_date;

 

  FETCH cv BULK COLLECT INTO stock_managers;

  CLOSE cv;

 

  -- Print nested table of records:

    FOR i IN stock_managers.FIRST .. stock_managers.LAST LOOP

      DBMS_OUTPUT.PUT_LINE (

        stock_managers(i).hire_date || ' ' ||

        stock_managers(i).last_name  || ', ' ||

        stock_managers(i).first_name

      );

    END LOOP;END;

/

 

2.14 Row Limits for FETCH BULK COLLECT Statements

       A FETCH BULK COLLECT statement that returns a large number of rows produces a large collection. To limit the number of rows and the collection size, use the LIMIT clause.

      In Example 12-24, with each iteration of the LOOP statement, the FETCH statement fetches ten rows (or fewer) into associative array empids (overwriting the previous values). Note the exit condition for the LOOP statement.

 

Example 12-24 Limiting Bulk FETCH with LIMIT

DECLARE

  TYPE numtab IS TABLE OF NUMBER INDEX BY PLS_INTEGER;

 

  CURSOR c1 IS SELECT employee_id

    FROM employees WHERE department_id = 80 ORDER BY employee_id;

 

  empids  numtab;

BEGIN

  OPEN c1;

  LOOP  -- Fetch 10 rows or fewer in each iteration

    FETCH c1 BULK COLLECT INTO empids LIMIT 10;

    EXIT WHEN empids.COUNT = 0;  -- Not: EXIT WHEN c1%NOTFOUND

    DBMS_OUTPUT.PUT_LINE ('------- Results from One Bulk Fetch --------');

    FOR i IN 1..empids.COUNT LOOP

      DBMS_OUTPUT.PUT_LINE ('Employee Id: ' || empids(i));

    END LOOP;

  END LOOP;

  CLOSE c1;

END;

/

 

2.15  RETURNING INTO Clause with BULK COLLECT Clause

       The RETURNING INTO clause with the BULK COLLECT clause (also called the RETURNING BULK COLLECT INTO clause) can appear in an INSERT, UPDATE, DELETE, or EXECUTE IMMEDIATE statement. With the RETURNING BULK COLLECT INTO clause, the statement stores its result set in one or more collections. For more information, see "RETURNING INTO Clause".

       Example 12-25 uses a DELETE statement with the RETURNING BULK COLLECT INTO clause to delete rows from a table and return them in two collections (nested tables).

 

Example 12-25 Returning Deleted Rows in Two Nested Tables

DROP TABLE emp_temp;

CREATE TABLE emp_temp AS

SELECT * FROM employees

ORDER BY employee_id;

 

DECLARE

  TYPE NumList IS TABLE OF employees.employee_id%TYPE;

  enums  NumList;

  TYPE NameList IS TABLE OF employees.last_name%TYPE;

  names  NameList;

BEGIN

  DELETE FROM emp_temp WHERE department_id = 30

  RETURNING employee_id, last_name BULK COLLECT INTO enums, names;

 

  DBMS_OUTPUT.PUT_LINE ('Deleted ' || SQL%ROWCOUNT || ' rows:');

  FOR i IN enums.FIRST .. enums.LAST

  LOOP

    DBMS_OUTPUT.PUT_LINE ('Employee #' || enums(i) || ': ' || names(i));

  END LOOP;

END;

/

 

2.16  Using FORALL Statement and BULK COLLECT Clause Together

       In a FORALL statement, the DML statement can have a RETURNING BULK COLLECT INTO clause. For each iteration of the FORALL statement, the DML statement stores the specified values in the specified collections—without overwriting the previous values, as the same DML statement would do in a FOR LOOP statement.

       In Example 12-26, the FORALL statement runs a DELETE statement that has a RETURNING BULK COLLECT INTO clause. For each iteration of the FORALL statement, the DELETE statement stores the employee_id and department_id values of the deleted row in the collections e_ids and d_ids, respectively.

 

Example 12-26 DELETE with RETURN BULK COLLECT INTO in FORALL Statement

DROP TABLE emp_temp;

CREATE TABLE emp_temp AS

SELECT * FROM employees

ORDER BY employee_id, department_id;

 

DECLARE

  TYPE NumList IS TABLE OF NUMBER;

  depts  NumList := NumList(10,20,30);

 

  TYPE enum_t IS TABLE OF employees.employee_id%TYPE;

  e_ids  enum_t;

 

  TYPE dept_t IS TABLE OF employees.department_id%TYPE;

  d_ids  dept_t;

 

BEGIN

  FORALL j IN depts.FIRST..depts.LAST

    DELETE FROM emp_temp WHERE department_id = depts(j)

    RETURNING employee_id, department_id

    BULK COLLECT INTO e_ids, d_ids;

 

  DBMS_OUTPUT.PUT_LINE ('Deleted ' || SQL%ROWCOUNT || ' rows:');

 

  FOR i IN e_ids.FIRST .. e_ids.LAST

  LOOP

    DBMS_OUTPUT.PUT_LINE (

      'Employee #' || e_ids(i) || ' from dept #' || d_ids(i)

    );

  END LOOP;

END;

/

       Example 12-27 is like Example 12-26 except that it uses a FOR LOOP statement instead of a FORALL statement.

 

Example 12-27 DELETE with RETURN BULK COLLECT INTO in FOR LOOP Statement

DECLARE

  TYPE NumList IS TABLE OF NUMBER;

  depts  NumList := NumList(10,20,30);

 

  TYPE enum_t IS TABLE OF employees.employee_id%TYPE;

  e_ids  enum_t;

 

  TYPE dept_t IS TABLE OF employees.department_id%TYPE;

  d_ids  dept_t;

 

BEGIN

  FOR j IN depts.FIRST..depts.LAST LOOP

    DELETE FROM emp_temp WHERE department_id = depts(j)

    RETURNING employee_id, department_id

    BULK COLLECT INTO e_ids, d_ids;

  END LOOP;

 

  DBMS_OUTPUT.PUT_LINE ('Deleted ' || SQL%ROWCOUNT || ' rows:');

 

  FOR i IN e_ids.FIRST .. e_ids.LAST

  LOOP

    DBMS_OUTPUT.PUT_LINE (

      'Employee #' || e_ids(i) || ' from dept #' || d_ids(i)

    );

  END LOOP;

END;

/

 

2.17 Client Bulk-Binding of Host Arrays

       Client programs (such as OCI and Pro*C programs) can use PL/SQL anonymous blocks to bulk-bind input and output host arrays. This is the most efficient way to pass collections to and from the database server.

       In the client program, declare and assign values to the host variables to be referenced in the anonymous block. In the anonymous block, prefix each host variable name with a colon (:) to distinguish it from a PL/SQL collection variable name. When the client program runs, the database server runs the PL/SQL anonymous block.

       In Example 12-28, the anonymous block uses a FORALL statement to bulk-bind a host input array. In the FORALL statement, the DELETE statement refers to four host variables: scalars lower, upper, and emp_id and array depts.

 

Example 12-28 Anonymous Block Bulk-Binds Input Host Array

BEGIN

  FORALL i IN :lower..:upper

    DELETE FROM employees WHERE department_id = :depts(i);

END;

/

 

. 小结

       在第一节讲了Bulk的原理,第二节举了Bulk的例子。 在这里做一个简单的回顾,到底什么是bulk.

 

       One method of fetching data is an Oracle bulk collect. With Oracle bulk collect, the PL/SQL engine tells the SQL engine to collect many rows at once and place them in a collection. During an Oracle bulk collect, the SQL engine retrieves all the rows and loads them into the collection and switches back to the PL/SQL engine. When rows are retrieved using Oracle bulk collect, they are retrieved with only 2 context switches. The larger the number of rows you would like to collect with Oracle bulk collect, the more performance improvement you will see using an Oracle bulk collect.

       Starting in Oracle10g, an Oracle bulk collect may be performed by the the PL/SQL engine for you. The PL/SQL engine may automatically use Oracle bulk collect to collect 100 rows at a time because of a cursor loop. This use of Oracle bulk collect allows your code to process rows without having to setup and execute the Oracle bulk collect operation. The result of this use of Oracle bulk collect is that bulk collecting 75 rows may not provide you with much of a benefit, but using Oracle bulk collect to collect large numbers of rows (many hundreds) will provid increased performance.

 

       Oracle 2个引擎来执行PL/SQL blocks subprograms那么在执行的时候,PL/SQL 引擎把DML 语句发送给SQL 引擎,然后由SQL 引擎执行,执行完毕后,SQL 引擎把结果集在发送给PL/SQL 引擎。

 

       这个是一条语句的执行过程,如果我们有一个大事务,比如insert 100万的数据,那么这个时候,如果按照原始的方法,每次处理一条,这样在2个引擎之间就会发生大量的context switches,这样就会影响SQL的效率。

       bulk 就是从减少引擎之间context switches的方式来提高sql的效率。 把对SQL 进行打包处理。 2bulk

       1FORALL.  将数据打包,一次性从PL/SQL 引擎发送给SQL 引擎。

如:

BEGIN

  FORALL j IN 1..10

    DELETE FROM employees_temp WHERE department_id = depts(j);

END;

       如果这里用for ..loop 循环,那么会发送10次,而用Forall,一次行全部发送过去。

      

       2bulk collect: 将处理之后的结果集放到bulk collect里,然后一次性把bulk collectSQL 引擎发送给PL/SQL 引擎。   这个bulk collect 需要我们先定义好才能使用。

 

       通过以上说明可以看出,如果使用bulk,那么只有2context switches,当要处理的数据量越大,使用bulk 和不使用bulk 性能区别就越明显。

 

 

 

 

-------------------------------------------------------------------------------------------------------

Blog http://blog.csdn.net/tianlesoftware

Email: dvd.dba@gmail.com

DBA1 群:62697716();   DBA2 群:62697977()   DBA3 群:62697850()  

DBA 超级群:63306533();  DBA4 群: 83829929  DBA5群: 142216823   

DBA6 群:158654907  聊天 群:40132017   聊天2群:69087192

--加群需要在备注说明Oracle表空间和数据文件的关系,否则拒绝申请

posted on 2011-06-30 23:10  springside例子  阅读(1343)  评论(0编辑  收藏  举报