.NET アプリで C# コードを使用して SSIS プロジェクトを配置する

[アーティクル]
05/23/2023

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

このクイックスタートでは、データベースサーバーに接続し、SSIS プロジェクトをデプロイする C# コードを記述する方法について説明します。

C# アプリを作成するには、Visual Studio、Visual Studio Code、または他の任意のツールを使用できます。

前提条件

開始する前に Visual Studio または Visual Studio Code がインストールされていることを確認します。 Visual Studio の無償の Community エディション、または無償の Visual Studio Code を「Visual Studio のダウンロード」からダウンロードします。

Azure SQL Database サーバーは、ポート 1433 でリッスンします。企業のファイアウォール内から Azure SQL Database サーバーに接続しようとする場合、正常に接続するには、このポートを企業のファイアウォールで開ける必要があります。

サポートされているプラットフォーム

このクイックスタートの情報を利用し、次のプラットフォームに SSIS プロジェクトをデプロイできます。

SQL Server on Windows。
Azure SQL Database。 Azure でパッケージをデプロイし、実行する方法については、「SQL Server Integration Services ワークロードをクラウドにリフトアンドシフトする」を参照してください。

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

Azure SQL Database の場合の接続情報の取得

プロジェクトを Azure SQL Database にデプロイするには、SSIS カタログデータベース (SSISDB) に接続するために必要な接続情報を取得します。次の手順では、完全修飾サーバー名とログイン情報が必要です。

Azure Portal にログインします。
左側のメニューから [SQL Databases] を選択し、[SQL データベース] ページで SSISDB データベースを選びます。
データベースの [概要] ページで、完全修飾サーバー名を確認します。 [クリックしてコピー] オプションを表示するには、サーバー名にマウスポインターを移動します。
Azure SQL Database サーバーのログイン情報を忘れた場合は、[SQL Database サーバー] ページに移動し、サーバーの管理者名を表示します。必要に応じて、パスワードをリセットできます。
[データベース接続文字列の表示] をクリックします。
完全な ADO.NET 接続文字列を確認します。任意で、コードで SqlConnectionStringBuilder を使用し、入力した個々のパラメーター値でこの接続文字列を再作成できます。

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

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

新しい Visual Studio プロジェクトの作成

Visual Studio で、[ファイル]、[新規]、[プロジェクト] の順に選択します。
[新しいプロジェクト] ダイアログで、[Visual C#] を展開します。
[コンソールアプリ] を選択し、プロジェクト名に deploy_ssis_project を入力します。
[OK] をクリックして Visual Studio で新しいプロジェクトを開きます。

参照の追加

ソリューションエクスプローラーで、[参照] フォルダーを右クリックし、[参照の追加] を選択します。 [参照マネージャー] ダイアログボックスが表示されます。
[参照マネージャー] ダイアログボックスで、[アセンブリ] を展開して [拡張機能] を選択します。
次の 2 つの参照を選択して追加します。
- Microsoft.SqlServer.Management.Sdk.Sfc
- Microsoft.SqlServer.Smo
[参照] ボタンをクリックして、参照を Microsoft.SqlServer.Management.IntegrationServices に追加します (このアセンブリはグローバルアセンブリキャッシュ (GAC) にのみインストールされます)。 [参照するファイルの選択] ダイアログボックスが表示されます。
[参照するファイルの選択] ダイアログボックスで、アセンブリを含む GAC フォルダーに移動します。通常このフォルダーは C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91 です。
フォルダー内のアセンブリ (.dll ファイル) を選択し、[追加] をクリックします。
[OK] をクリックして [参照マネージャー] ダイアログボックスを閉じ、3 つの参照を追加します。参照があることを確認するには、ソリューションエクスプローラーで [参照] リストを確認します。

C# コードを追加する

Program.cs を開きます。
Program.cs のコンテンツを次のコードに置き換えます。サーバー、データベース、ユーザー、およびパスワードの適切な値を追加します。

Note

次の例では、Windows 認証を使用します。 SQL Server 認証を使用するには、Integrated Security=SSPI; 引数を User ID=<user name>;Password=<password>; に置き換えます。 Azure SQL Database サーバーに接続する場合、Windows 認証を使用できません。

using Microsoft.SqlServer.Management.IntegrationServices;
using System;
using System.Data.SqlClient;
using System.IO;

namespace deploy_ssis_project
{
    class Program
    {
        static void Main(string[] args)
        {
            // Variables
            string targetServerName = "localhost";
            string targetFolderName = "Project1Folder";
            string projectName = "Integration Services Project1";
            string projectFilePath = @"C:\Projects\Integration Services Project1\Integration Services Project1\bin\Development\Integration Services Project1.ispac";

            // Create a connection to the server
            string sqlConnectionString = "Data Source=" + targetServerName +
                ";Initial Catalog=master;Integrated Security=SSPI;";
            SqlConnection sqlConnection = new SqlConnection(sqlConnectionString);

            // Create the Integration Services object
            IntegrationServices integrationServices = new IntegrationServices(sqlConnection);

            // Get the Integration Services catalog
            Catalog catalog = integrationServices.Catalogs["SSISDB"];

            // Create the target folder
            CatalogFolder folder = new CatalogFolder(catalog,
                targetFolderName, "Folder description");
            folder.Create();

            Console.WriteLine("Deploying " + projectName + " project.");

            byte[] projectFile = File.ReadAllBytes(projectFilePath);
            folder.DeployProject(projectName, projectFile);

            Console.WriteLine("Done.");
        }
    }
}

コードの実行

アプリケーションを実行するには、F5 を押します。
SSMS で、プロジェクトが配置されていることを確認します。

次のステップ

パッケージを配置する他の方法を検討します。
配置されたパッケージを実行します。パッケージを実行するには、いくつかのツールおよび言語から選択することができます。詳細については、次の記事を参照してください。

次の方法で共有