PL/SQL - DBMS Output：初學者的指南

您好，未來的數據庫魔法師們！今天，我們將踏上一段令人興奮的旅程，進入PL/SQL的世界，並探索一個非常有用的工具——DBMS Output。別擔心如果您之前從未寫過一行代碼——我將成為您的友好導遊，我們會一步步來。在這個教程結束時，您將能夠像專業人士一樣輸出信息！

PL/SQL - DBMS Output

DBMS Output是什麼？

在我們深入細節之前，讓我們先了解DBMS Output到底是什麼。想像一下您正在烹飪一道複雜的菜譜。如果您的烤箱能告訴您裡面發生了什麼，豈不是很有幫助？DBMS Output對您的PL/SQL代碼 precisely就是這樣的作用！

DBMS Output是PL/SQL中的一個包，它允許您將信息打印到緩存中，然後您可以查看這些信息。這就像有一個小筆記本，您的程序可以在上面為您記筆記。這對於調試代碼和理解程序執行不同階段的情況非常有用。

開始使用DBMS Output

要使用DBMS Output，我們需要做兩件事：

啟用DBMS Output緩存
使用PUT_LINE過程寫入信息

讓我們看一個簡單的例子：

BEGIN
DBMS_OUTPUT.PUT_LINE('Hello, World!');
END;
/

如果您運行這段代碼，您可能會驚訝地發現......什麼都沒有！這是因為我們還沒有啟用DBMS Output緩存。讓我們來修正這個問題：

SET SERVEROUTPUT ON;

BEGIN
DBMS_OUTPUT.PUT_LINE('Hello, World!');
END;
/

現在您應該會看到：

Hello, World!

恭喜您！您剛才寫了您的第一個帶有輸出的PL/SQL程序。讓我們分解一下發生了什麼：

SET SERVEROUTPUT ON; 啟用了DBMS Output緩存。
BEGIN 和 END; 標記了我們PL/SQL塊的開始和結束。
DBMS_OUTPUT.PUT_LINE('Hello, World!'); 是實際打印我們信息的命令。
頂部的 / 告訴SQL*Plus執行PL/SQL塊。

DBMS_OUTPUT子程序

現在我們已經濕了腳，讓我們來探索DBMS_OUTPUT包中可用的不同子程序（可以將它們視為工具）。這裡有一個總結的表格：

子程序	描述
PUT	將字符串放入緩存中
PUT_LINE	將一行放入緩存中
NEW_LINE	插入一行斷行
GET_LINE	從緩存中檢索一行
GET_LINES	從緩存中檢索多行
ENABLE	啟用DBMS_OUTPUT包
DISABLE	禁用DBMS_OUTPUT包

讓我們詳細看看這些，並提供示例。

PUT 和 PUT_LINE

PUT過程在不插入行斷行的情況下添加文本到緩存中，而PUT_LINE則添加文本並開始新行。這裡有一個例子：

BEGIN
DBMS_OUTPUT.PUT('Hello');
DBMS_OUTPUT.PUT(' ');
DBMS_OUTPUT.PUT('World');
DBMS_OUTPUT.NEW_LINE;
DBMS_OUTPUT.PUT_LINE('How are you?');
END;
/

輸出：

Hello World
How are you?

在這個例子中，我們使用PUT逐段構建一行，然後使用NEW_LINE開始新行。PUT_LINE會在它的信息後自動開始一行。

NEW_LINE

我們已經看到了NEW_LINE的用法。它簡單但強大——只是在您的輸出中開始一行新行。這裡有另一個例子：

BEGIN
DBMS_OUTPUT.PUT_LINE('Line 1');
DBMS_OUTPUT.NEW_LINE;
DBMS_OUTPUT.PUT_LINE('Line 3');
END;
/

輸出：

Line 1

Line 3

注意到"Line 1"和"Line 3"之間的空行了嗎？那就是我們的NEW_LINE在起作用！

GET_LINE 和 GET_LINES

這些過程有些不同——它們用於從緩存中檢索輸出。當您從其他編程語言調用PL/SQL並希望捕獲輸出時，這特別有用。

這裡有一個GET_LINE的簡單例子：

DECLARE
v_line VARCHAR2(255);
v_status INTEGER;
BEGIN
DBMS_OUTPUT.PUT_LINE('This is a test');
DBMS_OUTPUT.GET_LINE(v_line, v_status);
IF v_status = 0 THEN
DBMS_OUTPUT.PUT_LINE('Retrieved: ' || v_line);
ELSE
DBMS_OUTPUT.PUT_LINE('No more lines');
END IF;
END;
/

在這個例子中，我們將一行放入緩存中，然後立即使用GET_LINE檢索它。變量v_status告訴我們我們是否成功地檢索了一行（0）或是否有更多行要檢索（1）。

ENABLE 和 DISABLE

這些過程讓您可以編程地開啟和關閉DBMS_OUTPUT。這裡是如何使用它們的例子：

BEGIN
DBMS_OUTPUT.DISABLE;
DBMS_OUTPUT.PUT_LINE('You won''t see this');
DBMS_OUTPUT.ENABLE;
DBMS_OUTPUT.PUT_LINE('But you will see this!');
END;
/

輸出：

But you will see this!

如您所見，第一個PUT_LINE沒有產生任何輸出，因為我們禁用了DBMS_OUTPUT。在我們重新啟用它之後，我們可以正常看到輸出。

結論

好了，各位！我們已經穿越了DBMS Output的土地，從其基本用法到其各種子程序。記住，DBMS Output是您程序的声音——使用它來理解您的代碼中發生了什麼，調試問題，並慶祝您的成功。

隨著您繼續您的PL/SQL冒險，您會發現DBMS Output是您開發工具包中一個無價的工具。它簡單，它強大，現在它是您的了！

繼續練習，保持好奇心，並且快樂編程！

Credits: Image by storyset