独立型 SQL Server Integration Services (SSIS) DevOps ツール

スタンドアロン SSIS DevOps Tools には、SSIS CICD タスクを実行するための一連の実行可能ファイルが用意されています。 Visual Studio または SSIS ランタイムのインストールに依存することなく、これらの実行可能ファイルを任意の CICD プラットフォームと簡単に統合できます。 提供される実行可能ファイルは次のとおりです。

• SSISBuild.exe: プロジェクト 配置モデルまたはパッケージ 配置モデルで SSIS プロジェクトをビルドします。
• SSISDeploy.exe: ISPAC ファイルを SSIS カタログにデプロイするか、DTSX ファイルとその依存関係をファイル システムにデプロイします。

取り付け

.NET Framework 4.6.2 以降が必要です。

ダウンロード センターから最新 インストーラーをダウンロードします。 また、直接ダウンロード リンク は、自動化スクリプトで使用できます。

次に、ウィザードまたはコマンド ラインを使用してインストールします。

• ウィザードを使用してインストールする

インストールする .exe ファイルをダブルクリックし、実行可能ファイルと依存関係ファイルを抽出するフォルダーを指定します。

• コマンド ラインを使用してインストールする

SSISDevOpsTools.exe /Q /C /T:<full path>

SSISBuild.exe

構文

SSISBuild.exe -project|-p:<dtproj file path> [-configuration|-c:<configuration name>] [-projectPassword|-pp:<project password>] [-stripSensitive|-ss] [-output|-o:<output path>] [-log|-l:<log level>[;<log path>]] [-quiet|-q] [-help|-h|-?]

パラメーター

パラメーター	説明
-project |-p:<dtproj ファイルのパス>	ビルドする dtproj ファイルのファイル パス。
-configuration|-c:<構成名>	ビルドに使用するプロジェクト構成の名前。 指定しない場合、dtproj ファイル内の最初に定義されたプロジェクト構成が既定で設定されます。
-projectPassword|-pp:<プロジェクトパスワード>	SSIS プロジェクトとそのパッケージのパスワード。 この引数は、SSIS プロジェクトとパッケージの保護レベルが EncryptSensitiveWithPassword または EncryptAllWithPassword の場合にのみ有効です。 パッケージ デプロイ モデルの場合、すべてのパッケージは、この引数で指定されたのと同じパスワードを共有する必要があります。
-stripSensitive|-ss	SSIS プロジェクトの保護レベルを DontSaveSensitive に変換します。 保護レベルが EncryptSensitiveWithPassword または EncryptAllWithPassword の場合、引数 -projectPassword が正しく設定されている必要があります。 このオプションは、プロジェクト配置モデルでのみ有効です。
-output|-o:<出力パス>	ビルド成果物の出力パス。 この引数の値は、プロジェクト構成の既定の出力パスを上書きします。
-log|-l:<ログ レベル>[;<ログ パス>]	関連する設定をログに記録します。 ログ レベル: ログ レベル以上のログのみがログ ファイルに書き込まれます。 DIAG、INFO、WRN、ERR の 4 つのログ 記録レベル (低レベルから高レベルまで) があります。 既定のログ 記録レベルは、指定されていない場合は INFO です。 ログ パス: ログを保持するファイルのパス。 パスが指定されていない場合、ログ ファイルは生成されません。
-quiet|-q	標準出力にログを表示しないでください。
-help|-h|-?	このコマンド ライン ユーティリティの詳細な使用状況情報を表示します。

使用例

• パスワードで暗号化されずに、最初に定義されたプロジェクト構成で dtproj をビルドします。

  SSISBuild.exe -p:"C:\projects\demo\demo.dtproj"
  

• 構成 "DevConfiguration" を使用して dtproj をビルドし、パスワードで暗号化し、ビルド成果物を特定のフォルダーに出力します。

  SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -o:D:\folder
  

• 構成 "DevConfiguration" を使用して dtproj を構築し、パスワードで暗号化し、機密データを削除し、ログ レベル DIAG を実行します。

  SSISBuild.exe -p:C:\projects\demo\demo.dtproj -c:DevConfiguration -pp:encryptionpassword -ss -l:diag
  

SSISDeploy.exe

構文

SSISDeploy.exe -source|-s:<source path> -destination|-d:<type>;<path>[;server] [-authType|-at:<auth type name>] [-connectionStringSuffix|-css:<connection string suffix>] [-projectPassword|-pp:<project password>] [-username|-u:<username>] [-password|-p:<password>] [-log|-l:<log level>[;<log path>]] [-quiet|-q] [-help|-h|-?]

パラメーター

パラメーター	説明
-source|-s:<ソース パス>	デプロイする成果物のローカル ファイル パス。 ISPAC、DTSX、DTSX のフォルダーのパス、SSISDeploymentManifest が許可されます。
-destination|-d:<種類>;<パス>[;server]	コピー先の種類、コピー先フォルダーのパス、およびソース ファイルの配置先となる SSIS カタログのサーバー名。 現在、次の 2 つの変換先の種類がサポートされています。 CATALOG: 指定した SSIS カタログに 1 つまたは複数の ISPAC ファイルをデプロイします。 CATALOG の宛先パスは、次の形式である必要があります。 /SSISDB/<フォルダー名>[/<プロジェクト名>] オプション <プロジェクト名> は、ソースで単一の ISPAC ファイル パスが指定されている場合にのみ有効です。 CATALOG 宛先にはサーバー名を指定する必要があります。 FILE: 単一または複数の SSISDeploymentManifest ファイルで指定された SSIS パッケージまたはファイルを、ファイル システムの指定されたパスに配置します。 FILE 変換先のパスには、ローカル フォルダー パスまたはネットワーク フォルダー パスを次の形式で指定できます。 \\<コンピューター名>\<フォルダー名>[\<サブ フォルダー名>...]
-authType|-at:<認証タイプ名>	SQL Server にアクセスするための認証の種類。 CATALOG の配置先の場合は必須です。 次の種類がサポートされています。 WIN: Windows 認証 SQL: SQL Server 認証 ADPWD: Active Directory - パスワード ADINT: Active Directory - 統合
-connectionStringSuffix|-css:<接続文字列サフィックス>	SSIS カタログへの接続に使用される接続文字列のサフィックス。
-projectPassword|-pp:<プロジェクト パスワード>	ISPAC または DTSX ファイルの暗号化を解除するためのパスワード。
-username|-u:<ユーザー名>	指定した SSIS カタログまたはファイル システムにアクセスするためのユーザー名。 ファイル システム アクセスでは、ドメイン名のプレフィックスを使用できます。
-password|-p:<パスワード>	指定した SSIS カタログまたはファイル システムにアクセスするためのパスワード。
-log|-l:<ログ レベル>[;<ログ パス>]	このユーティリティを実行するための関連設定をログに記録します。 ログ レベル: ログ レベル以上のログのみがログ ファイルに書き込まれます。 DIAG、INFO、WRN、ERR の 4 つのログ 記録レベル (低レベルから高レベルまで) があります。 既定のログ 記録レベルは、指定されていない場合は INFO です。 ログ パス: ログを保持するファイルのパス。 パスが指定されていない場合、ログ ファイルは生成されません。
-quiet|-q	標準出力にログを表示しないでください。
-help|-h|-?	このコマンド ライン ユーティリティの詳細な使用状況情報を表示します。

使用例

• Windows 認証を使用して、パスワードで暗号化されていない 1 つの ISPAC を SSIS カタログに展開します。

  SSISDeploy.exe -s:D:\myfolder\demo.ispac -d:catalog;/SSISDB/destfolder;myssisserver -at:win
  

• SQL 認証を使用して、パスワードで暗号化された 1 つの ISPAC を SSIS カタログにデプロイし、プロジェクト名の名前を変更します。

  SSISDeploy.exe -s:D:\myfolder\test.ispac -d:catalog;/SSISDB/folder/testproj;myssisserver -at:sql -u:sqlusername -p:sqlpassword -pp:encryptionpassword
  

• 1 つの SSISDeploymentManifest とそれに関連付けられているファイルを Azure ファイル共有にデプロイします。

  SSISDeploy.exe -s:D:\myfolder\mypackage.SSISDeploymentManifest -d:file;\\myssisshare.file.core.windows.net\destfolder -u:Azure\myssisshare -p:storagekey
  

• DTSX ファイルのフォルダーをオンプレミスのファイル システムにデプロイします。

  SSISDeploy.exe -s:D:\myfolder -d:file;\\myssisshare\destfolder
  

リリース ノート

バージョン 1.0.0.0

リリース日: 2021 年 9 月 1 日

• 一般提供 (GA) リリース。

バージョン 0.1.3.1 プレビュー

リリース日: 2021 年 6 月 10 日

• SSISDeploy.exe で SSIS プロジェクトを展開できず、エラー "Unhandled Exception: System.IO.FileLoadException: Could not load file or assembly 'Microsoft.SqlServer.IntegrationServices.ProjectDeployment, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. Strong name validation failed. (HRESULT からの例外: 0x8013141A) ---> System.Security.SecurityException: 厳密な名前の検証に失敗しました。 (HRESULT からの例外: 0x8013141A)"。

バージョン 0.1.3 プレビュー

リリース日: 2021 年 6 月 2 日

• "Project consistency check failed. (プロジェクトの整合性チェックに失敗しました。)" というエラーでプロジェクトをビルドできない SSISBuild.exe 問題を修正しました。 プロジェクト内のパッケージ名に特殊文字が含まれている場合、次の不整合が検出されました。
• dtproj の名前とファイル名の間に不一致がある場合にプロジェクトをビルドできない SSISBUild.exe 問題を修正しました。
• プロジェクト SSISBuild.exe SQL Server 2016 を対象とする場合に、保護レベルの encryptSensitiveWithPassword/EncryptAllWithPassword を使用してプロジェクトをビルドできなかった問題を修正しました。

バージョン 0.1.2 プレビュー

リリース日: 2021 年 1 月 14 日

• SSIS プロジェクト ファイルのパッケージ パラメーター メタデータと SSIS パッケージが一致しない場合に、SSISBuild.exe が NullReference 例外でプロジェクトのビルドに失敗する問題を修正しました。
• パッケージを含む SSIS プロジェクトが EncryptSensitiveWithUserKey で暗号化され、パッケージに機密データを含む CM が含まれている場合に、パッケージが SSISDeploy.exeで SSISDB に正常にデプロイされている場合に、"保護された XML ノードの暗号化解除に失敗しました" というエラーでパッケージが実行されない問題を修正しました。

バージョン 0.1.1 プレビュー

リリース日: 2020 年 11 月 11 日

• ispac を SSIS カタログに配置するときに、SSISDeploy.exe がアセンブリの読み込みに失敗する問題を修正しました。

バージョン 0.1.0 プレビュー

リリース日: 2020 年 10 月 16 日

スタンドアロン SSIS DevOps Tools の初期プレビュー リリース。

次の手順

• スタンドアロン SSIS DevOps ツールを入手する
• 質問がある場合は、Q&A にアクセスしてください