Transact-SQL を使用して Visual Studio Code から SSIS プロジェクトを配置する

  • [アーティクル]

適用対象: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 プロジェクトをデプロイできます。

  • SQL Server on Windows。

Azure SQL Database に SSIS パッケージをデプロイする場合は、このクイックスタートの情報を使用できません。 catalog.deploy_project ストアド プロシージャでは、ローカル ファイル システム内 (オンプレミス) の .ispac ファイルへのパスが必要です。 Azure でパッケージをデプロイし、実行する方法については、「SQL Server Integration Services ワークロードをクラウドにリフト アンド シフトする」を参照してください。

SQL Server on Linux に SSIS パッケージをデプロイする場合は、このクイックスタートの情報を使用できません。 Linux でパッケージを実行する方法については、SSIS を使用し、Linux でデータの抽出、変換、読み込みを行う方法に関するページを参照してください。

VS Code で言語モードを SQL に設定する

mssql コマンドと T-SQL IntelliSense を有効にするには、Visual Studio Code で言語モードを SQL に設定します。

  1. Visual Studio Code を開き、新しいウィンドウを開きます。

  2. ステータス バーの右下隅にある [プレーン テキスト] をクリックします。

  3. 開いた [言語モードの選択] ドロップダウン メニューで、[SQL] を選択または入力して、Enter キーを押して言語モードを SQL に設定します。

サポートされている認証方法

デプロイの認証方法を参照してください。

SSIS カタログ データベースに接続する

Visual Studio Code を使用して、SSIS カタログへの接続を確立します。

  1. VS Code で Ctrl + Shift + P (または F1) キーを押して、コマンド パレットを開きます。

  2. 「sqlcon」と入力し、Enter キーを押します。

  3. Enter キーを押して、[接続プロファイルの作成] を選択します。 この手順では、SQL Server インスタンスの接続プロファイルを作成します。

  4. 指示に従って、新しい接続プロファイルの接続プロパティを指定します。 それぞれの値を指定してから、Enter キーを押して続行します。

    設定 推奨値 詳細情報
    サーバー名 完全修飾サーバー名
    データベース名 SSISDB 接続先となるデータベースの名前。
    認証 SQL ログイン
    ユーザー名 サーバー管理者アカウント このアカウントは、サーバーの作成時に指定したアカウントです。
    パスワード (SQL ログイン) サーバー管理者アカウントのパスワード このパスワードは、サーバーの作成時に指定したパスワードです。
    パスワードを保存しますか? はい、いいえ 毎回パスワードを入力したくない場合は、[はい] を選択します。
    このプロファイルの名前を入力してください mySSISServer などのプロファイル名 プロファイル名が保存されていると、その後のログインの接続が高速化します。

  5. Esc キーを押して、プロファイルが作成され、接続されていることを通知する情報メッセージを閉じます。

  6. ステータス バーで、接続を確認します。

T-SQL コードを実行する

SSIS プロジェクトを配置するには、次の Transact-SQL コードを実行します。

  1. エディター ウィンドウで、空のクエリ ウィンドウに次のクエリを入力します。

  2. システムの catalog.deploy_project ストアド プロシージャ内のパラメーター値を更新します。

  3. Ctrl + Shift + E キーを押してコードを実行し、プロジェクトを配置します。

DECLARE @ProjectBinary AS varbinary(max)
DECLARE @operation_id AS bigint
SET @ProjectBinary = (SELECT * FROM OPENROWSET(BULK '<project_file_path>.ispac', SINGLE_BLOB) AS BinaryData)

EXEC catalog.deploy_project @folder_name = '<target_folder>',
    @project_name = '<project_name',
    @Project_Stream = @ProjectBinary,
    @operation_id = @operation_id out

次のステップ