使用 Azure SQL 受控執行個體代理程式執行 SSIS 封裝

發行項
04/27/2024

適用於：Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。了解如何免費開始新的試用！

本文說明如何使用 Azure SQL 受控執行個體代理程式來執行 SQL Server Integration Services (SSIS) 封裝。這項功能的作用與您在內部部署環境中使用 SQL Server Agent 排程 SSIS 封裝類似。

透過這項功能，您可以執行 SSIS 封裝，這些封裝儲存在 SQL 受控執行個體的 SSISDB、類似 Azure 檔案儲存體的檔案系統，或 Azure-SSIS 整合執行階段封裝存放區中。

必要條件

若要使用此功能，請下載並安裝最新的 SQL Server Management Studio (SSMS)。版本支援詳細資料如下：

若要在 SSISDB 或檔案系統中執行封裝，請安裝 SSMS 18.5 版或更新版本。
若要在封裝存放區中執行封裝，請安裝 SSMS 18.6 版或更新版本。

您還必須在 Azure Data Factory 中佈建 Azure-SSIS 整合執行階段。它會使用 SQL 受控執行個體作為端點伺服器。

在 SSISDB 中執行 SSIS 封裝

在此程序中，您會使用 SQL 受控執行個體代理程式來叫用儲存在 SSISDB 中的 SSIS 封裝。

在最新版本的 SSMS 中，連線到 SQL 受控執行個體。
建立新的代理程式作業和新的作業步驟。在 [SQL Server Agent] 下方，以滑鼠右鍵按一下 [作業] 資料夾，然後選取 [新增作業]。
在 [新增作業步驟] 頁面上，選取 [SQL Server Integration Services 封裝] 作為類型。
在 [封裝] 索引標籤上，選取 [SSIS 目錄] 作為封裝位置。
由於 SSISDB 位於 SQL 受控執行個體，因此您不需要指定驗證。
指定 SSISDB 中的 SSIS 封裝。
在 [設定] 索引標籤上，您可以：
- 在 [參數] 下方指定參數值。
- 在 [連線管理員] 下方覆寫值。
- 在 [進階] 下方覆寫屬性並選擇記錄層級。
選取 [確定] 以儲存代理程式作業設定。
啟動代理程式作業以執行 SSIS 封裝。

在檔案系統中執行 SSIS 封裝

在此程序中，您會使用 SQL 受控執行個體代理程式來執行儲存在檔案系統中的 SSIS 封裝。

在最新版本的 SSMS 中，連線到 SQL 受控執行個體。
建立新的代理程式作業和新的作業步驟。在 [SQL Server Agent] 下方，以滑鼠右鍵按一下 [作業] 資料夾，然後選取 [新增作業]。
在 [新增作業步驟] 頁面上，選取 [SQL Server Integration Services 封裝] 作為類型。
在 [封裝] 索引標籤上：
1. 針對 [封裝位置]，選取 [檔案系統]。
2. 針對 [檔案來源類型]：
  - 如果您的封裝上傳至 Azure 檔案儲存體，請選取 [Azure 檔案共用]。
    
    封裝路徑為 \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx。
    
    在 [封裝檔案存取認證] 下方，輸入 Azure 檔案帳戶名稱和帳戶金鑰，以存取 Azure 檔案。網域會設定為 Azure。
  - 如果您的封裝已上傳至網路共用，請選取 [網路共用]。
    
    封裝路徑是封裝檔案的 UNC 路徑，副檔名為 .dtsx。
    
    輸入對應的網域、使用者名稱和密碼，以存取網路共用封裝檔案。
3. 如果您的封裝檔案使用密碼加密，請選取 [加密密碼]，然後輸入密碼。
如果您需要設定檔來執行 SSIS 封裝，請在 [設定] 索引標籤上，輸入設定檔路徑。如果您將設定儲存在 Azure 檔案儲存體，其設定路徑會是 \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig。
在 [執行選項] 索引標籤上，您可以選擇要使用 [Windows 驗證] 還是 [32 位元執行階段] 來執行 SSIS 封裝。
在 [記錄] 索引標籤上，您可以選擇記錄路徑和對應的記錄存取認證來儲存記錄檔。根據預設，記錄路徑與封裝資料夾路徑相同，而記錄存取認證與封裝存取認證相同。如果您將記錄儲存在 Azure 檔案儲存體，則記錄路徑會是 \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>。
在 [設定值] 索引標籤上，您可以輸入屬性路徑和值來覆寫封裝屬性。

例如，若要覆寫使用者變數的值，請以下列格式輸入其路徑：\Package.Variables[User::<variable name>].Value。
選取 [確定] 以儲存代理程式作業設定。
啟動代理程式作業以執行 SSIS 封裝。

在封裝存放區中執行 SSIS 套件

注意

Azure Synapse 中的 Azure-SSIS IR 不支援封裝存放區。

在此程序中，您會使用 SQL 受控執行個體代理程式來執行儲存在 Azure-SSIS IR 封裝存放區中的 SSIS 封裝。

在最新版本的 SSMS 中，連線到 SQL 受控執行個體。
建立新的代理程式作業和新的作業步驟。在 [SQL Server Agent] 下方，以滑鼠右鍵按一下 [作業] 資料夾，然後選取 [新增作業]。
在 [新增作業步驟] 頁面上，選取 [SQL Server Integration Services 封裝] 作為類型。
在 [封裝] 索引標籤上：
1. 針對 [封裝位置]，選取 [封裝存放區]。
2. 針對 [封裝路徑]：
  
  封裝路徑為 <package store name>\<folder name>\<package name>。
3. 如果您的封裝檔案使用密碼加密，請選取 [加密密碼]，然後輸入密碼。
如果您需要設定檔來執行 SSIS 封裝，請在 [設定] 索引標籤上，輸入設定檔路徑。如果您將設定儲存在 Azure 檔案儲存體，其設定路徑會是 \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig。
在 [執行選項] 索引標籤上，您可以選擇要使用 [Windows 驗證] 還是 [32 位元執行階段] 來執行 SSIS 封裝。
在 [記錄] 索引標籤上，您可以選擇記錄路徑和對應的記錄存取認證來儲存記錄檔。根據預設，記錄路徑與封裝資料夾路徑相同，而記錄存取認證與封裝存取認證相同。如果您將記錄儲存在 Azure 檔案儲存體，則記錄路徑會是 \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>。
在 [設定值] 索引標籤上，您可以輸入屬性路徑和值來覆寫封裝屬性。

例如，若要覆寫使用者變數的值，請以下列格式輸入其路徑：\Package.Variables[User::<variable name>].Value。
選取 [確定] 以儲存代理程式作業設定。
啟動代理程式作業以執行 SSIS 封裝。

取消 SSIS 封裝執行

若要從 SQL 受控執行個體代理程式作業取消封裝執行，請採取下列步驟，而不是直接停止代理程式作業：

從 msdb.dbo.sysjobs 尋找您的 SQL 代理程式 jobId。
使用此查詢，根據作業識別碼尋找對應的 SSIS executionId：
```
select * from '{table for job execution}' where  parameter_value = 'SQL_Agent_Job_{jobId}' order by execution_id desc
```
如果您的 SSIS 封裝位於 SSISDB 中，請使用 ssisdb.internal.execution_parameter_values 作為作業執行的資料表。如果您的 SSIS 套件位於檔案系統中，請使用 ssisdb.internal.execution_parameter_values_noncatalog。
以滑鼠右鍵按一下 SSISDB 目錄，然後選取 [作用中作業]。
根據 executionId 停止對應的作業。

您也可以使用 Azure Data Factory 來排程 SSIS 封裝。如需逐步指示，請參閱 Azure Data Factory 事件觸發程序。