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