プログラムによるパッケージの実行の管理
適用対象: SQL Server
Azure Data Factory の SSIS 統合ランタイム
プログラムによって Integration Services パッケージを操作する際に、現在実行中のパッケージを特定することが必要な場合があります。 Application 名前空間の Microsoft.SqlServer.Dts.Runtime クラスは、これらの要件を満たすメソッドとクラスを提供します。
パッケージの監視の詳細については、「パッケージの管理 (SSIS サービス)」を参照してください。
このトピックで説明するすべてのメソッドには、Microsoft.SqlServer.ManagedDTS アセンブリへの参照が必要です。 新しいプロジェクトに参照を追加した後、using または Imports ステートメントを使って Microsoft.SqlServer.Dts.Runtime 名前空間をインポートします。
重要
SSIS パッケージ ストアを操作するための Application クラスのメソッドでは、"."、localhost、またはローカル サーバーのサーバー名のみがサポートされます。 "(local)" は使用できません。
現在実行中のパッケージの特定
特定のサーバーでどのパッケージが現在実行されているかを調べるには、GetRunningPackages メソッドを呼び出します。 このメソッドは、RunningPackages オブジェクトの RunningPackage コレクションを返します。
注意
管理者に対しては、現在コンピューターで実行されているすべてのパッケージが表示されます。他のユーザーに対しては、自分が起動したパッケージのみが表示されます。
実行中のパッケージの操作
現在実行中のパッケージを特定した後、そのパッケージの情報を取得したり、パッケージの停止を要求することができます。
実行中のパッケージの情報の取得
RunningPackages コレクションを反復処理するときに、RunningPackage オブジェクトのプロパティを使用して、パッケージを探したり、実行中のパッケージに関する追加情報を取得することができます。
実行中のパッケージの停止
Stop オブジェクトの RunningPackage メソッドを呼び出して、そのパッケージを停止するように要求できます。 停止要求が発行されてからパッケージが実際に停止するまでの間に遅延が発生する場合があります。