模擬指令碼元件的錯誤輸出

發行項
05/04/2023

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

雖然您無法在指令碼元件中將輸出直接設定為錯誤輸出，以自動處理錯誤資料列，不過可以建立其他輸出並使用指令碼中的條件式邏輯，適時地將資料列導向此輸出，以重新產生內建錯誤輸出的功能。您可能會想要加入兩個額外的輸出資料行，以接收發生錯誤的資料行之錯誤碼與識別碼，來模擬內建錯誤輸出的行為。

如果想要新增對應至特定預先定義之 Integration Services 錯誤碼的錯誤描述，您可以使用 IDTSComponentMetaData100 介面的 GetErrorDescription 方法，這可透過指令碼元件的 ComponentMetaData 屬性取得。

範例

在此所示的範例使用設定成具有兩個同步輸出之轉換的指令碼元件。指令碼元件的目的在於從 AdventureWorks 範例資料庫的地址資料中，篩選出錯誤資料列。這個虛構的範例是假設，我們正在為北美的客戶準備促銷活動，並且需要篩選出不在北美的地址。

若要設定範例

在建立新指令碼元件之前，建立連接管理員並設定資料流程來源，以便從 AdventureWorks 範例資料庫選取地址資料。就這個只查看 CountryRegionName 資料行的範例而言，您可以直接使用 Person.vStateCountryProvinceRegion 檢視，或是聯結 Person.Address、Person.StateProvince 和 Person.CountryRegion 資料表以選取資料。
將新指令碼元件加入資料流程設計師介面，並將它設定為轉換。開啟指令碼轉換編輯器。
在 [指令碼] 頁面上，將 ScriptLanguage 屬性設定成您要用以撰寫指令碼的指令碼語言。
按一下 [編輯指令碼] 以開啟 Microsoft Visual Studio Tools for Applications (VSTA)。
在 Input0_ProcessInputRow 方法中，鍵入或貼上下列範例程式碼。
關閉 VSTA。
在 [輸入資料行] 頁面上，選取您要在指令碼轉換中處理的資料行。此範例只使用 CountryRegionName 資料行。您保留未選取的可用輸入資料行，將會在資料流程中傳遞時保持不變。
在 [輸入及輸出] 頁面上，新增新的第二個輸出，並將其 SynchronousInputID 值設定為輸入的識別碼，這也是預設輸出的 SynchronousInputID 屬性值。將兩個輸出的 ExclusionGroup 屬性設定為相同的非零值 (例如 1)，以指出將每個資料列導向僅兩個輸出的其中一個。提供特殊的名稱給新錯誤輸出，例如 "MyErrorOutput"。
將額外輸出資料行加入新錯誤輸出，以擷取所需的錯誤資訊，這可能包含發生錯誤的資料行之錯誤碼與識別碼，以及或許還有錯誤描述。此範例會建立新資料行 ErrorColumn 與 ErrorMessage。如要擷取自己實作中的預先定義 Integration Services 錯誤，請務必新增錯誤號碼的 ErrorCode 資料行。
請記下指令碼元件將檢查錯誤條件之輸入資料行的識別碼值。這個範例使用此資料行識別碼以擴展 ErrorColumn 值。
關閉指令碼轉換編輯器。
將指令碼元件的輸出附加至適當的目的地。一般檔案目的地對於特定測試而言是最容易設定的。
執行封裝。

Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer)  
  
  If Row.CountryRegionName <> "Canada" _  
      And Row.CountryRegionName <> "United States" Then  
  
    Row.ErrorColumn = 68 ' ID of CountryRegionName column  
    Row.ErrorMessage = "Address is not in North America."  
    Row.DirectRowToMyErrorOutput()  
  
  Else  
  
    Row.DirectRowToOutput0()  
  
  End If  
  
End Sub

public override void Input0_ProcessInputRow(Input0Buffer Row)  
{  
  
  if (Row.CountryRegionName!="Canada"&&Row.CountryRegionName!="United States")  
  
  {  
    Row.ErrorColumn = 68; // ID of CountryRegionName column  
    Row.ErrorMessage = "Address is not in North America.";  
    Row.DirectRowToMyErrorOutput();  
  
  }  
  else  
  {  
  
    Row.DirectRowToOutput0();  
  
  }  
  
}

另請參閱

資料中的錯誤處理
 使用資料流程元件中的錯誤輸出
 使用指令碼元件建立同步轉換

模擬指令碼元件的錯誤輸出

範例

若要設定範例

另請參閱

意見反應

意見反應

其他資源