SSIS カタログ

[アーティクル]
03/29/2024

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

SSISDB カタログは、Integration Services サーバーに配置した Integration Services (SSIS) プロジェクトを操作するための中核となります。たとえば、プロジェクトパラメーターとパッケージパラメーターの設定、パッケージに合わせたランタイム値を指定するための環境の構成、パッケージの実行およびトラブルシューティング、 Integration Services サーバー操作の管理を行います。

注意

この記事では、SSIS カタログ全般とオンプレミスで実行されている SSIS カタログについて説明します。 Azure SQL Database で SSIS カタログを作成し、Azure で SSIS パッケージをデプロイし、実行することもできます。詳細については、「Lift and shift SQL Server Integration Services workloads to the cloud」 (SQL Server Integration Services ワークロードをクラウドにリフトアンドシフトする) を参照してください。

Linux で SSIS パッケージを実行することもできますが、SSIS カタログは Linux ではサポートされていません。詳しくは、「SSIS で Linux 上のデータの抽出、変換、読み込みを行う」をご覧ください。

SSISDB カタログに格納されているオブジェクトには、プロジェクト、パッケージ、パラメーター、環境、および操作履歴があります。

SSISDB カタログに格納されているオブジェクト、設定、および業務データを検査するには、 SSISDB データベースのビューに対してクエリを実行します。オブジェクトを管理するには、 SSISDB データベースのストアドプロシージャを呼び出すか、 SSISDB カタログの UI を使用します。多くの場合、UI でもストアドプロシージャの呼び出しでも同じタスクを実行できます。

SSISDB データベースを保守するには、ユーザーデータベースの管理に標準的なエンタープライズポリシーを適用することをお勧めします。メンテナンスプランの作成については、「 Maintenance Plans」をご覧ください。

SSISDB カタログおよび SSISDB データベースは、Windows PowerShell をサポートしています。 Windows PowerShell による SQL Server の使用の詳細については、「 SQL Server PowerShell」をご覧ください。 Windows PowerShell を使用してプロジェクトの配置などのタスクを実行する方法の例については、blogs.msdn.com のブログエントリ「 SQL Server 2012 での SSIS と PowerShell」をご覧ください。

操作データの表示に関する詳細については、「パッケージとその他の操作を実行するモニター」をご覧ください。

の SSISDB SQL Server Management Studio カタログにアクセスするには、 SQL Server データベースエンジンに接続し、オブジェクトエクスプローラーで [Integration Services カタログ] ノードを展開します。で SSISDB SQL Server Management Studio データベースにアクセスするには、オブジェクトエクスプローラーで [データベース] ノードを展開します。

注意

SSISDB データベースの名前は変更できません。

注意

SQL Server SSISDB データベースがアタッチされている インスタンスが停止したか、応答しない場合、ISServerExec.exe プロセスは終了します。メッセージが Windows イベントログに書き込まれます。

クラスターフェールオーバーの一環として SQL Server リソースがフェールオーバーした場合、実行中のパッケージは再開されません。チェックポイントを使用してパッケージを再開できます。詳細については、「 Restart Packages by Using Checkpoints」を参照してください。

特徴と機能

カタログオブジェクト識別子

カタログに新しいオブジェクトを作成するときは、オブジェクトに名前を割り当てる必要があります。オブジェクト名が識別子となります。 SQL Server では、識別子に使用できる文字のルールが定義されています。次のオブジェクトの名前は、識別子のルールに従っている必要があります。

Folder
Project
環境
パラメーター
環境変数

フォルダー、プロジェクト、環境

フォルダー、プロジェクト、または環境の名前を変更するときは、次のルールを考慮します。

無効な文字には、ASCII/Unicode 文字 1 - 31、引用符 (")、小なり (<)、大なり (>)、パイプ (|)、バックスペース (\b)、null (\0)、タブ (\t) などがあります。
名前の先頭または末尾にスペースを含めることはできません。
名前を @ で始めることはできませんが、先頭以外では @ を使用できます。
名前の長さは 1 ～ 128 文字にする必要があります。

パラメーター

パラメーターに名前を付けるときは、次のルールを考慮します。

名前の最初の文字は、Unicode Standard 2.0 に定義されている文字か、アンダースコア (_) である必要があります。
2 番目以降の文字では、Unicode Standard 2.0 に定義されている文字または数字と、アンダースコア (_) を使用できます。

環境変数

環境変数に名前を付けるときは、次のルールを考慮します。

無効な文字には、ASCII/Unicode 文字 1 - 31、引用符 (")、小なり (<)、大なり (>)、パイプ (|)、バックスペース (\b)、null (\0)、タブ (\t) などがあります。
名前の先頭または末尾にスペースを含めることはできません。
名前を @ で始めることはできませんが、先頭以外では @ を使用できます。
名前の長さは 1 ～ 128 文字にする必要があります。
名前の最初の文字は、Unicode Standard 2.0 に定義されている文字か、アンダースコア (_) である必要があります。
2 番目以降の文字では、Unicode Standard 2.0 に定義されている文字または数字と、アンダースコア (_) を使用できます。

カタログの構成

カタログプロパティを調整することによって、カタログの動作を微調整します。カタログプロパティは、機微なデータを暗号化する方法と、操作およびプロジェクトのバージョン管理データを保持する方法を定義します。カタログプロパティを設定するには、[カタログのプロパティ] ダイアログボックスを使用するか、catalog.configure_catalog (SSISDB データベース) ストアドプロシージャを呼び出します。プロパティを表示するには、ダイアログボックスまたはクエリ catalog.catalog_properties (SSISDB Database) を使用します。ダイアログボックスには、オブジェクトエクスプローラーで SSISDB を右クリックしてアクセスできます。

操作とプロジェクトバージョンのクリーンアップ

カタログの多くの操作の状態データは、内部データベーステーブルに格納されます。たとえば、カタログではパッケージの実行とプロジェクトの配置の状態が追跡されます。操作データのサイズを維持するには、の SSIS サーバーメンテナンスジョブ SQL Server Management Studio を使用して古いデータを削除します。この SQL Server エージェントジョブは、 Integration Services のインストール時に作成されます。

同じ名前の Integration Services プロジェクトをカタログの同じフォルダーに配置することで、このプロジェクトを更新または再配置できます。既定では、プロジェクトを再配置するたびに、 SSISDB カタログには以前のバージョンのプロジェクトが保持されます。操作データのサイズを維持するには、 SSIS サーバーメンテナンスジョブ を使用して古いバージョンのプロジェクトを削除します。

SSIS サーバーメンテナンスジョブを実行するために、SSIS で SQL Server ログイン ##MS_SSISServerCleanupJobLogin## が作成されます。このログインは SSIS による内部使用専用です。

次の SSISDB カタログプロパティで、この SQL Server エージェントジョブの動作を定義します。 [カタログプロパティ] ダイアログボックスを利用するか、catalog.catalog_properties (SSISDB データベース) と catalog.configure_catalog (SSISDB データベース) を利用し、プロパティを表示し、変更できます。

ログを定期的に消去する
このプロパティが Trueに設定されている場合は、操作のクリーンアップのジョブステップが実行されます。

保有期間 (日)
操作データの最大保有期間を日数で定義します。この期間を経過したデータは削除されます。

最小値は 1 日です。最大値は SQL Server int データの最大値によってのみ制限されます。このデータ型に関する詳細については、「int、bigint、smallint、および tinyint (Transact-SQL)」を参照してください。

古いバージョンを定期的に削除する
このプロパティが Trueに設定されている場合は、プロジェクトバージョンのクリーンアップのジョブステップが実行されます。

プロジェクトごとのバージョンの最大数
カタログに格納されるプロジェクトのバージョンの数を定義します。この数を超える古いバージョンのプロジェクトは削除されます。

暗号化アルゴリズム

[暗号化アルゴリズム] プロパティでは、秘密性の高いパラメーター値を暗号化するために使用される暗号化の種類を指定します。次の暗号化の種類から選択できます。

AES_256 (既定値)
AES_192
AES_128
DESX
TRIPLE_DES_3KEY
TRIPLE_DES
DES

Integration Services プロジェクトを Integration Services サーバーに配置する場合、カタログは自動的にパッケージのデータと機微な値を暗号化します。また、ユーザーがデータを取得するときには、自動的に暗号化を解除します。 SSISDB カタログは、 ServerStorage 保護レベルを使用します。詳しくは、「 Access Control for Sensitive Data in Packages」をご覧ください。

暗号化アルゴリズムの変更は、時間のかかる操作です。最初に、サーバーで以前に指定したアルゴリズムを使用して、すべての構成値の暗号化を解除する必要があります。次に、新しいアルゴリズムを使用して、その値を再暗号化する必要があります。この間、サーバーで他の Integration Services 操作を実行できません。そのため、 Integration Services 操作を途切れることなく続行できるように、Management Studio では、暗号化アルゴリズムが読み取り専用の値になっています。

[暗号化アルゴリズム] プロパティの設定を変更するには、 SSISDB データベースをシングルユーザーモードに設定し、catalog.configure_catalog ストアドプロシージャを呼び出します。 property_name 引数の ENCRYPTION_ALGORITHM を使用します。プロパティの値の詳細については、「catalog.catalog_properties (SSISDB データベース)」を参照してください。ストアドプロシージャの詳細については、「catalog.configure_catalog (SSISDB データベース)」を参照してください。

シングルユーザーモードの詳細については、「データベースをシングルユーザーモードに設定する」を参照してください。 SQL Serverの暗号化と暗号化アルゴリズムの詳細については、「 SQL Server の暗号化」のトピックを参照してください。

暗号化にはデータベースマスターキーが使用されます。このキーは、カタログの作成時に作成されます。

次の表では、 [カタログのプロパティ] ダイアログボックスに示されるプロパティ名と、データベースビュー内の対応するプロパティについて説明します。

プロパティ名 ( [カタログのプロパティ] ダイアログボックス)	プロパティ名 (データベースビュー)
暗号化アルゴリズムの名前	ENCRYPTION_ALGORITHM
ログを定期的に消去する	OPERATION_CLEANUP_ENABLEDâ€‹
保有期間 (日)	RETENTION_WINDOW
古いバージョンを定期的に削除する	VERSION_CLEANUP_ENABLED
プロジェクトごとのバージョンの最大数	MAX_PROJECT_VERSIONS
サーバー全体の既定のログ記録レベル	SERVER_LOGGING_LEVEL

アクセス許可

プロジェクト、環境、およびパッケージは、セキュリティ保護可能なオブジェクトであるフォルダーに格納されます。 MANAGE_OBJECT_PERMISSIONS 権限などのフォルダーに対する権限を許可することができます。 MANAGE_OBJECT_PERMISSIONS を許可すると、ユーザーに ssis_admin ロールのメンバーシップを許可しなくても、フォルダー内容の管理をユーザーに委任できます。プロジェクト、環境、および操作に権限を付与することもできます。操作には、 Integration Servicesの初期化、プロジェクトの配置、実行の作成および開始、プロジェクトおよびパッケージの検証、 SSISDB カタログの構成などがあります。

データベースロールの詳細については、「データベースレベルのロール」を参照してください。

SSISDB カタログでは、DDL トリガーの ddl_cleanup_object_permissions を使用して、SSIS のセキュリティ保護可能なリソースの権限情報の整合性を保ちます。このトリガーは、データベースユーザー、データベースロール、データベースアプリケーションロールなどのデータベースプリンシパルが SSISDB データベースから削除されたときに起動します。

このプリンシパルによって他のプリンシパルに権限が許可または拒否されている場合は、プリンシパルを削除する前に、権限の許可者が付与した権限を取り消してください。取り消していない場合は、プリンシパルの削除が試行されるとエラーメッセージが返されます。トリガーでは、データベースプリンシパルが権限付与対象ユーザーであるすべての権限レコードが削除されます。

トリガーは無効にしないことをお勧めします。これは、データベースプリンシパルが SSISDB データベースから削除された後に孤立した権限レコードが存在しないようにするためです。

権限の管理

権限は、SQL Server Management Studio の UI、ストアドプロシージャ、Microsoft.SqlServer.Management.IntegrationServices 名前空間を使って管理できます。

SQL Server Management Studio の UI を使ってアクセス許可を管理するには、次のダイアログボックスを使用します。

フォルダーを使用して、権限のページ、 Folder Properties Dialog Boxします。
プロジェクトの場合は、権限の Project Properties Dialog Boxします。

Transact-SQL を利用してアクセス許可を管理するには、catalog.grant_permission (SSISDB データベース)、catalog.deny_permission (SSISDB データベース)、catalog.revoke_permission (SSISDB データベース) を呼び出します。すべてのオブジェクトの現在のプリンシパルで有効な権限を表示するには、catalog.effective_object_permissions (SSISDB データベース) にクエリを実行します。このトピックでは、さまざまな種類の権限について説明します。ユーザーに明示的に割り当てられている権限を表示するには、catalog.explicit_object_permissions (SSISDB データベース) にクエリを実行します。

フォルダー

フォルダーには、 SSISDB カタログ内の 1 つ以上のプロジェクトおよび環境が含まれます。 catalog.folders (SSISDB データベース) ビューを使用して、カタログのフォルダーに関する情報にアクセスできます。次のストアドプロシージャを使用して、フォルダーを管理することができます。

プロジェクトとパッケージ

各プロジェクトには、複数のパッケージを含めることができます。プロジェクトとパッケージの両方に、パラメーターおよび環境への参照を含めることができます。 Configure Dialog Boxを使用して、パラメーターおよび環境への参照にアクセスできます。

次のストアドプロシージャを呼び出して、他のプロジェクトタスクを実行することができます。

次のビューには、パッケージ、プロジェクト、およびプロジェクトのバージョンに関する詳細が表示されます。

パラメーター

パラメーターを使用して、パッケージの実行時にパッケージプロパティに値を割り当てます。パッケージまたはプロジェクトパラメーターの値を設定したり、値を消去したりするには、catalog.set_object_parameter_value (SSISDB データベース) と catalog.clear_object_parameter_value (SSISDB データベース) を呼び出します。実行のインスタンスのパラメーターの値を設定するには、catalog.set_execution_parameter_value (SSISDB データベース) を呼び出します。 catalog.get_parameter_values (SSISDB データベース) を呼び出すことで既定のパラメーター値を取得できます。

次のビューには、すべてのパッケージとプロジェクトのパラメーター、および実行のインスタンスに使用されるパラメーター値が表示されます。

サーバー環境、サーバー変数、およびサーバー環境参照

サーバー環境にはサーバー変数が含まれます。変数値は、 Integration Services サーバーでパッケージを実行または検証するときに使用できます。

次のストアドプロシージャを使用すると、環境と変数の他の多くの管理タスクを実行することができます。

catalog.set_environment_variable_protection (SSISDB データベース) ストアドプロシージャを呼び出すことで、変数のセンシティビティビットを設定できます。

サーバー変数の値を使用するには、プロジェクトとサーバー環境間の参照を指定します。次のストアドプロシージャを使用して、参照を作成したり削除したりすることができます。環境をプロジェクトと同じフォルダーに配置できるか、または別のフォルダーに配置できるかを示すこともできます。

環境と変数の詳細については、次のビューに対してクエリを実行します。

実行と検証

実行はパッケージ実行のインスタンスです。実行を作成し、開始するには、catalog.create_execution (SSISDB データベース) と catalog.start_execution (SSISDB データベース) を呼び出します。実行またはパッケージ/プロジェクト検証を停止するには、catalog.stop_operation (SSISDB データベース) を呼び出します。

実行中のパッケージを一時停止してダンプファイルを作成するには、catalog.create_execution_dump ストアドプロシージャを呼び出します。ダンプファイルは、実行に関する問題のトラブルシューティングに役立つ、パッケージの実行に関する情報を提供します。ダンプファイルの生成および構成の詳細については、「 Generating Dump Files for Package Execution」をご覧ください。

実行、検証、操作中にログに記録されたメッセージ、およびエラーに関するコンテキスト情報の詳細については、次のビューに対してクエリを実行します。

catalog.validate_project (SSISDB データベース) および catalog.validate_package (SSISDB データベース) ストアドプロシージャを呼び出すことで、プロジェクトとパッケージを検証できます。 catalog.validations (SSISDB データベース) ビューには、検証で考慮されるサーバー環境参照、検証が依存関係の検証であるか完全検証であるか、32 ビットランタイムと 64 ビットランタイムのどちらをパッケージの実行に使用するかなどの、検証に関する詳細が表示されます。

SSIS カタログの作成

SQL Server Data Toolsでパッケージをデザインしてテストしたら、パッケージを含むプロジェクトを Integration Services サーバーに配置できます。プロジェクトを Integration Services サーバーに配置するには、まず、サーバーに SSISDB カタログを含める必要があります。 SQL Server 2012 (11.x) のインストールプログラムでは、カタログは自動的に作成されません。次の手順を使用して、カタログを手動で作成する必要があります。

SSISDB カタログは SQL Server Management Studioで作成できます。 Windows PowerShell を使用して、カタログをプログラムから作成することもできます。

SQL Server Management Studio で SSISDB カタログを作成するには

SQL Server Management Studio を開きます。
SQL Server データベースエンジンに接続します。
オブジェクトエクスプローラーで、サーバーノードを展開します。次に、 [Integration Services カタログ] ノードを右クリックし、 [カタログの作成] をクリックします。
[CLR 統合を有効にする] をクリックします。

カタログは CLR ストアドプロシージャを使用します。
サーバーインスタンスを再起動するたびに catalog.startup ストアドプロシージャが実行されるようにするには、 [SQL Server のスタートアップ時に Integration Services ストアドプロシージャを自動実行できるようにする] SSIS をクリックします。

このストアドプロシージャは、SSISDB カタログに対する操作の状態のメンテナンスを実行します。 SSIS サーバーインスタンスがダウンした場合に、実行されていたパッケージの状態を修正します。
パスワードを入力し、 [OK] をクリックします。

カタログデータを暗号化するために使用されるデータベースマスターキーがパスワードで保護されます。パスワードは安全な場所に保管してください。データベースマスターキーをバックアップすることもお勧めします。詳細については、「データベースマスターキーのバックアップ」を参照してください。

SSISDB カタログをプログラムから作成するには

次の PowerShell スクリプトを実行します。

# Load the IntegrationServices Assembly  
[Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Management.IntegrationServices")  

# 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=localhost;Initial Catalog=master;Integrated Security=SSPI;"  
$sqlConnection = New-Object System.Data.SqlClient.SqlConnection $sqlConnectionString  

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

# Provision a new SSIS Catalog  
$catalog = New-Object $ISNamespace".Catalog" ($integrationServices, "SSISDB", "P@assword1")  
$catalog.Create()

Windows PowerShell と Microsoft.SqlServer.Management.IntegrationServices 名前空間の使用方法を紹介したその他の例については、blogs.msdn.com のブログエントリ「SQL Server 2012 での SSIS と PowerShell」を参照してください。名前空間とコード例の概要については、blogs.msdn.com のブログエントリ「 SSIS カタログマネージドオブジェクトモデルの概要」を参照してください。

[カタログのプロパティ] ダイアログボックス

[カタログのプロパティ] ダイアログボックスを使用すると、SSISDB カタログを構成できます。カタログプロパティは、機微なデータを暗号化する方法、操作およびプロジェクトのバージョン管理データを保持する方法、および検証操作がタイムアウトするタイミングを定義します。SSISDB カタログは、 Integration Services プロジェクト、パッケージ、パラメーター、および環境のための中央のストレージと管理ポイントです。

また、カタログプロパティを catalog.catalog_properties ビューで表示し、catalog.configure_catalog ストアドプロシージャを使用することで、これらのプロパティを設定することもできます。詳細については、「catalog.catalog_properties (SSISDB データベース)」および「catalog.configure_catalog (SSISDB データベース)」を参照してください。

目的に合ったトピックをクリックしてください

[カタログのプロパティ] ダイアログボックスを開く
オプションの構成

[カタログのプロパティ] ダイアログボックスを開く

SQL Server Management Studio を開きます。
Microsoft SQL Server データベースエンジンに接続します。
オブジェクトエクスプローラーで、 [Integration Services] ノードを展開します。 [SSISDB] を右クリックし、 [プロパティ] をクリックします。

オプションの構成

オプション

次の表では、ダイアログボックスに示される特定のプロパティと、catalog.catalog_properties ビュー内の対応するプロパティについて説明します。

プロパティ名 ([カタログのプロパティ] ダイアログボックス)	プロパティ名 (catalog.catalog_properties ビュー)	説明
暗号化アルゴリズムの名前	ENCRYPTION_ALGORITHM	カタログ内の機密性の高いパラメーター値を暗号化するために使用される暗号化の種類を指定します。使用できる値を次に示します。 DES TRIPLE_DES TRIPLE_DES_3KEY DESPX AES_128 AES_192 AES_256 (既定値)
プロジェクトごとのバージョンの最大数	MAX_PROJECT_VERSIONS	カタログに格納されるプロジェクトのバージョンの数を指定します。最大数を超えるプロジェクトの古いバージョンは、プロジェクトバージョンのクリーンアップジョブを実行したときに削除されます。
ログを定期的に消去する	OPERATION_CLEANUP_ENABLED	操作のクリーンアップ SQL Server エージェントジョブを実行することを示すには、このプロパティを True に設定します。それ以外の場合は、このプロパティを False に設定します。
保有期間 (日)	RETENTION_WINDOW	操作データの最大保有期間を日数で指定します。指定された日数を経過したデータは、操作のクリーンアップ SQL エージェントジョブによって削除されます。

SSIS カタログのバックアップ、復元、および移動

適用対象: SQL Server 2016 (13.x) and later versions Azure SQL Database Azure Synapse Analytics Analytics Platform System (PDW)

SQL Server 2019 Integration Services (SSIS) には SSISDB データベースが用意されています。 SSISDB カタログに格納されているオブジェクト、設定、および業務データを検査するには、SSISDB データベースのビューに対してクエリを実行します。このトピックでは、データベースのバックアップと復元の手順について説明します。

SSISDB カタログは、Integration Services サーバーに配置したパッケージを格納します。カタログの詳細については、「 SSIS カタログ」を参照してください。

SSIS データベースをバックアップするには

SQL Server Management Studio を開き、 SQL Serverのインスタンスに接続します。
BACKUP MASTER KEY Transact-SQL ステートメントを使用して、SSISDB データベースのマスターキーをバックアップします。このキーは指定したファイルに格納されます。ファイル内のマスターキーを暗号化するには、パスワードを使用します。

ステートメントの詳細については、「BACKUP MASTER KEY (Transact-SQL)」を参照してください。

次の例では、マスターキーが c:\temp directory\RCTestInstKey ファイルにエクスポートされます。マスターキーの暗号化には、 LS2Setup! というパスワードが使用されます。
```
backup master key to file = 'c:\temp\RCTestInstKey'  
       encryption by password = 'LS2Setup!'  
```
の [データベースのバックアップ] SQL Server Management Studioダイアログボックスを使用して SSISDB データベースをバックアップします。詳細については、「データベースをバックアップする方法 (SQL Server Management Studio) に関する記事をご覧ください。
次の手順を実行して、##MS_SSISServerCleanupJobLogin## の CREATE LOGIN スクリプトを生成します。詳細については、「CREATE LOGIN (Transact-SQL)」を参照してください。
1. SQL Server Management Studioのオブジェクトエクスプローラーで、 [セキュリティ] ノードを展開し、 [ログイン] ノードを展開します。
2. [##MS_SSISServerCleanupJobLogin##] を右クリックし、 [ログインをスクリプト化]>[CREATE]>[新しいクエリエディターウィンドウ] の順にクリックします。
SSISDB カタログが作成されていない SQL Server インスタンスに SSISDB データベースを復元する場合は、次の操作を行って、sp_ssis_startup の CREATE PROCEDURE スクリプトを生成します。詳細については、「CREATE PROCEDURE (Transact-SQL)」を参照してください。
1. オブジェクトエクスプローラーで、 [データベース] ノードを展開し、 [master]>[プログラミング]>[ストアドプロシージャ] ノードの順に展開します。
2. [dbo.sp_ssis_startup] を右クリックし、 [ストアドプロシージャをスクリプト化]>[CREATE]>[新しいクエリエディターウィンドウ] の順にクリックします。
SQL Server エージェントが起動したことを確認します。
SSISDB カタログが作成されていない SQL Server インスタンスに SSISDB データベースを復元する場合は、次の操作を行って、SSIS サーバーメンテナンスジョブのスクリプトを生成します。 SSISDB カタログが作成されると、スクリプトは SQL Server エージェントで自動的に作成されます。このジョブは、保有期間外の操作ログのクリーンアップおよび古いバージョンのプロジェクトの削除に役立ちます。
1. オブジェクトエクスプローラーで、 [SQL Server エージェント] ノードを展開し、 [ジョブ] ノードを展開します。
2. SSIS サーバーメンテナンスジョブを右クリックし、 [ジョブをスクリプト化]>[CREATE]>[新しいクエリエディターウィンドウ] の順にクリックします。

SSIS データベースを復元するには

SSISDB カタログが作成されていない SQL Server インスタンスに SSISDB データベースを復元する場合は、sp_configure ストアドプロシージャを実行して、共通言語ランタイム (CLR) を有効にします。詳細については、「sp_configure (Transact-SQL)」と「clr enabled サーバー構成オプション」を参照してください。
```
use master   
       sp_configure 'clr enabled', 1  
       reconfigure  
```
SSISDB カタログが作成されていない SQL Server インスタンスに SSISDB データベースを復元する場合は、非対称キーと非対称キーからのログインを作成し、UNSAFE 権限をログインに付与します。
```
Create Asymmetric Key MS_SQLEnableSystemAssemblyLoadingKey  
       FROM Executable File = 'C:\Program Files\Microsoft SQL Server\YourSQLServerDefaultCompatibilityLevel\DTS\Binn\Microsoft.SqlServer.IntegrationServices.Server.dll'  
```
YourSQLServerDefaultCompatibilityLevel の値は、SQL Server の既定の互換性レベルの一覧で確認することができます。

Integration Services ログインを行うには Microsoft Win32 API などの制限付きのリソースへの追加アクセスが必要であるため、CLR ストアドプロシージャでは、UNSAFE 権限をログインに付与する必要があります。 UNSAFE コード権限の要件の詳細については、「アセンブリの作成」を参照してください。
```
Create Login ##MS_SQLEnableSystemAssemblyLoadingUser## FROM Asymmetric Key MS_SQLEnableSystemAssemblyLoadingKey   
Grant Unsafe Assembly to ##MS_SQLEnableSystemAssemblyLoadingUser##    
```
の [データベースの復元] SQL Server Management Studioダイアログボックスを使用して、バックアップから SSISDB データベースを復元します。詳細については、次のトピックを参照してください。
##MS_SSISServerCleanupJobLogin##、sp_ssis_startup、および SSIS サーバーメンテナンスジョブの「 SSIS をバックアップするには」で作成したスクリプトを実行します。 SQL Server エージェントが起動したことを確認します。
次のステートメントを実行して、sp_ssis_startup プロシージャの自動実行を設定します。詳細については、「sp_procoption (Transact-SQL)」を参照してください。
```
EXEC sp_procoption N'sp_ssis_startup','startup','on'  
```
の [ログインのプロパティ] SQL Server Management Studioダイアログボックスを使用して、SSISDB ユーザーの ##MS_SSISServerCleanupJobUser## (SSISDB database) を ##MS_SSISServerCleanupJobLogin## にマップします。
次のいずれかの方法を使用して、マスターキーを復元します。暗号化の詳細については、「暗号化階層」を参照してください。
- 方法 1
  
  この方法は、データベースマスターキーのバックアップが実行済みで、マスターキーの暗号化に使用するパスワードがある場合に使用します。
```
       Restore master key from file = 'c:\temp\RCTestInstKey'  
       Decryption by password = 'LS2Setup!' -- 'Password used to encrypt the master key during SSISDB backup'  
       Encryption by password = 'LS3Setup!' -- 'New Password'  
       Force  
```
  注意
  
  SQL Server サービスアカウントにバックアップキーファイルの読み取り権限があることを確認してください。
  
  注意
  
  データベースマスターキーがサービスマスターキーによって暗号化されていない場合、SQL Server Management Studio には次の警告メッセージが表示されます。この警告メッセージは無視してください。
  
  現在のマスターキーは暗号化解除できません。 FORCE オプションが指定されたので、エラーは無視されました。
  
  FORCE 引数は、現在のデータベースマスターキーが開いていない場合でも復元プロセスを続行するように指定します。 SSISDB カタログについては、データベースを復元するインスタンスでデータベースマスターキーが開いていないため、このメッセージが表示されます。
- 方法 2
  
  この方法は、SSISDB の作成に使用した元のパスワードがある場合に使用します。
```
open master key decryption by password = 'LS1Setup!' --'Password used when creating SSISDB'  
       Alter Master Key Add encryption by Service Master Key  
```
Integration Services catalog.check_schema_version を実行して、SSISDB カタログスキーマとバイナリ (ISServerExec および SQLCLR アセンブリ) に互換性があるかどうかを確認します。
SSISDB データベースが正常に復元されたことを確認するには、SSISDB カタログに対して、 Integration Services サーバーに配置したパッケージの実行などの操作を実行します。詳細については、「Integration Services (SSIS) パッケージの実行」を参照してください。

SSIS データベースを移動するには

ユーザーデータベースの移動の手順に従います。詳細については、「ユーザーデータベースの移動」を参照してください。

SSISDB データベースのマスターキーをバックアップしてバックアップファイルを保護していることを確認します。詳細については、「 SSIS データベースをバックアップするには」を参照してください。

Integration Services (SSIS) 関連のオブジェクトが、SSISDB カタログが作成されていない新しい SQL Server インスタンスに作成されていることを確認します。

SSIS カタログ (SSISDB) のアップグレード

データベースが SQL Server インスタンスの現在のバージョンよりも古い場合、SSISDB アップグレードウィザードを実行して、SSIS カタログデータベース (SSISDB) をアップグレードしてください。データベースは、次のいずれかの条件が該当した場合は古いものである可能性があります。

古いバージョンの SQL Server からデータベースを復元した場合。
SQL Server インスタンスをアップグレードする前に Always On 可用性グループからデータベースを削除しなかった場合。このような状況では、データベースは自動アップグレードされません。詳細については、「 Upgrading SSISDB in an availability group」を参照してください。

このウィザードでは、ローカルサーバーインスタンス上のデータベースのみをアップグレードできます。

SSISDB アップグレードウィザードを実行して SSIS カタログ (SSISDB) をアップグレードする

SSIS カタログデータベース (SSISDB) をバックアップします。
SQL Server Management Studioでローカルサーバーを展開し、 [Integration Services カタログ] を展開します。
[SSISDB] を右クリックして [データベースのアップグレード] を選択し、SSISDB アップグレードウィザードを起動します。または、ローカルサーバーで管理者特権のアクセス許可を使用して C:\Program Files\Microsoft SQL Server\140\DTS\Binn\ISDBUpgradeWizard.exe を実行することにより、SSISDB アップグレードウィザードを起動します。
[インスタンスの選択] ページで、ローカルサーバー上の SQL Server インスタンスを選択します。

重要

このウィザードでは、ローカルサーバーインスタンス上のデータベースのみをアップグレードできます。

ウィザードを実行する前に SSISDB データベースをバックアップしたことを示すために、チェックボックスをオンにします。
[アップグレード] を選択して SSIS カタログデータベースをアップグレードします。
[結果] ページで結果を確認します。

Always On for SSIS Catalog (SSISDB)

Always On 可用性グループ機能は、データベースミラーリングに代わる、高可用性と災害復旧のためのエンタープライズレベルのソリューションです。可用性グループは、可用性データベースというひとまとまりでフェールオーバーされる個別のユーザーデータベースのセットのためのフェールオーバー環境をサポートします。詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

SSIS カタログ (SSISDB) とそのコンテンツ (プロジェクト、パッケージ、実行ログなど) の高可用性を実現するには、(他のユーザーデータベースと同様に) SSISDB データベースを Always On 可用性グループに追加できます。フェールオーバーが発生すると、セカンダリノードのいずれかが自動的に新しいプライマリノードになります。

注意

SQL Server 2022 で導入された包含可用性グループはまだサポートされていません。

重要

フェールオーバーが発生した場合、実行中のパッケージの再起動や再開は行われません。

このセクションの内容:

前提条件
Always On の SSIS サポートを構成する
可用性グループの SSISDB をアップグレードする

前提条件

次の前提条件手順を実行してから、SSISDB データベースの Always On サポートを有効にする必要があります。

Windows フェールオーバークラスターを設定します。手順については、「 Installing the Failover Cluster Feature and Tools for Windows Server 2012 (Windows Server 2012 のフェールオーバークラスター機能とツールのインストール) 」のブログ投稿を参照してください。すべてのクラスターノードに機能とツールをインストールします。
クラスターの各ノードに SQL Server 2016 with Integration Services (SSIS) 機能をインストールします。
SQL Server インスタンスごとに Always On 可用性グループを有効にします。詳細については、「 Always On 可用性グループの有効化と無効化 (SQL Server) 」を参照してください。

重要

可用性グループの プライマリノード で、次の手順を実行する必要があります。
SSISDB を Always On 可用性グループに追加した "後に"、Always On の SSIS サポートを有効にする必要があります。

手順 1 : Integration Services カタログを作成する

SQL Server Management Studio を起動し、SSISDB の Always On 高可用性グループの プライマリノード として設定するクラスターの SQL Server インスタンスに接続します。
オブジェクトエクスプローラーで、サーバーノードを展開します。次に、 [Integration Services カタログ] ノードを右クリックし、 [カタログの作成] をクリックします。
[CLR 統合を有効にする] をクリックします。カタログは CLR ストアドプロシージャを使用します。
サーバーインスタンスを再起動するたびに catalog.startup ストアドプロシージャが実行されるようにするには、 [SQL Server のスタートアップ時に Integration Services ストアドプロシージャを自動実行できるようにする] SSIS をクリックします。このストアドプロシージャは、SSISDB カタログに対する操作の状態のメンテナンスを実行します。 SSIS サーバーインスタンスがダウンした場合に、実行されていたパッケージの状態を修正します。
パスワードを入力し、 [OK] をクリックします。カタログデータを暗号化するために使用されるデータベースマスターキーがパスワードで保護されます。パスワードは安全な場所に保管してください。データベースマスターキーをバックアップすることもお勧めします。詳細については、「データベースマスターキーのバックアップ」を参照してください。

手順 2: SSISDB を Always On 可用性グループに追加する

SSISDB データベースを Always On 可用性グループに追加する手順は、他のユーザーデータベースを可用性グループに追加する場合とほぼ同じです。「可用性グループウィザードの使用」を参照してください。

新しい可用性グループ ウィザードの [データベースの選択] ページで SSIS カタログを作成するときに指定したパスワードを入力します。

新しい可用性グループ

重要

フェールオーバー後にマスターキーの問題を回避するには、データベースの完全バックアップとログバックアップの方法を使用して、SSISDB データベースを Always On 可用性グループに追加します。

手順 3: Always On の SSIS サポートを有効にする

Integration Service カタログを作成したら、Integration Service Catalogs ノードを右クリックし、[Always On のサポートを有効にする] をクリックします。次の [Always On のサポートを有効にする] ダイアログボックスが表示されます。このメニュー項目が無効な場合、すべての前提条件がインストールされていることを確認してから、 [更新] をクリックします。

Always On のサポートを有効にする

警告

SSISDB データベースの自動フェールオーバーをサポートするには、Always On のSSIS のサポートを有効にする必要があります。

Always On 可用性グループから新しく追加したセカンダリレプリカが一覧に表示されます。一覧の各レプリカの [接続] をクリックし、認証資格情報を入力してレプリカに接続します。 Always On の SSIS サポートを有効にするには、ユーザーアカウントは、各レプリカの sysadmin グループのメンバーである必要があります。各レプリカに正常に接続できたら、 [OK] をクリックして、Always On の SSIS のサポートを有効にします。

他の前提条件を満足した後で、コンテキストメニューの [Enable Always On support] (Always On サポートの有効化) が無効にオプションとして表示される場合は、次の操作を試してみてください。

[更新] オプションをクリックして、コンテキストメニューを更新します。
プライマリノードに接続されていることを確認します。プライマリノードでは Always On サポートを有効にする必要があります。
SQL Server のバージョンが 13.0 以上であることを確認します。 SSIS は、SQL Server 2016 以降のバージョンでのみ Always On をサポートします。

可用性グループの SSISDB をアップグレードする

以前のバージョンから SQL Server をアップグレードするとき、SSISDB が Always On 可用性グループに含まれる場合、"Always On 可用性グループの SSISDB の確認" ルールでアップグレードがブロックされることがあります。このブロックが発生するのは、可用性データベースがマルチユーザーデータベースである必要があるにもかかわらず、アップグレードがシングルユーザーモードで実行されたためです。そのため、アップグレードまたは修正プログラムの適用中には、SSISDB を含むすべての可用性データベースがオフラインになり、アップグレードまたは修正プログラムの適用が行われません。アップグレードを続行するには、まず可用性グループから SSISDB を削除し、次に各ノードのアップグレードまたは修正プログラムの適用を行い、さらに SSISDB を可用性グループに追加します。

"Always On 可用性グループ内の SSISDB の確認" ルールでブロックされる場合、次の手順に従って SQL Server をアップグレードします。

可用性グループから SSISDB を削除します。詳細については、「可用性グループからのセカンダリデータベースの削除 (SQL Server)」および「可用性グループからのプライマリデータベースの削除 (SQL Server)」を参照してください。
アップグレードウィザードで [再実行] をクリックします。 "Always On 可用性グループ内の SSISDB の確認" ルールに合格します。
[次へ] をクリックしてアップグレードを続行します。
すべてのノードをアップグレードしたら、SSISDB データベースを Always On 可用性グループに追加します。詳細については、「可用性グループへのデータベースの追加 (SQL Server)」を参照してください。

SQL Server のアップグレード時にブロックされず、SSISDB が Always On 可用性グループに属している場合、SQL Server データベースエンジンをアップグレードした後に、別に SSISDB をアップグレードします。次の手順で、SSIS アップグレードウィザードを使用して SSISDB をアップグレードします。

可用性グループから SSISDB データベースを削除するか、SSISDB が可用性グループで唯一のデータベースの場合は可用性グループを削除します。このタスクを実行するには、可用性グループの プライマリノードで SQL Server Management Studio を起動します。
すべての レプリカノードから SSISDB データベースを削除します。
プライマリノードの SSISDB データベースをアップグレードします。 SQL Server Management Studio のオブジェクトエクスプローラー で、 [Integration Service カタログ] を展開し、 [SSISDB] を右クリックし、 [データベースアップグレード] を選択します。 SSISDB アップグレードウィザード の指示に従ってデータベースをアップグレードします。 SSIDB アップグレードウィザード は、プライマリノードのローカルで起動します。
「ステップ 2:SSISDB を Always On 可用性グループに追加する」の手順に従って、SSISDB を可用性グループに追加します。
「手順 3 : Always On の SSIS サポートを有効にする」の手順に従います。

ダブルホップシナリオでの SSISDB カタログと委任

既定では、SSISDB カタログに格納されている SSIS パッケージのリモート呼び出しは、資格情報の委任 (ダブルホップと呼ばれることもあります) をサポートしません。

ユーザーがクライアントコンピューター A にログインし、SQL Server Management Studio (SSMS) を起動するシナリオについて考えてみましょう。 SSMS 内から、ユーザーは SSISDB カタログを持つコンピューター B でホストされている SQL server に接続します。 SSIS パッケージはこの SSISDB カタログに格納され、このパッケージはコンピューター C で実行されている SQL Server サービスに接続します (パッケージは他のサービスにもアクセスしている可能性があります)。ユーザーがコンピューター A から SSIS パッケージの実行を呼び出すと、まず SSMS で、コンピューター A からコンピューター B (SSIS ランタイムプロセスによってパッケージが実行されている場所) にユーザーの資格情報が正常に渡されます。ここで、正常に実行が完了するように、SSIS 実行ランタイムプロセス (ISServerExec.exe) によるコンピューター B からコンピューター C へのユーザー資格情報の委任が必要となります。ただし、資格情報の委任は、既定では有効になっていません。

ユーザーは、 [任意のサービスへの委任でこのユーザーを信頼する (Kerberos のみ)] の権限を (コンピューター B で) SQL Server のサービスアカウントに対して許可することで、資格情報の委任を有効にすることができます。これにより、ISServerExec.exe が子プロセスとして起動します。このプロセスは、SQL Server サービスアカウントに対する無制限の委任または自由な委任の設定と呼ばれます。この権限を付与する前に、組織のセキュリティ要件を満たしているかどうかを検討してください。

SSISDB は、制約付き委任をサポートしません。ダブルホップ環境では、SSISDB カタログをホストする SQL Server のサービスアカウント (この例ではコンピューター B) が制約付き委任に対して設定されている場合、ISServerExec.exe でこの資格情報を 3 番目のコンピューター (コンピューター C) に委任することはできません。これは、Windows Credential Guard が有効になっているシナリオに適用されます。このシナリオでは、制約付き委任の設定が必要となります。

次の方法で共有

SSIS カタログ

特徴と機能

カタログ オブジェクト識別子

フォルダー、プロジェクト、環境

パラメーター

環境変数

カタログの構成

操作とプロジェクト バージョンのクリーンアップ

暗号化アルゴリズム

アクセス許可

権限の管理

フォルダー

プロジェクトとパッケージ

パラメーター

サーバー環境、サーバー変数、およびサーバー環境参照

実行と検証

SSIS カタログの作成

SQL Server Management Studio で SSISDB カタログを作成するには

SSISDB カタログをプログラムから作成するには

[カタログのプロパティ] ダイアログ ボックス

[カタログのプロパティ] ダイアログ ボックスを開く

オプションの構成

オプション

SSIS カタログのバックアップ、復元、および移動

SSIS データベースをバックアップするには

SSIS データベースを復元するには

SSIS データベースを移動するには

SSIS カタログ (SSISDB) のアップグレード

SSISDB アップグレード ウィザードを実行して SSIS カタログ (SSISDB) をアップグレードする

Always On for SSIS Catalog (SSISDB)

前提条件

Always On の SSIS サポートを構成する

手順 1 : Integration Services カタログを作成する

手順 2: SSISDB を Always On 可用性グループに追加する

手順 3: Always On の SSIS サポートを有効にする

可用性グループの SSISDB をアップグレードする

ダブルホップ シナリオでの SSISDB カタログと委任

関連コンテンツ

フィードバック

その他のリソース

カタログオブジェクト識別子

操作とプロジェクトバージョンのクリーンアップ

[カタログのプロパティ] ダイアログボックス

[カタログのプロパティ] ダイアログボックスを開く

SSISDB アップグレードウィザードを実行して SSIS カタログ (SSISDB) をアップグレードする

ダブルホップシナリオでの SSISDB カタログと委任