DBMS_SQL包使用

DBMS_SQL package 学习

 这个包提供了一种使用动态sql来访问数据库的方法。

第一步：打开游标

使用函数 function open_cursor return integer;

定义变量 Cur_1 integer; --返回的新游标的ID值

语句是Cur_1 := Dbms_Sql.Open_Cursor;

第二步：解析要执行的语句

使用过程procedure parse(c in integer, statement in varchar2,                  language_flag in integer);

语句是Dbms_Sql.Parse(Cur_1, ’sql语句’, Dbms_Sql.V7);

第三步：定义字段变量，其值对应于指定游标中某个位置元素的值（仅用于SELECT语句）

使用过程procedure define_column(c in integer, position in integer, column in number);

语句是Dbms_Sql.Define_Column(Cur_1, 1, column);

定义第一列为column，可重复定义多个列；

第四步：执行指定游标

使用过程function execute(c in integer) return integer;--返回行数

语句是Rows_1 := Dbms_Sql.EXECUTE(Cur_1);

第五步：从指定的游标中取出记录

使用过程function fetch_rows(c in integer) return integer;--返回行数

采用If Dbms_Sql.Fetch_Rows(Cur_1) > 0 then 判断是否取到数据了

然后返回游标中指定位置的元素，使用过程procedure column_value(c in integer, position in integer, value out number);

语句是Dbms_Sql.Column_Value(Cur_1, 1, column);

把游标中的第一列的值赋值给column，可重复赋值多个列；

要加上end if；

最后关闭游标

语句是Dbms_Sql.Close_Cursor(Cur_1);

通常运用DBMS_SQL包一般分为几步：
1. open cursor： 打开cursor
2. parse cursor：解析你要执行的SQL语句
3. bind variable：如果要执行的SQL语句中包含变量，在此就需要绑定变量
4. execute：执行SQL语句
5. close cursor：在执行后关闭此cursor.
如果你还需要返回执行SQL的结果集，还需要使用define_column,define_array等方法。

下面根据不同情况进行详细展示：
在做展示之前，先准备一些基础数据

create table demo (a number,b number,c number);
begin
  for i in 1 .. 15 loop
    insert into demo
    values
      (round(dbms_random.value, 2) * 100,
       round(dbms_random.value, 2) * 100,
       round(dbms_random.value, 2) * 100);
  end loop;
  commit;
end;

 

基础数据完成之后，下面开始对一些具体情况进行分析：
1.执行一般的select语句
   首先先介绍最常用情况：

create or replace procedure define_column(no in number) is
  cursor_name      integer := dbms_sql.open_cursor; --在初始化参数时,就可以打开cursor;
  row_process      integer;
  v_b number;
begin
  --解析要执行的SQL.
  dbms_sql.parse(cursor_name,
                 'select * from demo where a= :no',
                 dbms_sql.native);
  --如果要执行的SQL中不需要参数，则可以省略掉bind_variable--
  dbms_sql.bind_variable(cursor_name, 'no', no);
  /*如果需要返回查询语句的结果,则必须在exec之前使用define_column函数定义返回字段;define_column函数的第一个参数是最初定义的cursor name,第二个参数是指需要返回的字段在查询结果中处于第几列,在此例中返回的字段是查询结果中的第二列,即b列;第三个参数就是接收返回结果需要的变量*/
  dbms_sql.define_column(cursor_name, 2, v_b);
  --必须定义一个参数接收exec的结果
  row_process := dbms_sql.execute(cursor_name);
  loop
    if dbms_sql.fetch_rows(cursor_name) > 0 then
      --将前面定义的字段返回给变量v_b--
      dbms_sql.column_value(cursor_name, 2, v_b);
      dbms_output.put_line('B is ' || v_b);
    else
      exit;
    end if;
  end loop;
  --数据处理完成后记得要将cursor关闭
  dbms_sql.close_cursor(cursor_name);
exception
  when others then
    dbms_sql.close_cursor(cursor_name);
end;

 

2.使用define_array方法得到查询结果
    前面已经分析了如何使用define_column方法得到查询结果，但有时我们想要一次得到多行查询结果，此时我们就需要使用define_array方法，此方法常用于DML操作，稍后会有例子对此介绍，现在先来看一下如果使用define_array.

create or replace procedure define_array is
  c      NUMBER;
  d      NUMBER;
  /*DBMS_SQL.NUMBER_TABLE类型实际就是type NUMBER_TABLE is table of number index by binary_integer;*/
  n_tab  DBMS_SQL.NUMBER_TABLE;
  n_tab1 DBMS_SQL.NUMBER_TABLE;
  indx   NUMBER := 1;
BEGIN
  c := DBMS_SQL.OPEN_CURSOR;
  DBMS_SQL.PARSE(c,
                 'select * from demo where rownum<13 order by 1',
                 DBMS_SQL.NATIVE);
  /*在此需要特别介绍一下define_array函数的第一个参数是已经打开的cursor名称, 第二个参数是指需要返回的字段在查询结果中处于第几列,第三个参数就是接收返回结果需要的变量,与define_column不同的是此变量是table,而不是普通的字段类型;第四个参数表示一次可以返回的行数;第五个参数是指n_tab的index从哪个数值开始,此数值是递增的.在此例中index是从1开始的，一次得到9行结果集，则有n_tab(1)到n_tab(9),如果循环再得到新的结果集,则index继续增长n_tab(10)....*/
  DBMS_SQL.DEFINE_ARRAY(c, 1, n_tab, 9, indx);
  DBMS_SQL.DEFINE_ARRAY(c, 2, n_tab1, 9, indx);
  d := DBMS_SQL.EXECUTE(c);
  loop
    d := DBMS_SQL.FETCH_ROWS(c);
    dbms_output.put_line('fetch rows is ' || d);
    EXIT WHEN d < 9;
    DBMS_SQL.COLUMN_VALUE(c, 1, n_tab);
    DBMS_SQL.COLUMN_VALUE(c, 2, n_tab1);
    for i in 1 .. d loop
      dbms_output.put_line(n_tab(i) || ',' || n_tab1(i));
    end loop;
  END LOOP;
  DBMS_SQL.CLOSE_CURSOR(c);
EXCEPTION
  WHEN OTHERS THEN
    IF DBMS_SQL.IS_OPEN(c) THEN
      DBMS_SQL.CLOSE_CURSOR(c);
    END IF;
END;

 

3.使用variable_value显示DML后的返回结果(单条记录)
   以上我们介绍了如何使用DBMS_SQL包来处理数据查询，如果我们把查询语句更换成DML语句，则可以完成各种DML操作。
  在PL/SQL中我们可以使用returning方法返回DML操作结果，在DBMS_SQL包中可不可以实现呢？答案当然是可以，用variable_value方法就可以实现。下面就分别用两个例子来展示如何实现，一个是返回单条记录，另一个是返回多条记录。

（1）返回单条记录

procedure single_insert(c1 in number, c2 in number, r out number) is

  cursor_name number := dbms_sql.open_cursor;
  n   number;
begin
  dbms_sql.parse(cursor_name,
                 'insert into demo values (:a,:b) returning :a*:b into :r',
                 dbms_sql.native);
  dbms_sql.bind_variable(cursor_name, 'a', c1);
  dbms_sql.bind_variable(cursor_name, 'b', c2);
  dbms_sql.bind_variable(cursor_name, 'r', r);
  n := dbms_sql.execute(cursor_name);
  --使用variable_value函数得到DML操作returning的结果集
  dbms_sql.variable_value(cursor_name, 'r', r);
  dbms_output.put_line(r);
  dbms_sql.close_cursor(cursor_name);
exception
  when others then
    dbms_sql.close_cursor(cursor_name);
end;

 
（2）返回多条记录
结合define_array使用，可以更好的完成DML操作。

create or replace package DBMS_SQL_DEMO as

  procedure multi_insert;

end;
/

create or replace package body DBMS_SQL_DEMO as

  procedure multi_insert_priv(c1 in dbms_sql.Number_Table,
                              c2 in dbms_sql.Number_Table,
                              r  out dbms_sql.Number_Table) is

    cursor_name number := dbms_sql.open_cursor;
    n           number;
  begin
    dbms_sql.parse(cursor_name,
                   'insert into demo values (:a,:b) returning :a*:b into :r',
                   dbms_sql.native);
    --使用bind_array函数将number_table类型的变量赋值给绑定变量
    dbms_sql.bind_array(cursor_name, 'a', c1);
    dbms_sql.bind_array(cursor_name, 'b', c2);
    dbms_sql.bind_array(cursor_name, 'r', r);
    n := dbms_sql.execute(cursor_name);
    --使用variable_value函数将returning的结果集赋值给number_table类型的变量
    dbms_sql.variable_value(cursor_name, 'r', r);
    dbms_sql.close_cursor(cursor_name);
  exception
    when others then
      dbms_sql.close_cursor(cursor_name);
  end;

  procedure multi_insert is
    c1          dbms_sql.Number_Table;
    c2          dbms_sql.Number_Table;
    cursor_name number := dbms_sql.open_cursor;
    n           number;
    r           dbms_sql.Number_Table;
    indx        number := 1;
    d           number;
  begin
    dbms_sql.parse(cursor_name, 'select * from demo', dbms_sql.native);
    dbms_sql.define_array(cursor_name, 1, c1, 5, indx);
    dbms_sql.define_array(cursor_name, 2, c2, 5, indx);
    n := dbms_sql.execute(cursor_name);
    loop
      d := dbms_sql.fetch_rows(cursor_name);
      exit when d = 0;
      dbms_sql.column_value(cursor_name, 1, c1);
      dbms_sql.column_value(cursor_name, 2, c2);
      multi_insert_priv(c1, c2, r);
      for i in 1 .. r.count loop
        dbms_output.put_line(r(i));
      end loop;
    end loop;
  exception
    when others then
      dbms_sql.close_cursor(cursor_name);
  end;

end;
/