共用方式為


偵錯控制流程

SQL Server Data Tools (SSDT) 和 Microsoft Integration Services 包含的功能和工具,可用來針對 Integration Services 套件中的控制流程進行疑難解答。

  • Integration Services 支援容器和工作項目的斷點。

  • SSIS 設計工具會在運行時間提供進度報告。

  • SQL Server Data Tools (SSDT) 提供偵錯視窗。

中斷點

SSIS 設計工具提供 [ 設定斷點 ] 對話框,您可以在其中啟用斷點條件,並透過指定斷點發生的次數來設定,若達到指定次數後就會暫停封裝的執行。 斷點可以在封裝層級或個別元件的層級啟用。 如果在工作或容器層級啟用中斷條件,斷點圖示會出現在 [控制流程 ] 索引卷標的設計介面上的工作或容器旁邊。如果封裝上已啟用中斷條件,斷點圖示會出現在 [控制流程 ] 索引標籤的標籤上。

當斷點被觸發時,斷點圖示會變更,以協助您識別斷點的位置。 您可以在程式包執行時新增、刪除和變更斷點。

Integration Services 提供十個中斷條件,可在所有任務和容器上啟用。 在 [ 設定斷點 ] 對話框中,您可以在下列情況下啟用斷點:

中斷條件 說明
當工作或容器收到 OnPreExecute 事件時。 當工作即將執行時呼叫。 此事件是由工作或容器在執行之前立即引發。
當工作或容器收到 OnPostExecute 事件時。 在工作執行邏輯完成之後立即呼叫。 此事件會在任務或容器執行後馬上引發。
當工作或容器收到 OnError 事件時。 當發生錯誤時,會由某工作或容器呼叫。
當工作或容器收到 OnWarning 事件時。 當任務處於不至於導致錯誤但需要警告的狀態時,會被呼叫。
當工作或容器收到 OnInformation 事件時。 當工作需要提供資訊時呼叫。
當工作或容器收到 OnTaskFailed 事件時。 當任務主機發生失敗時進行呼叫。
當工作或容器收到 OnProgress 事件時。 被要求更新工作執行進度。
當工作或容器收到 OnQueryCancel 事件時。 當您取消執行時,隨時在工作處理中呼叫 。
當工作或容器收到 OnVariableValueChanged 事件時。 當變數的值變更時,會由整合服務執行階段呼叫。 變數的 RaiseChangeEvent 必須設定為 true ,才能引發這個事件。

**警告** 與這個斷點相關聯的變數必須定義於 容器 範圍。 如果變數在封包範圍中定義,則不會觸發斷點。
當工作或容器收到 OnCustomEvent 事件時。 任務呼叫以引發自定義任務定義事件。

除了所有工作和容器可用的中斷條件之外,某些工作和容器還包含設定斷點的特殊中斷條件。 例如,您可以在 For 迴圈容器上啟用中斷條件,以設定在迴圈每次反覆項目開始時暫停執行的斷點。

若要增強斷點的彈性和功能,您可以藉由指定下列選項來修改斷點的行為:

  • 命中計數,或是在執行暫停之前發生中斷條件的最大次數。

  • 命中計數類型,即指定中斷條件何時觸發斷點的規則。

叫用計數類型,除了 Always 類型之外,叫用計數會進一步限定。 例如,如果類型為「命中次數相等」,且命中次數為 5,則會在中斷條件的第六次觸發時暫停執行。

下表說明命中計數類型。

點擊計數類型 說明
永遠 當斷點被觸發時,執行總是會暫停。
點擊次數等於 當斷點發生的次數等於觸發次數時,就會暫停執行。
點擊次數大於或等於 當斷點發生的次數等於或大於命中次數時,就會暫停執行。
點擊計數倍數 在碰撞計數達到倍數時,執行將被暫停。 例如,如果您將此選項設定為5,則會每隔五次暫停執行一次。

設定斷點

進度報告

SSIS 設計工具包含兩種類型的進度報告:控制 流程 索引卷標設計介面上的色彩編碼,以及 [ 進度 ] 索引卷標上的進度訊息。

當您執行封裝時,SSIS 設計工具會使用指出執行狀態的色彩來顯示每個工作或容器,以描述執行進度。 您可以透過其色彩來判斷元素是否正在等候執行、目前正在執行、已順利完成,或未成功結束。 停止封裝執行之後,色彩編碼就會消失。

下表描述用來描述執行狀態的色彩。

顏色 執行狀態
灰色 等待開始執行
黃色 跑步
綠色 已成功運行
突出顯示 執行時發生錯誤

[ 進度 ] 索引標籤會依執行順序列出工作和容器,並包含開始和完成時間、警告和錯誤訊息。 停止封裝執行之後,進度資訊仍可在 [ 執行結果 ] 索引卷標上取得。

備註

若要啟用或停用 [進度] 索引標籤上訊息的顯示,請切換 SSIS 功能表上的 [偵錯進度報告] 選項。

下圖顯示 [ 進度 ] 索引標籤。

SSIS 設計工具的 [進度] 索引標籤

偵錯 Windows 作業系統

SQL Server Data Tools (SSDT) 包含許多可用來處理斷點的視窗,以及偵錯包含斷點的套件。 若要深入瞭解每個視窗,請開啟視窗,然後按 F1 以顯示視窗的說明。

若要在 SQL Server Data Tools (SSDT) 中開啟這些視窗,請點擊 [Debug] 功能表,指向 Windows,然後點擊 [斷點]、[輸出] 或 [立即]。

下表描述視窗。

窗戶 說明
中斷點 列出封裝中的斷點,並提供啟用和刪除斷點的選項。
輸出 顯示 SQL Server Data Tools (SSDT) 中功能的狀態訊息。
立即 用來偵錯和評估表達式和列印變數值。

另請參閱

套件開發的疑難排解工具