チュートリアル:Azure で SQL Server Integration Services (SSIS) パッケージをデプロイし、実行する

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

適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime

このチュートリアルでは、Azure SQL Database の SSIS カタログに SQL Server Integration Services (SSIS) プロジェクトをデプロイする方法、Azure-SSIS Integration Runtime でのパッケージの実行方法、および実行中のパッケージの監視方法を示します。

前提条件

始める前に、バージョン 17.2 以降の SQL Server Management Studio があることを確認します。最新バージョンの SSMS をダウンロードするには、「SQL Server Management Studio (SSMS) のダウンロード」を参照してください。

また、Azure で SSISDB データベースを設定し、Azure SSIS 統合ランタイムをプロビジョニングしていることを確認してください。 Azure で SSIS をプロビジョニングする方法については、「SQL Server Integration Services パッケージを Azure にデプロイする」を参照してください。

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

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

Azure Portal にログインします。
左側のメニューから [SQL Databases] を選択し、[SQL データベース] ページで SSISDB データベースを選びます。
データベースの [概要] ページで、完全修飾サーバー名を確認します。 [クリックしてコピー] オプションを表示するには、サーバー名にマウスポインターを移動します。
Azure SQL Database サーバーのログイン情報を忘れた場合は、[SQL Database サーバー] ページに移動し、サーバーの管理者名を表示します。必要に応じて、パスワードをリセットできます。

SSISDB データベースに接続する

SQL Server Management Studio を使用して、Azure SQL Database サーバー上の SSIS カタログに接続します。詳細とスクリーンショットについては、「Azure 上の SSISDB カタログデータベースへの接続」を参照してください。

ここで、覚えるべき重要事項が 2 点あります。これらの点については、以下の手順で説明されます。

mysqldbserver.database.windows.net という形式で、Azure SQL Database サーバーの完全修飾名を入力します。
接続するデータベースとして SSISDB を選択します。

重要

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

SQL Server Management Studio を開きます。

サーバーに接続します。 [サーバーへの接続] ダイアログボックスで、次の情報を入力します。

設定	提案された値	説明
サーバーの種類	データベースエンジン	この値は必須です。
サーバー名	完全修飾サーバー名	名前は mysqldbserver.database.windows.net の形式である必要があります。サーバー名が必要な場合は、「Azure 上の SSISDB カタログデータベースへの接続」を参照してください。
認証	SQL Server 認証	Windows 認証を使用して Azure SQL Database に接続することはできません。
Login	サーバー管理者アカウント	サーバーの作成時に指定したアカウントです。
パスワード	サーバー管理者アカウントのパスワード	お客様がサーバーを作成したときに指定したパスワードです。

SSISDB データベースに接続します。 [オプション] を選択して、 [サーバーへの接続] ダイアログボックスを展開します。展開した [サーバーへの接続] ダイアログボックスで、 [接続プロパティ] タブを選択します。 [データベースへの接続] フィールドで、SSISDB を選択または入力します。
次に、 [接続](Connect) を選択します。 SSMS で [オブジェクトエクスプローラー] ウィンドウが開きます。
オブジェクトエクスプローラーで、 [Integration Services カタログ] 、 [SSISDB] の順に展開し、SSIS カタログデータベース内のオブジェクトを表示します。

配置ウィザードを使用してプロジェクトを配置する

パッケージの配置と配置ウィザードについて詳しくは、「Integration Services (SSIS) プロジェクトとパッケージの配置」および「Integration Services 配置ウィザード」を参照してください。

注意

Azure への配置では、プロジェクト配置モデルのみがサポートされます。

Integration Services 配置ウィザードを起動する

SSMS のオブジェクトエクスプローラーで、 [Integration Services カタログ] ノードと [SSISDB] ノードを展開した状態で、プロジェクトフォルダーを展開します。
[プロジェクト] ノードを選びます。
[プロジェクト] ノードを右クリックして、 [プロジェクトの配置] を選びます。 Integration Services 配置ウィザードが開きます。 SSIS カタログデータベースから、またはファイルシステムから、プロジェクトを配置することができます。

配置ウィザードを使用してプロジェクトを配置する

配置ウィザードの [概要] ページで、概要を確認します。 [次へ] を選択して、 [ソースの選択] ページを開きます。
[ソースの選択] ページで、配置する既存の SSIS プロジェクトを選びます。
- 作成したプロジェクト配置ファイルを配置するには、 [プロジェクト配置ファイル] を選択して .ispac ファイルのパスを入力します。
- SSIS カタログにあるプロジェクトを配置するには、 [Integration Services カタログ] を選び、サーバー名とカタログ内のプロジェクトのパスを入力します。このステップでは、SQL Server でホストされている SSISDB に存在するプロジェクトのみを再デプロイできます。
- [次へ] を選択して、[配置先の選択] ページを表示します。
[配置先の選択] ページで、プロジェクトの配置先を選びます。
- 完全修飾サーバー名を <server_name>.database.windows.net の形式で入力します。
- 認証情報を入力し、[接続] を選択します。
- 次に、[参照] を選択し、SSISDB でターゲットフォルダーを選択します。
- [次へ] を選択し、[レビュー] ページを開きます。 ([次へ] ボタンは、[接続] を選択した後でないと有効になりません。)
[レビュー] ページで、選択した設定を確認します。
- 選択内容を変更するには、[戻る] を選択するか、左ペインで任意の手順を選択します。
- [デプロイ] をクリックして、デプロイプロセスを開始します。
注意

"アクティブなワーカーエージェントがありません。(.Net SqlClient Data Provider)" というエラーメッセージが表示される場合は、Azure-SSIS Integration Runtime が動いていることを確認してください。 Azure-SSIS IR が停止状態の間に配置しようとすると、このエラーが発生します。
配置プロセスが完了すると、[結果] ページが開きます。このページでは、各アクションが成功したか、失敗したかを表示します。
- アクションが失敗した場合は、[結果] 列の [失敗] を選択すると、エラーの説明が表示されます。
- 必要に応じて、 [レポートの保存] を選択して結果を XML ファイルに保存します。
- [閉じる] を選択してウィザードを終了します。

PowerShell でプロジェクトを配置する

PowerShell を使って Azure SQL Database の SSISDB にプロジェクトを配置するには、次のスクリプトを要件に適合させます。スクリプトが $ProjectFilePath の下の子フォルダーと各子フォルダー内のプロジェクトを列挙し、次に、SSISDB で同じフォルダーを作成し、それらのフォルダーにプロジェクトを展開します。

このスクリプトには、SQL Server Data Tools バージョン 17.x、またはスクリプトを実行するコンピューターにインストールされている SQL Server Management Studio が必要です。

# Variables
$ProjectFilePath = "C:\<folder>"
$SSISDBServerEndpoint = "<servername>.database.windows.net"
$SSISDBServerAdminUserName = "<username>"
$SSISDBServerAdminPassword = "<password>"

# Load the IntegrationServices Assembly
[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Management.IntegrationServices") | Out-Null;

# Store the IntegrationServices Assembly namespace to avoid typing it every time
$ISNamespace = "Microsoft.SqlServer.Management.IntegrationServices"

Write-Host "Connecting to server ..."

# Create a connection to the server
$sqlConnectionString = "Data Source=" + $SSISDBServerEndpoint + ";User ID="+ $SSISDBServerAdminUserName +";Password="+ $SSISDBServerAdminPassword + ";Initial Catalog=SSISDB"
$sqlConnection = New-Object System.Data.SqlClient.SqlConnection $sqlConnectionString

# Create the Integration Services object
$integrationServices = New-Object $ISNamespace".IntegrationServices" $sqlConnection

# Get the catalog
$catalog = $integrationServices.Catalogs['SSISDB']

write-host "Enumerating all folders..."

$folders = ls -Path $ProjectFilePath -Directory

if ($folders.Count -gt 0)
{
    foreach ($filefolder in $folders)
    {
        Write-Host "Creating Folder " + $filefolder.Name + " ..."

        # Create a new folder
        $folder = New-Object $ISNamespace".CatalogFolder" ($catalog, $filefolder.Name, "Folder description")
        $folder.Create()

        $projects = ls -Path $filefolder.FullName -File -Filter *.ispac
        if ($projects.Count -gt 0)
        {
            foreach($projectfile in $projects)
            {
                $projectfilename = $projectfile.Name.Replace(".ispac", "")
                Write-Host "Deploying " + $projectfilename + " project ..."

                # Read the project file, and deploy it to the folder
                [byte[]] $projectFileContent = [System.IO.File]::ReadAllBytes($projectfile.FullName)
                $folder.DeployProject($projectfilename, $projectFileContent)
            }
        }
    }
}

Write-Host "All done."

パッケージの実行

SSMS のオブジェクトエクスプローラーで、実行するパッケージを選択します。
右クリックして [実行] を選択し、[パッケージの実行] ダイアログボックスを開きます。
[パッケージの実行] ダイアログボックスで、[パラメーター]タブ、[接続マネージャー] タブ、[詳細設定] タブの設定を使用して、パッケージの実行を構成します。
[OK] を選択してパッケージを実行します。

SSMS で実行中のパッケージを監視する

Integration Services サーバー上で現在実行されている Integration Services 操作 (配置、検証、パッケージの実行など) の状態を表示するには、SSMS の [アクティブな操作] ダイアログボックスを使用します。 [アクティブな操作] ダイアログボックスを開くには、[SSISDB] を右クリックし、[アクティブな操作] を選択します。

また、オブジェクトエクスプローラーでパッケージを選択し、右クリックして [レポート] を選択し、[標準レポート]、[すべての実行] の順に選択することもできます。

SSMS で実行中のパッケージを監視する方法の詳細については、「パッケージとその他の操作を実行するモニター」を参照してください。

SSIS パッケージの実行アクティビティを監視する

SSIS パッケージの実行アクティビティを使用して Azure Data Factory パイプラインの一部としてパッケージを実行している場合、Data Factory UI でパイプライン実行を監視できます。その後、アクティビティ実行の出力から SSISDB 実行 ID を取得し、その ID を使用してさらに包括的な実行ログとエラーメッセージを SSMS で確認できます。

Data Factory でパッケージ実行 ID を取得する

Azure-SSIS Integration Runtime の監視

パッケージが実行されている Azure SSIS 統合ランタイムに関する状態情報を取得するには、次の PowerShell コマンドを使用します。コマンドごとに、データファクトリ、Azure SSIS IR、およびリソースグループの名前を入力します。

詳細については、Azure SSIS 統合ランタイムの監視に関するページを参照してください。

Azure-SSIS Integration Runtime に関するメタデータを取得する

Get-AzDataFactoryV2IntegrationRuntime -DataFactoryName $DataFactoryName -Name $AzureSsisIRName -ResourceGroupName $ResourceGroupName

Azure-SSIS Integration Runtime の状態を取得する

Get-AzDataFactoryV2IntegrationRuntime -Status -DataFactoryName $DataFactoryName -Name $AzureSsisIRName -ResourceGroupName $ResourceGroupName

次のステップ

パッケージ実行をスケジュールする方法を説明します。詳細については、「Azure で SSIS パッケージの実行をスケジュールする」を参照してください。

次の方法で共有

チュートリアル:Azure で SQL Server Integration Services (SSIS) パッケージをデプロイし、実行する

前提条件

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

SSISDB データベースに接続する

配置ウィザードを使用してプロジェクトを配置する

Integration Services 配置ウィザードを起動する

配置ウィザードを使用してプロジェクトを配置する

PowerShell でプロジェクトを配置する

パッケージの実行

SSMS で実行中のパッケージを監視する

SSIS パッケージの実行アクティビティを監視する

Azure-SSIS Integration Runtime の監視

Azure-SSIS Integration Runtime に関するメタデータを取得する

Azure-SSIS Integration Runtime の状態を取得する

次のステップ

フィードバック

その他のリソース