傳送錯誤訊息工作

  • 發行項

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

[傳送錯誤訊息] 工作會在 SQL Server 的執行個體之間傳送一或多個 SQL Server 使用者自訂的錯誤訊息。 使用者定義的訊息是識別碼等於或大於 50000 的訊息。 識別碼小於 50000 的訊息是系統錯誤訊息，這種訊息無法使用「傳送錯誤訊息」工作進行傳送。

「傳送錯誤訊息」工作可以設定為傳送所有錯誤訊息，或只傳送指定的錯誤訊息。 使用者自訂的錯誤訊息可能有很多不同的語言版本，您可以設定工作只傳送所選語言的訊息。 在您可以傳送其他語言版本的訊息至目的地伺服器之前，使用字碼頁 1033 的 us_english 版訊息必須存在於該伺服器上。

master 資料庫中的 sysmessages 資料表包含 SQL Server 使用的所有錯誤訊息 (包括系統和使用者定義的訊息)。

要傳送的使用者自訂訊息可能已存在於目的地上。 如果識別碼和語言相同，則會將錯誤訊息定義為重複錯誤訊息。 可以設定「傳送錯誤訊息」工作以下列方式處理現有的錯誤訊息：

  • 覆寫現有的錯誤訊息。

  • 存在重複的訊息時讓工作失敗。

  • 略過重複的錯誤訊息。

在執行階段，「傳送錯誤訊息」工作會使用一或多個 SMO 連接管理員，連接到來源和目的地伺服器。 SMO 連接管理員會在「傳送錯誤訊息」工作以外另行設定，然後在「傳送錯誤訊息」工作中參考。 存取伺服器時，SMO 連接管理員會指定要使用的伺服器和驗證模式。 如需詳細資訊，請參閱 SMO Connection Manager。

[傳送錯誤訊息] 工作支援 SQL Server 來源和目的地。 將哪一個用作來源或目的地是沒有限制的。

事件

「傳送錯誤訊息」工作會引發報告已傳送錯誤訊息數目的資訊事件。

該工作並不報告錯誤訊息傳送的累加進度，它只報告 0% 和 100 % 完成。

執行值

工作之 ExecutionValue 屬性中定義的執行值會傳回已傳送的錯誤訊息數目。 透過將使用者定義的變數指派給 [傳送錯誤訊息] 工作的 ExecValueVariable 屬性，可將與錯誤訊息傳送相關的資訊用於封裝中的其他物件。 如需詳細資訊，請參閱 Integration Services (SSIS) 變數和在封裝中使用變數。

記錄項目

「傳送錯誤訊息」工作包含下列自訂記錄項目：

  • TransferErrorMessagesTaskStartTransferringObjects 此記錄項目報告傳送已開始。 記錄項目會包含開始時間。

  • TransferErrorMessagesTaskFinishedTransferringObjects 此記錄項目報告傳送已完成。 記錄項目會包含結束時間。

此外， OnInformation 事件的記錄項目會報告已傳送的錯誤訊息，並會為在目的地上覆寫的每個錯誤訊息，寫入 [OnWarning 事件] 的記錄項目。

安全性和權限

若要建立新的錯誤訊息，執行封裝的使用者必須是目的地伺服器上 sysadmin 或 serveradmin 伺服器角色的成員。

傳送錯誤訊息工作的組態

您可以透過 SSIS 設計師或以程式設計方式設定屬性。

如需可在 SSIS 設計工具中設定的屬性的詳細資訊，請按下列主題：

如需有關如何以程式設計方式設定這些屬性的詳細資訊，請按以下主題：

如需如何在 SSIS 設計工具中設定這些屬性的詳細資訊，請按下列主題：

傳送錯誤訊息工作編輯器 (一般頁面)

使用 [傳送錯誤訊息工作編輯器] 對話方塊的 [一般] 頁面，即可命名和描述傳送錯誤訊息工作。 [傳送錯誤訊息] 工作會在 SQL Server 的執行個體之間傳送一或多個 SQL Server 使用者自訂的錯誤訊息。

選項。

名稱
輸入傳送錯誤訊息工作的唯一名稱。 這個名稱是作為工作圖示中的標籤使用。

注意

工作名稱在封裝內必須是唯一的。

說明
輸入傳送錯誤訊息工作的描述。

傳送錯誤訊息工作編輯器 (訊息頁面)

使用 [傳送錯誤訊息工作編輯器] 對話方塊的 [訊息] 頁面，即可指定屬性用來將一或多個 SQL Server 使用者自訂錯誤訊息，從 SQL Server 的一個執行個體複製到另一個。

選項。

SourceConnection
在清單中選取 SMO 連線管理員，或按一下 [新增連接...]<>，以建立與來源伺服器的新連線。

DestinationConnection
在清單中選取一個 SMO 連線管理員，或按一下 [新增連接...]<>，以建立與目的地伺服器的新連線。

IfObjectExists
如果有相同名稱的錯誤訊息已存在於目的地伺服器上，選取工作應覆寫現有使用者自訂錯誤訊息、略過現有訊息，或是失敗。

TransferAllErrorMessages
選取工作應將所有的訊息或只有指定的使用者自訂訊息，從來源伺服器複製到目的地伺服器。

此屬性具有下表所列的選項：

值 描述
True 複製所有的使用者自訂訊息。
False 只複製指定的使用者自訂訊息。

ErrorMessagesList
按一下瀏覽按鈕 (...) 來選取要複製的錯誤訊息。

注意

您必須先指定 [SourceConnection] ，才能選取要複製的錯誤訊息。

ErrorMessageLanguagesList
按一下瀏覽按鈕 (...) ，來選取將使用者定義之錯誤訊息複製到目的地伺服器所用的語言。 在您可以傳送其他語言版本的訊息至目的地伺服器之前，us_english (字碼頁 1033) 版的訊息必須存在於該伺服器上。

注意

您必須先指定 [SourceConnection] ，才能選取要複製的錯誤訊息。

另請參閱

Integration Services 工作
控制流程