oracle系统包—-dbms_output用法

dbms_output包主要用于调试pl/sql程序，或者在sql*plus命令中显示信息(displaying message)和报表，譬如我们可以写一个简单的匿名pl/sql程序块，而该块出于某种目的使用dbms_output包来显示一些信息。

涉及到的知识点如下：
1、enable：在serveroutput on的情况下，用来使dbms_output生效(默认即打开)
2、disable：在serveroutput on的情况下，用来使dbms_output失效
3、put：将内容写到内存，等到put_line时一起输出
4、put_line：不用多说了，输出字符
5、new_line：作为一行的结束，可以理解为写入buffer时的换行符
6、get_line(value, index)：获取缓冲区的单行信息
7、get_lines(array, index)：以数组形式来获取缓冲区的多行信息

需要注意以下几点：
1、set serveroutput on：如果要在sqlplus中看到dbms_output的输出，则必须设置该参数值为on
2、每行能容纳的最大值是32767bytes
3、buffer的默认值是20000bytes，可设置的最小值为2000bytes，最大值为1000000bytes

例子一、put和new_line

1 2 3 4 5 6 7 8 9

set serveroutput on ; begin     dbms_output.put( 'a' ); --写入buffer但不输出     dbms_output.put( 'b' ); --写入buffer但不输出     dbms_output.new_line; --回车(换行)，输出                                  dbms_output.put_line( 'hello world!' ); --输出并换行     dbms_output.put( 'd' ); --写入buffer但不输出 end ;                                                     /

执行运行结果：

1 2	ab hello world!

例子二、put_line

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

set serveroutput off ; create table t(a int , b int , c int ); insert into t values (111111,222222,333333); insert into t values (444444,555555,666666); insert into t values (777777,888888,999999); commit ; create table tt(a int ,b varchar2(100)); declare     msg varchar2(120);                                   cursor t_cur is select * from t order by a;          v_line varchar2(100);                                v_status integer := 0;                           begin                                                dbms_output.enable;                                  for i in t_cur loop                                      msg := i.a || ',' || i.b || ',' || i.c;                  dbms_output.put_line(msg); --put                       end loop;                                                                                              dbms_output.get_line(v_line, v_status); --get              while v_status = 0 loop                                 insert into tt values (v_status, v_line);                dbms_output.get_line(v_line, v_status);              end loop;                                       end ;                                            /                                                              select * from tt;

执行结果如下：

1 2 3 4 5

a    b --- ----------------------- 0   111111,222222,333333 0   444444,555555,666666 0   777777,888888,999999

注：使用get_line时不能用put_line输出，因为put_line之后会将buffer清空。(当然在serveroutput off的情况下put_line是不影响buffer的)。

例子三：put_lines

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

set serveroutput on ; declare     v_data dbms_output.chararr;                              v_numlines number;                                   begin                                                    --enable the buffer first.                              dbms_output.enable(1000000);                                                                                    dbms_output.put_line( 'line one' );                        dbms_output.put_line( 'line two' );                        dbms_output.put_line( 'line three' );                                                                            v_numlines := 3;                                        dbms_output.get_lines(v_data, v_numlines);  --array, index            for v_counter in 1..v_numlines loop                         dbms_output.put_line(v_data(v_counter));                end loop;                                           end ;                                                /

执行结果如下：

1 2 3

line one line two line three

注意数组使用的格式。