錯誤傳回運算質

 

使用 錯誤傳回 運算質 ( 。) 擷取執行時間期間發生的錯誤資訊，例如資料庫連線失敗。

輸入

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

輸出

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

備註

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

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

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

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

範例

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

錯誤傳回範例對應

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

用於資料庫尋查運算質的無效資料表名稱

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 欄位，並且適當地處理或傳閱訊息。

另請參閱

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