WMI イベント監視タスク
適用対象: 
SQL Server Azure Data Factory の SSIS 統合ランタイム
WMI イベント監視タスクは、Windows Management Instrumentation Query Language (WQL) イベント クエリを使用して対象のイベントを指定することにより、Windows Management Instrumentation (WMI) イベントを監視します。 WMI イベント監視タスクは、次の目的で使用できます。
ファイルがフォルダーに追加されたという通知を待機し、ファイルの処理を開始します。
サーバー上の利用可能なメモリが、指定した割合を下回った場合、ファイルを削除するパッケージを実行します。
アプリケーションのインストールを監視し、そのアプリケーションを使用するパッケージを実行します。
Integration Services には、WMI 情報を読み取るタスクが含まれています。
このタスクの詳細については、次のトピックを参照してください。
WQL クエリ
WQL は SQL 言語仕様の 1 つで、WMI イベント通知やその他 WMI 固有の機能をサポートする拡張機能が付いています。 WQL の詳細については、Windows Management Instrumentation のマニュアルをご覧ください。
注意
WMI クラスは、Windows のバージョンによって異なります。
次のクエリは、CPU 使用率が 40% を超えた場合の通知を監視します。
SELECT * from __InstanceModificationEvent WITHIN 2 WHERE TargetInstance ISA 'Win32_Processor' and TargetInstance.LoadPercentage > 40
次のクエリは、ファイルがフォルダーに追加された場合の通知を監視します。
SELECT * FROM __InstanceCreationEvent WITHIN 10 WHERE TargetInstance ISA "CIM_DirectoryContainsFile" and TargetInstance.GroupComponent= "Win32_Directory.Name=\"c:\\\\WMIFileWatcher\""
WMI イベント監視タスクで使用できるカスタム ログ メッセージ
次の表は、WMI イベント監視タスクのカスタム ログ エントリの一覧です。 詳細については、「 Integration Services (SSIS) のログ記録」を参照してください。
| ログ エントリ | 説明 |
|---|---|
| WMIEventWatcherEventOccurred | タスクが監視しているイベントが発生したことを示します。 |
| WMIEventWatcherTimedout | タスクがタイムアウトしたことを示します。 |
| WMIEventWatcherWatchingForWMIEvents | タスクが WQL クエリの実行を開始したことを示します。 このエントリには、クエリが含まれています。 |
WMI イベント監視タスクの構成
WMI データ リーダー タスクは、次の方法で構成できます。
使用する WMI 接続マネージャーを指定します。
WQL クエリの実行元を指定します。 実行元には、タスクの外部の変数またはファイルを設定できます。また、クエリはタスクのプロパティ内に格納できます。
WMI イベントが発生したときにタスクが実行するアクションを指定します。 イベント通知およびイベント後の状態のログが記録できます。または、WMI イベント、通知、およびイベント後の状態に関連する情報を提供する、 Integration Services のカスタム イベントを発生させることができます。
イベントに対するタスクの応答方法を定義します。 タスクは、イベントに応じて、成功または失敗するように構成できます。または、単にイベントを再度監視するように構成することもできます。
WMI クエリがタイムアウトしたときに、タスクが実行するアクションを指定します。タイムアウトとタイムアウト後の状態のログを記録できます。または、 Integration Services のカスタム イベントを発生させ、WMI イベントのタイムアウトを示し、タイムアウトとタイムアウトの状態のログを記録できます。
タイムアウトに対するタスクの応答方法を定義します。タスクは成功または失敗するように構成できます。または、単にイベントを再度監視するように構成することもできます。
タスクがイベントを監視する回数を指定します。
タイムアウトを指定します。
監視元がファイルの場合、WMI イベント監視タスクは、ファイル接続マネージャーを使用してファイルに接続します。 詳しくは、「 フラット ファイル接続マネージャー」をご覧ください。
WMI イベント監視タスクは、WMI 接続マネージャーを使用して、WMI 情報を読み取るサーバーに接続します。 詳細については、「 WMI 接続マネージャー」をご覧ください。
プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。
SSIS デザイナーで設定できるプロパティの詳細については、次のトピックを参照してください。
SSIS デザイナーでこれらのプロパティを設定する方法については、次のトピックを参照してください。
プログラムによる WMI イベント監視タスクの構成
プログラムによってこれらのプロパティを設定する方法の詳細については、次のトピックを参照してください。
[WMI イベント監視タスク エディター] ([全般] ページ)
[WMI イベント監視タスク エディター] ダイアログ ボックスの [全般] ページを使用すると、WMI イベント監視タスクに名前を付けて説明を記述することができます。
WQL (WMI Query Language) の詳細については、MSDN ライブラリにある Windows Management Instrumentation のトピック「 WQL を使用したクエリ」を参照してください。
Options
名前
WMI イベント監視タスクに一意の名前を提供します。 この名前は、タスク アイコンのラベルとして使用されます。
Note
タスク名はパッケージ内で一意である必要があります。
説明
WMI イベント監視タスクの説明を入力します。
[WMI イベント監視タスク エディター] ([WMI オプション] ページ)
[WMI イベント監視タスク エディター] ダイアログ ボックスの [WMI オプション] ページを使用すると、WQL (Windows Management Instrumentation Query Language) クエリのソースや、WMI イベント監視タスクがどのように WMI (Microsoft Windows Instrumentation) イベントに応答するかを指定できます。
WQL (WMI Query Language) の詳細については、MSDN ライブラリにある Windows Management Instrumentation のトピック「 WQL を使用したクエリ」を参照してください。
静的オプション
[WMIConnectionName]
WMI 接続マネージャーを一覧から選択するか、<新しい WMI 接続...> をクリックして新しい接続マネージャーを作成します。
関連トピック: WMI 接続マネージャー、WMI 接続マネージャー エディター
[WQLQuerySourceType]
タスクで実行する WQL クエリのソースの種類を選択します。 このプロパティのオプションを次の表に示します。
| 値 | 説明 |
|---|---|
| [直接入力] | ソースを WQL クエリに設定します。 この値を選択すると、動的オプションの [WQLQuerySource] が表示されます。 |
| [ファイル接続] | WQL クエリを含むファイルを選択します。 この値を選択すると、動的オプションの [WQLQuerySource] が表示されます。 |
| 変数 | ソースを、WQL クエリを定義する変数に設定します。 この値を選択すると、動的オプションの [WQLQuerySource] が表示されます。 |
[ActionAtEvent]
WMI イベントをログに記録すると共に SSIS アクションを実行するか、単にイベントをログに記録するだけにするかを指定します。
[AfterEvent]
WMI イベントを受け取った後にタスクを成功または失敗させるか、イベントの発生をタスクで引き続き監視するかを指定します。
[ActionAtTimeout]
WMI クエリのタイムアウトをログに記録すると共に SSIS イベントを発生させるか、単にタイムアウトをログに記録するだけにするかを指定します。
[AfterTimeout]
タイムアウトに対してタスクを成功または失敗させるか、別のタイムアウトの発生をタスクで引き続き監視するかを指定します。
[NumberOfEvents]
監視するイベントの数を指定します。
タイムアウト
イベントが発生するのを待機する秒数を指定します。 値 0 は、タイムアウトを設定しないことを意味します。
[WQLQuerySource] の動的オプション
[WQLQuerySource] = [直接入力]
[WQLQuerySource]
クエリを指定します。または、参照ボタン ( [...] ) をクリックし、 [WQL クエリ] ダイアログ ボックスを使用してクエリを入力します。
[WQLQuerySource] = [ファイル接続]
[WQLQuerySource]
ファイル接続マネージャーを一覧から選択するか、[新しい接続] をクリックして新しい接続マネージャーを作成します。
関連トピック: 接続マネージャー、ファイル接続マネージャー エディター
[WQLQuerySource] = [変数]
[WQLQuerySource]
一覧で変数を選択するか、<[新しい変数...]> をクリックして新しい変数を作成します。
関連トピック: Integration Services (SSIS) の変数、変数の追加