dbms_output的简介

dbms_output的简介

Oracle推荐在debug PL/SQL程序时使用该程序包，不推荐使用该包来做报表输出或其他格式化输出之用。
概述
DBMS_OUTPUT包主要用于调试PL/SQL程序，或者在SQL*PLUS命令中显示信息(displaying message)和报表，譬如我们可以写一个简单的匿名PL/SQL程序块，而该块出于某种目的使用DBMS_OUTPUT包来显示一些信息。
在该DBMS_OUTPUT包中存在2个存储过程，它们是PUT_LINE和PUT过程，使用这2个Procedure可以做到将信息存放到PL/SQL的Buffer中，以便其他的触发器、存储过程、程序包来读取。在独立的PL/SQL程序或匿名块中，我们还可以使用GET_LINES和GET这2个存储过程来将存放在PL/SQL Buffer中的信息输出(display)到屏幕。
DBMS_OUTPUT包子程序摘要 　　DISABLE存储过程 禁用消息输出 ENABLE 存储过程 启用消息输出 GET_LINE 存储过程 从buffer中获取单行信息 GET_LINES 存储过程 从buffer中获取信息数组 NEW_LINE 存储过程 终结有PUT过程所创建的一行 PUT 存储过程 将一行信息放到buffer中 PUT_LINE 存储过程 将部分行信息放到buffer中 注意目前PUT过程已废弃，因为遗留问题将被保留，但不在推荐使用。
DISABLE存储过程
该存储过程用以禁用对PUT, PUT_LINE, NEW_LINE, GET_LINE, and GET_LINES过程的调用，并会清理buffer中任何残存信息。
与之相反的是ENABLE存储过程，若在SQL*PLUS中使用SERVEROUTPUT选项则不需要调用该存储过程。

语法
DBMS_OUTPUT.DISABLE;

编译器指示
pragma restrict_references(disable,WNDS,RNDS);

ENABLE存储过程
该存储过程用以启用对PUT, PUT_LINE, NEW_LINE, GET_LINE, and GET_LINES存储过程的调用。

语法
DBMS_OUTPUT.ENABLE (
buffer_size IN INTEGER DEFAULT 20000);

编译指示
pragma restrict_references(enable,WNDS,RNDS);

参量 　　buffer_size Buffer长度的上限，单位为bytes字节。将buffer_size设置为NULL即指定没有限制
使用注意事项
当在SQL*PLUS总使用 SET SERVEROUTPUT选项时没有必要使用该过程若有多次对ENABLE过程的调用，那么buffer_size以最后指定的为准。当用户没有指定buffer size为NULL时，该参量的上限为1,000,000字节，而下限为2,000一般建议buffer size设置为NULL，10g中默认值使用20000以便兼容老的数据库版本。
GET_LINE 存储过程
该过程用以从buffer中获取单行信息。

语法
DBMS_OUTPUT.GET_LINE (
line OUT VARCHAR2,
status OUT INTEGER);

参量 　　line 将返回buffer中的一行信息，但不包括最后的换行符。一般建议申明该参数为VARCHAr2(32767)类型，以避免出现ORA-06502: PL/SQL: numeric or value error: character string buffer too small”.错误 status 若调用成功则返回0，若buffer中没有更多行的信息则返回1
使用注意事项
可以选择是从buffer中获取单行还是多行的数组信息。使用GET_LINE过程可以获取单行信息。从性能考虑，应当减少调用次数，使用GET_LINES函数直接从buffer中返回一个多行的数组若在使用SQL*PLUS则可以设置SET SERVEROUTPUT选项控制是否直接输出到屏幕在调用GET_LINE或GET_LINES后，任何行信息在下一次的PUT, PUT_LINE, or NEW_LINE前没有被获取的都将被丢弃，以避免误会
GET_LINES 存储过程
该存储过程用以从Buffer中获取一个多行的的数组

语法
DBMS_OUTPUT.GET_LINES (
lines OUT CHARARR,
numlines IN OUT INTEGER);
DBMS_OUTPUT.GET_LINES (
lines OUT DBMSOUTPUT_LINESARRAY,
numlines IN OUT INTEGER);

参量 　　lines 返回Buffer中多行信息的数组。该数组中每行的最大长度为32767bytes。 numlines 想要获取行的数量。在成功获取多行信息后，该过程将返回实际获取的行数。若返回的数字小于要求的值时，说明buffer中没有更多行的信息了。
使用注意事项：
可以选择是从buffer中获取单行还是多行的数组信息。使用GET_LINE过程可以获取单行信息。从性能考虑，应当减少调用次数，使用GET_LINES函数直接从buffer中返回一个多行的数组若在使用SQL*PLUS则可以设置SET SERVEROUTPUT选项控制是否直接输出到屏幕在调用GET_LINE或GET_LINES后，任何行信息在下一次的PUT, PUT_LINE, or NEW_LINE前没有被获取的都将被丢弃，以避免误会