该包使得我们可以从存储过程、包或触发器中发送信息。
Oracle推荐在调试PL/SQL程序时使用该包,不建议使用它来做报表输出或其他的格式化应用。
启用或禁用DBMS_OUTPUT
默认情况下,Oracle并没有启用DBMS_OUTPUT
包,也就是说,直接使用DBMS_OUTPUT.PUT_LINE
或GET_LINE
来输出或获取消息,是看不到任何输出的。要先使用DBMS_OUTPUT.ENABLE
来启用包的功能。
DBMS_OUTPUT.ENABLE(buffer_size IN INTEGER DEFAULT 20000);
buffer_size
用来指定缓冲区,缓冲区的最大尺寸为1000000字节 ,最小为2000字节,默认为20000字节。
SQL*Plus有一个SET SERVEROUTPUT ON
语句,来启用DBMS_OUTPUT
包,如果执行了该语句,则没有必要使用DBMS_OUTPUT.ENABLE
,因为SET SERVEROUTPUT ON
会自动调用该语句。
禁用DBMS_OUTPUT
只需要调用DBMS_OUTPUT.DISABLE
即可,它同时会清除缓冲区中所有的数据。当执行SET SERVEROUTPUT OFF
时,SQL*Plus也会调用DBMS_OUTPUT.DISABLE
过程。
向缓冲区中提取与写入内容
必须要理解的是,DBMS_OUTPUT
并不是直接将信息输出到屏幕,而是将数据写入到了一个缓冲区中,然后再次将这些输出读回。当在SQL*Plus中使用SET SERVEROUTPUT ON
命令时,实际上是让SQL*Plus在每条DBMS_OUTPUT
之后检查缓冲区中的内容,然后在屏幕上进行显示。
可以使用如下几个过程来向缓冲区中输入消息:
- PUT
:将信息写入缓冲区,不包含换行符。
- PUT_LINE
:将完整的行信息写入缓冲区&