pl/sql錯誤處理貼 )

PL/SQL處理異常不同於其他程式語言的錯誤管理方法，PL/SQL的異常處理機制與ADA很相似，有一個處理錯誤的全包含方法。當發生錯誤時，程式無條件轉到異常處理部分，這就要求代碼要非常乾淨並把錯誤處理部分和程式的其它部分分開。oracle允許聲明其他異常條件類型以擴充錯誤/異常處理。這種擴充使PL/SQL的異常處理非常靈活。

　　當一個執行階段錯誤發生時，稱為一個異常被拋出。PL/SQL程式編譯時間的錯誤不是能被處理得異常，只有在運行時的異常能被處理。在PL/SQL程式設計中異常的拋出和處理是非常重要的內容。
拋出異常

　　由三種方式拋出異常

　　　. 通過PL/SQL運行時引擎

　　　. 使用RAISE語句

　　　. 調用RAISE_APPLICATION_ERROR預存程序

　　當資料庫或PL/SQL在運行時發生錯誤時，一個異常被PL/SQL運行時引擎自動拋出。異常也可以通過RAISE語句拋出

　　RAISE exception_name;

　　顯式拋出異常是程式員處理聲明的異常的習慣用法，但RAISE不限於聲明了的異常，它可以拋出任何任何異常。例如，你希望用TIMEOUT_ON_RESOURCE錯誤偵測新的運行時異常處理器，你只需簡單的在程式中使用下面的語句：

　　RAISE TIMEOUT_ON_RESOUCE;

　　下面看一個訂單輸入系統，當庫存小於訂單時拋出一個inventory_too_low異常。

DECLARE
inventory_too_low EXCEPTION;
---其他聲明語句
BEGIN
.
.
IF order_rec.qty>inventory_rec.qty THEN
RAISE inventory_too_low;
END IF
.
.
EXCEPTION
WHEN inventory_too_low THEN
order_rec.staus:='backordered';
replenish_inventory(inventory_nbr=>
inventory_rec.sku,min_amount=>order_rec.qty-inventory_rec.qty);
END;
 

　　這裡replenish_inventory是一個觸發器。
　
　　處理異常

　　PL/SQL程式塊的異常部分包含了程式處理錯誤的代碼，當異常被拋出時，一個異常陷阱就自動發生，程式控制離開執行部分轉入異常部分,一旦程式進入異常部分就不能再回到同一塊的執行部分。下面是異常部分的一般文法：

EXCEPTION
　WHEN exception_name THEN
　　Code for handing exception_name
　[WHEN another_exception THEN
　　Code for handing another_exception]
　[WHEN others THEN
　　code for handing any other exception.]
 

　　使用者必須在獨立的WHEN子串中為每個異常設計異常處理代碼，WHEN OTHERS子串必須放置在最後面作為預設處理器處理沒有顯式處理的異常。當異常發生時，控制轉到異常部分，ORACLE尋找當前異常相應的WHEN..THEN語句，捕捉異常，THEN之後的代碼被執行，如果錯誤陷阱代碼只是退出相應的嵌套塊，那麼程式將繼續執行內部塊END後面的語句。如果沒有找到相應的異常陷阱，那麼將執行WHEN OTHERS。在異常部分WHEN 子串沒有數量限制。

EXCEPTION

　WHEN inventory_too_low THEN
　　order_rec.staus:='backordered';
　　replenish_inventory(inventory_nbr=>
　　inventory_rec.sku,min_amount=>order_rec.qty-inventory_rec.qty);
　WHEN discontinued_item THEN
　　--code for discontinued_item processing
　WHEN zero_divide THEN
　　--code for zero_divide
　WHEN OTHERS THEN
　　--code for any other exception
END;
 

　　當異常拋出後，控制無條件轉到異常部分，這就意味著控制不能回到異常發生的位置，當異常被處理和解決後，控制返回到上一層執行部分的下一條語句。

BEGIN
　DECLARE
　　bad_credit;
　BEGIN
　　RAISE bad_credit;
　　　--發生異常，控制轉向；
　EXCEPTION
　　WHEN bad_credit THEN
　　　dbms_output.put_line('bad_credit');
　　END;

　　--bad_credit異常處理後，控制轉到這裡
　EXCEPTION
　　WHEN OTHERS THEN
　　　--控制不會從bad_credit異常轉到這裡
　　　--因為bad_credit已被處理
END;

　　當異常發生時，在塊的內部沒有該異常處理器時，控制將轉到或傳播到上一層塊的異常處理部分。

BEGIN
　DECLARE ---內部塊開始
　　bad_credit;
　BEGIN
　　RAISE bad_credit;
　　　--發生異常，控制轉向；
　　EXCEPTION
　　WHEN ZERO_DIVIDE THEN --不能處理bad_credite異常
　　　dbms_output.put_line('divide by zero error');
　　END --結束內部塊

　　　--控制不能到達這裡，因為異常沒有解決；
　　　--異常部分

　　EXCEPTION
　　WHEN OTHERS THEN
　　　--由於bad_credit沒有解決，控制將轉到這裡
END;

　　異常傳播

　　沒有處理的異常將沿檢測異常調用程式傳播到外面，當異常被處理並解決或到達程式最外層傳播停止。
在聲明部分拋出的異常將控制轉到上一層的異常部分。

BEGIN
executable statements
BEGIN
today DATE:='SYADATE'; --ERRROR
BEGIN --內部塊開始
dbms_output.put_line('this line will not execute');
EXCEPTION
WHEN OTHERS THEN
--異常不會在這裡處理
END;--內部塊結束

EXCEPTION
WHEN OTHERS THEN
處理異常
END

　　執行部分拋出的異常將首先傳遞到同一塊的異常部分，如果在同一塊的異常部分沒有處理這個異常的處理器，那麼異常將會傳播到上一層的異常部分中，一直到最外層。

　　在異常部分拋出的異常將控制轉到上一層的異常部分。

　　處理異常將停止異常的傳播和解決。有時使用者希望在錯誤發生時，程式仍然能執行一些動作，要達到這個目的，可以把希望執行的動作放在異常處理器中，然後執行不帶參數的RAISE語句，RAISE語句將重新拋出出現的異常，允許他繼續傳播。

DECLARE
order_too_old EXCEPTION;
BEGIN
RAISE order_too_old;
EXCEPTION
WHEN order_too_old THEN
DECLARE
file_handle UTL_FILE.FILE_TYPE;
BEGIN
--open file
file_handle:=UTL_FILE.FOPEN
(location=>'/ora01/app/oracle/admin/test/utlsir'
,filename=>'error.log'
.open_mode=>'W');
--write error stack
UTL_FILE.PUT_LINE(filehandle,
DBMS_UTILITY.FORMAT_ERROR_STACK);
--write the call stack
UTL_FILE.PUT_LINE(filehandle,
DBMS_UTILITY.FORMAT_CALL_STACK);
--close error log
UTL_FILE.FCLOSE(file_handle);
RAISE; --re-raise the exception
END
END

　　如果從FORMAT_XXX_STACK輸出一個很大的值，那麼使用DBMS_OUTPUT或UTL_FILE顯示錯誤或調用堆的異常部分自身也會拋出異常，這兩個堆常規下最多能返回2000位元組，但utl_file.put_line被限制在1000位元組以內，而dbms_output.put_line限制在512位元組內。如果使用前面的代碼並且不允許這種可能性，那麼在異常處理器中將拋出一個未處理的異常。

　　GOTO語句不能用於將控制從執行部分傳遞到異常部分或反之。

　　已命名異常

　　在PL/SQL塊的異常部分只有已命名的異常才能被WHEN子串處理，ORACLE包含了一系列已命名的異常，這些異常都聲明在STANDARD包中，這些內建異常在這裡就不一一講述，有興趣的讀者可以查閱有關資料。
常用異常處理方法

　　除了標準異常外，使用者可以聲明自己的已命名異常。比如商業規則錯誤，或者將自訂異常與一個資料庫號相聯絡，甚至可以將資料庫錯誤號碼賦予自訂異常。PL/SQL的這個效能極大的提高了對異常的管理和處理的能力。

　　聲明自己的異常　

　　如果你希望聲明自己的異常，那麼你可以在異常處理器中包括WHEN子句，聲明的異常的作用範圍與聲明的變數相同。聲明在外層塊的異常能被該塊和它的子塊訪問，但聲明在子塊的異常不能被父塊處理。
　
　　例：

　BEGIN
DECLARE
Insufficient_credite EXCEPTION;
BEGIN
RASISE Insufficient_credite;
EXCEPTION
WHEN Insufficient_credite THEN
--可以在此處理異常
　　　extend_credite(cust_id);
END　-嵌套塊結束
EXCEPTION
WHEN Insufficient_credite THEN
--超出範圍，不能在這裡處理異常
　END;

　　如果聲明的異常與內建的異常同名，那麼當引用異常將解決你的異常而不是內建的異常。

　　給資料庫錯誤命名

　　如果希望處理一個異常，那麼異常必須有一個名字，資料庫錯誤有數千個，但是只有不到25個是內建的已命名異常，但需要處理這些未命名的異常時，你可以將一個名字和一個錯誤號碼聯絡在一起，達到這個目的的語句是：PRAGMA EXCEPTION_INIT語句

　　文法如下：

　　PRAGMA EXCEPTION_INIT(exception_name，error_number);

　　執行這個語句之前，必須首先聲明異常名。

DECLARE
invald_table_name EXCEPTION;
PRAGMA EXCEPTION_INIT(invald_table_name,-942);
BEGIN

EXCEPTION
WHEN invald_table_name THEN
UTL_FILE.PUT_LINE(file_handle,'user' || UID || 'hit a bad table');
END;

　　另外一種處理資料庫錯誤的方法是使用內建函數SQLCODE和SQLERRM，這兩個函數在包一級聲明，SQLCODE將返回現行資料庫錯誤號碼，這些錯誤號碼中除了NO_DATA_FOUND是+100外其他都是負數。SQLERRM返迴文本描述的錯誤資訊。為了獲得使用者自訂異常返回的SQLERRM和SQLCODE，你需要使用RAISE_APPLICATION_ERROR函數給自訂異常標註錯誤號碼。

　　給自訂錯誤標註號碼

　　RAISE_APPLICATION_ERROR內建函數用於拋出一個異常並給異常賦予一個錯誤號碼以及錯誤資訊。自訂異常的預設錯誤號碼是+1,預設資訊是User_Defined_Exception。來自未處理的異常的一般資訊對於識別導致錯誤的原因沒有協助，RAISE_APPLICATION_ERROR函數能夠在pl/sql程式塊的執行部分和異常部分調用，顯式拋出帶特殊錯誤號碼的命名異常。

RAISE_APPLICATION_ERROR(error_name,error_message[,{TRUE|| FALSE}]);

　　錯誤號碼的範圍是-20,999到-20,999。錯誤資訊是文本字串，最多為2048位元組。TRUE和FALSE表示是添加(TRUE)進錯誤堆(ERROR STACK)還是覆蓋(overwrite)錯誤堆(FALSE)。預設情況下是FALSE。

IF product_not_found THEN
　　RAISE_APPLICATION_ERROR(-20123,'Invald product code' TRUE);
END IF;