錯誤傳回運算質

 

使用 錯誤傳回 運算質 () Icon that represents the Error Return functoid. 擷取執行時間期間發生的錯誤資訊,例如資料庫連線失敗。

輸入

參數 1:資料庫查閱運算質的連結。

輸出

輸出 1: 如果使用運算質時,Open Database Connectivity (ODBC) 傳回的錯誤字串。

備註

將此運算質與 資料庫查閱值擷取器 運算質搭配使用,以擷取和對應錯誤資訊。 這在以下的一些情況下可能會非常有用:

  • 當對應具有 資料庫查閱值擷取器 運算質未如預期般運作時。 若要查看錯誤訊息,請暫時將運算質對應至輸出結構描述中的欄位。

  • 如果在資料庫作業失敗時,您的應用程式預期不同的訊息內容。 您可以使用 Error Return 運算質來偵測錯誤,並將錯誤訊息對應至替代結構,讓下游應用程式能夠以受控制的方式回應。

若要避免只在執行時間偵測到的錯誤,請確定 Error Return 運算質的參數 1 是 資料庫查閱 運算質的輸出,而不是 Database 類別中任何其他運算質的輸出。

範例

在下列對應中, 資料庫查閱 運算質是用來根據名字來擷取人員姓氏。 如果沒有發生錯誤且姓氏存在, 則 Value Extractor 運算質會將它複製到目的地架構。 查詢期間 資料庫查閱 運算質擲回的任何錯誤,都會被 Error Return 運算質攔截,並複製到目的地架構中的錯誤訊息欄位。

Map illustrating error return functoid
錯誤傳回範例對應

用以下所示的無效資料表來測試、設定「資料庫尋查」運算質。

DB Lookup functoid with invalid table name
用於資料庫尋查運算質的無效資料表名稱

Input[1] 的值是 “Provider=SQLNCLI10;Server=localhost;Database=Contoso; Trusted_Connection=yes;

如果尋查資料表名稱不正確,輸出的訊息便會與以下相似。 如果 “authors” 是無效的資料表名稱,則會出現錯誤訊息 (此錯誤訊息會儲存在 “ErrorMessage” 節點中)。

<ns0:SampleSource xmlns:ns0="http://Sample">  
    <Person>  
        <FirstName>FirstName_0</FirstName>  
        <LastName />  
        <ErrorMessage>Invalid object name 'authors'.</ErrorMessage>  
    </Person>  
</ns0:SampleSource>  

這是錯誤訊息的範例之一。 有許多不同類型的可能錯誤訊息,包括連線失敗、預存程序問題、環境問題、SQL 例外狀況等等。下游處理序可以監視 ErrorMessage 欄位,並且適當地處理或傳閱訊息。

另請參閱

資料庫運算質參考
資料庫運算質
如何新增基本運算質至對應