XML for Analysis (XMLA) の Subscribe コマンドを使用して、Microsoft SQL Server Analysis Services のインスタンスで定義されている既存のトレースを監視できます。
Subscribe コマンドは、トレースの結果を行セットとして返します。
トレースの指定
Subscribe コマンドの Object プロパティには、Analysis Services インスタンスまたは Analysis Services インスタンスのトレースへのオブジェクト参照が含まれている必要があります。
Object プロパティが指定されていない場合、またはトレース識別子が Object プロパティで指定されていない場合、Subscribe コマンドは、コマンドの SOAP ヘッダーで指定された明示的なセッションの既定のセッション トレースを監視します。
結果を返す
Subscribe コマンドは、指定したトレースによってキャプチャされたトレース イベントを含む行セットを返します。
Subscribe コマンドは、Cancel コマンドによってコマンドが取り消されるまでトレース結果を返します。
行セットには、次の表に示す列が含まれています。
| コラム | データの種類 | 説明 |
|---|---|---|
| EventClass | 整数 | トレースによって受信されたイベントのイベント クラス。 |
| EventSubclass | 長整数 | トレースによって受信されたイベントのイベント サブクラス。 |
| CurrentTime | 日時 | イベントが開始された時刻 (使用可能な場合)。 フィルター処理の場合、予期される形式は 'YYYY-MM-DD' と 'YYYY-MM-DD HH:MM:SS' です。 |
| 開始時間 | 日時 | イベントが開始された時刻 (使用可能な場合)。 フィルター処理の場合、予期される形式は 'YYYY-MM-DD' と 'YYYY-MM-DD HH:MM:SS' です。 |
| 終了時間 | 日時 | イベントが終了した時刻 (使用可能な場合)。 フィルター処理の場合、予期される形式は 'YYYY-MM-DD' と 'YYYY-MM-DD HH:MM:SS' です。 この列は、プロセスまたはアクションの開始を記述するイベント クラスには設定されません。 |
| 期間 | 長整数 | イベントの合計時間 (ミリ秒) の経過時間。 |
| CPU使用時間 | 長整数 | イベントのプロセッサ時間 (ミリ秒) の経過時間。 |
| JobID | 長整数 | プロセスのジョブ識別子。 |
| SessionID | 糸 | イベントが発生したセッションの識別子。 |
| セッションタイプ | 糸 | イベントが発生したセッションの種類。 |
| 進捗合計 | 長整数 | イベントによって報告された進行状況の合計数または量。 |
| 整数データ | 長整数 | イベントに関連付けられている整数データ。 この列の内容は、イベントのイベント クラスとサブクラスによって異なります。 |
| オブジェクトID | 糸 | イベントが発生したオブジェクトの識別子。 |
| オブジェクトタイプ | 糸 | ObjectName で指定されたオブジェクトの型。 |
| オブジェクト名 | 糸 | イベントが発生したオブジェクトの名前。 |
| オブジェクトパス | 糸 | イベントが発生したオブジェクトの階層パス。 パスは、ObjectName で指定されたオブジェクトの親のオブジェクト識別子のコンマ区切りの文字列として表されます。 |
| ObjectReference | 糸 | ObjectName で指定されたオブジェクトのオブジェクト参照の XML 表現。 |
| NestLevel | 整数 | イベントが発生したトランザクションのレベル。 |
| NumSegments | 長整数 | イベントが発生したコマンドによって影響を受ける、またはアクセスされたデータ セグメントの数。 |
| 深刻さ | 整数 | イベントの例外の重大度レベル。 列には、次のいずれかの値を含めることができます。 値: 0 = 成功 値: 1 = 情報 値: 2 = 警告 値: 3 = エラー |
| 成功 | ボーリアン | コマンドが成功したか失敗したかを示します。 |
| エラー | 長整数 | イベントのエラー番号 (該当する場合)。 |
| 接続ID | 糸 | イベントが発生した接続の識別子。 |
| データベース名 | 糸 | イベントが発生したデータベースの名前。 |
| NTユーザー名 (NTUserName) | 糸 | イベントに関連付けられているユーザーの Windows ユーザー名。 |
| NTドメインネーム | 糸 | イベントに関連付けられているユーザーの Windows ドメイン。 |
| クライアントホスト名 | 糸 | クライアント アプリケーションが実行されているコンピューターの名前。 この列には、クライアント アプリケーションによって渡された値が格納されます。 |
| ClientProcessID | 長整数 | クライアント アプリケーションのプロセス識別子。 |
| アプリケーション名 | 糸 | Analysis Services インスタンスへの接続を作成したクライアント アプリケーションの名前。 この列には、プログラムの表示名ではなく、クライアント アプリケーションによって渡された値が設定されます。 |
| NTCanonicalUserName | 糸 | イベントに関連付けられているユーザーの Windows 正規ユーザー名。 |
| SPID (サービスプロバイダーID) | 糸 | イベントが発生したセッションのサーバー プロセス ID (SPID)。 この列の値は、イベントが発生した XMLA メッセージの SOAP ヘッダーで指定されたセッション ID に直接対応します。 |
| テキストデータ | 糸 | イベントに関連付けられているテキスト データ。 この列の内容は、イベントのイベント クラスとサブクラスによって異なります。 |
| サーバー名 | 糸 | イベントが発生した Analysis Services インスタンスの名前。 |
| リクエストパラメータ | 糸 | イベントが発生したパラメーター化クエリまたは XMLA コマンドのパラメーター。 |
| RequestProperties | 糸 | イベントが発生した XMLA メソッドのプロパティ。 |