使用 Transact-SQL 從 Visual Studio Code 執行 SSIS 套件

發行項
05/04/2023

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

此快速入門示範如何使用 Visual Studio Code 連線到 SSIS 目錄資料庫，然後使用 Transact-SQL 陳述式執行 SSIS 目錄中所儲存的 SSIS 套件。

Visual Studio Code 是適用於 Windows、macOS 和 Linux 且支援延伸模組的程式碼編輯器，這些延伸模組包含用來連線至 Microsoft SQL Server、Azure SQL Database 或 Azure Synapse Analytics 的 mssql 延伸模組。如需 VS Code 的詳細資訊，請參閱 Visual Studio Code。

必要條件

開始之前，請確定您已安裝最新版 Visual Studio Code 並載入 mssql 延伸模組。若要下載這些工具，請參閱下列頁面：

支援的平台

您可以使用本快速入門中的資訊，在下列平台上執行 SSIS 套件：

Windows 上的 SQL Server。
Azure SQL Database。如需在 Azure 中部署和執行套件的詳細資訊，請參閱將 SQL Server Integration Services 工作負載隨即轉移至雲端。

您不能使用本快速入門中的資訊在 Linux 上執行 SSIS 套件。如需在 Linux 上執行套件的詳細資訊，請參閱使用 SSIS 在 Linux 上擷取、轉換和載入資料。

在 VS Code 中將語言模式設定為 SQL

若要啟用 mssql 命令和 T-SQL IntelliSense，請在 Visual Studio Code 中將語言模式設定為 [SQL]。

開啟 Visual Studio Code，然後開啟新視窗。
按一下狀態列右下角的 [純文字]。
在開啟的 [選取語言模式] 下拉式功能表中，選取或輸入 SQL，然後按 ENTER 將語言模式設定為 SQL。

針對 Azure SQL Database，請取得連線資訊

若要在 Azure SQL Database 上執行套件，請取得連線至 SSIS 目錄資料庫 (SSISDB) 所需的連線資訊。在下列程序中，您需要完整伺服器名稱和登入資訊。

登入 Azure 入口網站。
從左側功能表中選取 [SQL 資料庫] ，然後選取 [SQL 資料庫] 頁面上的 SSISDB 資料庫。
在您資料庫的 [概觀] 頁面上，檢閱完整伺服器名稱。若要顯示 [按一下以複製] 選項，請將滑鼠指標暫留在伺服器名稱上。
如果您忘記 Azure SQL Database 伺服器登入資訊，請巡覽至 [SQL Database 伺服器] 頁面來檢視伺服器管理員名稱。如有需要，您可以重設密碼。

連線至 SSIS 目錄資料庫

使用 Visual Studio Code，以建立與 SSIS 目錄的連線。

重要

繼續之前，請確定您已準備好伺服器、資料庫和登入資訊。如果您在開始輸入連線設定檔資訊之後變更 Visual Studio Code 的焦點，則必須重新開始建立連線設定檔。

在 VS Code 中，按 CTRL+SHIFT+P (或 F1) 開啟 [命令選擇區]。
鍵入 sqlcon，並按 ENTER。
按 ENTER 選取 [Create Connection Profile] (建立連線設定檔)。此步驟會建立您 SQL Server 執行個體的連線設定檔。

遵循提示來指定新連線設定檔的連線屬性。指定每個值之後，請按 ENTER 繼續。

設定	建議的值	其他資訊
伺服器名稱	完整伺服器名稱	如果您要連線至 Azure SQL Database 伺服器，則名稱的格式如下：`<server_name>.database.windows.net`。
資料庫名稱	SSISDB	要連線之資料庫的名稱。
驗證	SQL 登入	使用 SQL Server 驗證時，您可以連線到 SQL Server 或 Azure SQL Database。如果要連線至 Azure SQL Database 伺服器，您無法使用 Windows 驗證。
使用者名稱	伺服器系統管理員帳戶	這個帳戶是您在建立伺服器時指定的帳戶。
密碼 (SQL 登入)	伺服器系統管理員帳戶的密碼	這個密碼是您在建立伺服器時指定的密碼。
儲存密碼嗎？	[是] 或 [否]	如果您不想要每次都輸入密碼，請選取 [是]。
輸入此設定檔的名稱	設定檔名稱，例如 mySSISServer	儲存的設定檔名稱可在後續的登入中加速您的連線。

按 ESC 鍵關閉資訊訊息，通知您已建立並連線設定檔。
在狀態列中確認您的連線。

執行 T-SQL 程式碼

執行下列 Transact-SQL 程式碼來執行 SSIS 套件。

在 [編輯器] 視窗中，於空白查詢視窗中輸入下列查詢 (此程式碼是 SSMS 中 [執行套件] 對話方塊的 [指令碼] 選項所產生的程式碼。)
更新 catalog.create_execution 預存程序中您系統的參數值。
按 CTRL+SHIFT+E 執行程式碼，並執行套件。

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx',
    @execution_id=@execution_id OUTPUT,
    @folder_name=N'Deployed Projects',
	  @project_name=N'Integration Services Project1',
  	@use32bitruntime=False,
	  @reference_id=Null
Select @execution_id
DECLARE @var0 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,
    @object_type=50,
	  @parameter_name=N'LOGGING_LEVEL',
	  @parameter_value=@var0
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

後續步驟

請考慮使用其他方式來執行套件。

共用方式為