Integration Services (SSIS) 記錄

SQL Server Integration Services 包括可用於在封裝、容器和工作中實作記錄的記錄提供者。 使用記錄，可以擷取有關封裝的執行階段資訊，藉此幫助您在每次執行封裝時對其進行稽核和疑難排解。 例如，記錄可以擷取執行封裝之操作員的名稱，以及封裝開始和結束的時間。

您可以設定在 Integration Services 伺服器上的封裝執行期間發生的記錄範圍。 如需詳細資訊，請參閱＜在 SSIS 伺服器上啟用封裝執行的記錄功能＞。

您還可以在使用 dtexec 命令提示公用程式執行封裝時加入記錄功能。 如需有關支援記錄功能之命令提示引數的詳細資訊，請參閱＜dtexec 公用程式＞。

設定 SQL Server Data Tools 中的記錄功能

記錄與封裝相關聯，並在封裝層級設定。 封裝中的每個工作或容器都可將資訊記錄至任何封裝記錄檔中。 您可以啟用封裝中工作和容器的記錄功能，即使該封裝本身未啟用記錄功能。 例如，可以在「執行 SQL」工作上啟用記錄功能，而無需在父封裝上啟用記錄功能。 封裝、容器或工作可以寫入多重記錄檔。 您可以僅在封裝上啟用記錄功能，也可以選擇在封裝所包含的任何個別工作或容器上啟用記錄功能。

當您將記錄加入封裝時，請選擇記錄提供者和記錄的位置。 記錄提供者會指定記錄資料的格式：例如，SQL Server 資料庫或文字檔。

Integration Services 包括下列記錄提供者：

• 「文字檔」記錄提供者，它會將記錄項目以逗號分隔值 (CSV) 的格式寫入 ASCII 文字檔。 此提供者的預設副檔名為 .log。

• SQL Server Profiler 記錄提供者，它可寫入追蹤檔，您可以使用 SQL Server Profiler 檢視該追蹤檔。 此提供者的預設副檔名為 .trc。

  [!附註]

  您無法在以 64 位元模式執行的封裝中使用 SQL Server Profiler 記錄提供者。

• SQL Server 記錄提供者，它可將記錄項目寫入 SQL Server 資料庫的 sysssislog 資料表中。

• 「Windows 事件」記錄提供者，它可將項目寫入本機電腦上之「Windows 事件」記錄的「應用程式」記錄中。

• 「XML 檔案」記錄提供者，它可將記錄檔寫入 XML 檔案中。 此提供者的預設副檔名為 .xml。

如果您將記錄提供者加入封裝或以程式設計的方式設定記錄，則可以使用 ProgID 或 ClassID 來識別記錄提供者，以取代使用 [設定 SSIS 記錄] 對話方塊中所顯示之「SSIS 設計師」的名稱。

下表列出 Integration Services 所包含之記錄提供者的 ProgID 和 ClassID，以及記錄提供者寫入記錄檔的位置。

您還可以建立自訂記錄提供者。 如需詳細資訊，請參閱＜建立自訂記錄提供者＞。

封裝中的記錄提供者是此封裝之記錄提供者集合的成員。 使用「SSIS 設計師」建立封裝並實作記錄時，您可在「SSIS 設計師」的 [封裝總管] 索引標籤上，看到 [記錄提供者] 資料夾中集合成員的清單。

您可以藉由提供記錄提供者的名稱和描述，並指定記錄提供者使用的連接管理員，來設定記錄提供者。 SQL Server 記錄提供者會使用 OLE DB 連接管理員。 「文字檔」、SQL Server Profiler 和「XML 檔案」記錄提供者全都使用「檔案」連接管理員。 Windows 事件記錄檔提供者不使用連接管理員，因為它會直接寫入「Windows 事件記錄檔」中。 如需詳細資訊，請參閱＜OLE DB 連接管理員＞和＜檔案連接管理員＞。

自訂記錄

為了自訂事件或自訂訊息的記錄，Integration Services 提供通常記錄之資訊的結構描述，以用於併入記錄項目。 Integration Services 記錄結構描述會定義可以記錄的資訊。 您可以從記錄結構描述選擇每個記錄項目的元素。

封裝及其容器和工作不一定要記錄相同資訊，相同封裝或容器內的工作也可以記錄不同的資訊。 例如，封裝可以在封裝啟動時記錄操作員資訊，一個工作可以記錄工作失敗的來源，而另一個工作可以在發生錯誤時記錄資訊。 如果封裝及其容器和工作使用多重記錄檔，則相同的資訊會寫入所有記錄檔中。

您可以指定要記錄的事件和每個事件要記錄的資訊，以選取符合您需要的記錄層級。 您可能會發現某些事件提供的資訊比其他事件更有用。 例如，您可能只想記錄 PreExecute 事件的電腦和操作員名稱，而不是 Error 事件的所有可用資訊。

若要防止記錄檔使用大量的磁碟空間，或避免可能會降低效能的過度記錄，可以選取要記錄的特定事件和資訊項目，以限制記錄。 例如，您可以設定記錄檔僅擷取每個錯誤的日期和電腦名稱。

在 [SSIS 設計師] 中，使用 [設定 SSIS 記錄] 對話方塊來定義記錄選項。

記錄結構描述

下表描述記錄結構描述中的元素。

下表描述記錄結構描述中，在 [設定 SSIS 記錄] 對話方塊的 [詳細資料] 索引標籤上沒有提供的三個額外元素。

記錄項目

Integration Services 支援預先定義事件上的記錄項目，並為許多 Integration Services 物件提供自訂記錄項目。 在「SSIS 設計師」中的 [設定 SSIS 記錄] 對話方塊會列出這些事件和自訂記錄項目。

下表描述的預先定義事件可在發生執行階段事件時寫入記錄項目。 這些記錄項目會套用至可執行檔、封裝和封裝所包含的工作和容器。 記錄項目的名稱與引發並造成寫入記錄項目之執行階段事件的名稱相同。

封裝及許多工作都有可以啟用記錄功能的自訂記錄項目。 例如，「傳送郵件」工作會提供 SendMailTaskBegin 自訂記錄項目，其會在「傳送郵件」工作開始執行時，但在工作傳送電子郵件訊息之前，記錄資訊。 如需詳細資訊，請參閱＜自訂訊息以進行記錄＞。

區分封裝副本

記錄資料包含記錄項目所屬封裝的名稱和 GUID。 如果您透過複製現有的封裝來建立新的封裝，將一併複製現有封裝的名稱和 GUID。 因此，您可能會有兩套具有相同 GUID 和名稱的封裝，使您難以區分記錄資料中的封裝。

為了消除這種模糊不清的狀況，您應該更新這個新封裝的名稱和 GUID。 在 SQL Server Data Tools (SSDT) 中，您可以在 [屬性] 視窗的 ID 屬性中重新產生 GUID，並更新 Name 屬性的值。 您也可以使用程式設計方式或 dtutil 命令提示字元來變更 GUID 和名稱。 如需詳細資訊，請參閱＜設定封裝屬性＞和＜dtutil 公用程式＞。

父記錄選項

通常，工作和「For 迴圈」、「Foreach 迴圈」和「時序」容器的記錄選項符合封裝或父容器的選項。 在該情況下，可以設定它們從其父容器繼承記錄選項。 例如，在包含「執行 SQL」工作的「For 迴圈」容器中，「執行 SQL」工作可以使用在「For 迴圈」容器上設定的記錄選項。 若要使用父記錄選項，可將容器的 LoggingMode 屬性設為 UseParentSetting。 可以在 SQL Server Data Tools (SSDT) 的 [屬性] 視窗中，或透過 [SSIS 設計師] 中的 [設定 SSIS 記錄] 對話方塊設定此屬性。

記錄範本

在 [設定 SSIS 記錄] 對話方塊中，還可以將常用的記錄組態建立和儲存為範本，然後在多個封裝中使用這些範本。 這使得跨多個封裝套用一致的記錄策略，以及修改封裝的記錄設定變得很容易，只要更新後再套用範本即可。 範本以 XML 檔案儲存。

若要使用 [設定 SSIS 記錄] 對話方塊設定記錄

1. 啟用封裝及其工作的記錄功能。 記錄可以發生在封裝、容器和工作層級上。 您可以為封裝、容器和工作指定不同的記錄檔。

2. 選取記錄提供者，並為封裝加入記錄。 記錄檔僅可以在封裝層級建立，且工作或容器必須使用為封裝建立的記錄檔之一。 每個記錄檔都與下列記錄提供者之一相關聯：文字檔、SQL Server Profiler、SQL Server、Windows 記錄檔或 XML 檔案。 如需詳細資訊，請參閱＜在 SQL Server Data Tools 中啟用封裝記錄功能＞。

3. 選取事件，以及要在記錄檔中擷取之每個事件的記錄結構描述資訊。 如需詳細資訊，請參閱＜使用已儲存的組態檔來設定記錄＞。

設定記錄提供者

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

記錄提供者是按照在封裝中實作記錄的步驟而建立和設定的。 如需詳細資訊，請參閱＜Integration Services (SSIS) 記錄＞。

建立記錄提供者之後，您可以在 SQL Server Data Tools (SSDT) 的 [屬性] 視窗中檢視和修改其屬性。

如需有關以程式設計方式設定這些屬性的詳細資訊，請參閱 LogProvider 類別的文件。

資料流程工作的記錄功能

資料流程工作提供許多可用以監視及調整效能的自訂記錄項目。 例如，您可以監視可能會造成記憶體遺漏的元件，或是追蹤執行某特定元件所花費的時間。 如需這些自訂記錄項目的清單以及記錄輸出範例，請參閱＜資料流程工作＞。

使用 PipelineComponentTime 事件

最有用的自訂記錄項目可能是 PipelineComponentTime 事件。 這個記錄項目會報告每個元件在五個主要處理步驟的每個步驟中所花費的毫秒數。 下表描述這些處理步驟。 Integration Services 開發人員會將這些步驟辨識為 PipelineComponent 的主要方法。

當您啟用 PipelineComponentTime 事件時，Integration Services 就會針對每個元件所執行的每個處理步驟記錄一則訊息。 下列記錄項目會顯示 Integration Services CalculatedColumns 封裝範例所記錄的訊息子集：

The component "Calculate LineItemTotalCost" (3522) spent 356 milliseconds in ProcessInput.

The component "Sum Quantity and LineItemTotalCost" (3619) spent 79 milliseconds in ProcessInput.

The component "Calculate Average Cost" (3662) spent 16 milliseconds in ProcessInput.

The component "Sort by ProductID" (3717) spent 125 milliseconds in ProcessInput.

The component "Load Data" (3773) spent 0 milliseconds in ProcessInput.

The component "Extract Data" (3869) spent 688 milliseconds in PrimeOutput filling buffers on output "OLE DB Source Output" (3879).

The component "Sum Quantity and LineItemTotalCost" (3619) spent 141 milliseconds in PrimeOutput filling buffers on output "Aggregate Output 1" (3621).

The component "Sort by ProductID" (3717) spent 16 milliseconds in PrimeOutput filling buffers on output "Sort Output" (3719).

這些記錄項目顯示資料流程工作將大部分時間花費在下列步驟上 (在此依遞減順序顯示)：

• 名為 "Extract Data" 的 OLE DB 來源花費了 688 毫秒 來載入資料。

• 名為 "Calculate LineItemTotalCost" 的「衍生的資料行」轉換花費了 356 毫秒 來計算傳入資料列。

• 名為 "Sum Quantity and LineItemTotalCost" 的「彙總」轉換花費了結合的 220 毫秒 (141 毫秒在 PrimeOutput 而 79 毫秒在 ProcessInput) 來執行計算以及將資料傳遞給下一個轉換。

相關工作

下列清單包含說明如何執行記錄功能相關工作的主題連結。

• 使用設定 SSIS 記錄對話方塊來設定封裝記錄

• 在 SQL Server Data Tools 中啟用封裝記錄功能

• 在 SSIS 伺服器上啟用封裝執行的記錄功能

• 檢視記錄事件視窗中的記錄項目

相關內容

用於完整及詳細記錄的 DTLoggedExec 工具 (CodePlex 專案)

請參閱

工作

檢視記錄事件視窗中的記錄項目