再生結果の確認

  • [アーティクル]

適用対象: SQL Server 2016 (13.x)、 SQL Server 2017 (14.x)、および SQL Server 2019 (15.x)

重要

SQL Server 分散再生は、SQL Server 2022 (16.x) では使用できません。

Microsoft SQL Server 分散再生機能による分散再生の完了後、各クライアントの再生アクティビティをキャプチャし、クライアントごとに結果トレース ファイルに保存できます。 このアクティビティをキャプチャするには、 replay オプションを使って管理ツールを実行するときに -o パラメーターを使用する必要があります。 replay オプションの詳細については、「replay オプション (分散再生管理ツール)」を参照してください。

結果トレース ファイルの保存場所は、各クライアントにあるクライアント構成ファイル <ResultDirectory> 内の DReplayClient.xmlXML 要素で指定されます。 クライアント結果ディレクトリ内のトレース ファイルは、再生を実行するたびに上書きされます。

結果トレース ファイルにキャプチャする必要がある出力の種類を指定するには、再生構成ファイル DReplay.exe.replay.configを変更します。 <OutputOptions> XML 要素を使用して、行数または結果セットの内容を記録するかどうかを指定できます。

これらの構成設定の詳細については、「 Distributed Replay の構成」を参照してください。

結果トレース ファイルでキャプチャされるイベント クラス

次の表は、結果トレース データでキャプチャされるすべてのイベント クラスを示したものです。

カテゴリ イベント クラス名 キャプチャ頻度 キャプチャするタイミング
再生可能なイベント Audit Login 元のトレース データの各 Audit Login イベントにつき 1 回 イベントの正常完了時または失敗時
Audit Logout 元のトレース データの各 Audit Logout イベントにつき 1 回 イベントの正常完了時または失敗時
SQL:BatchCompleted 元のトレース データの各 SQL:BatchStarting イベントにつき 1 回 イベントの正常完了時または失敗時
RPC:Completed 元のトレース データの各 RPC:Starting イベントにつき 1 回 イベントの正常完了時または失敗時
統計情報と結果 Replay Settings Event 1 回 結果トレースの最初のイベント
Replay Statistics Event 1 回 結果トレースの最後のイベント
Replay Result Set Event 各 SQL:BatchStarting および RPC:Starting イベントにつき 1 回。

再生構成ファイルの <RecordResultSet> オプションの値が Yesに設定されている場合のみキャプチャされます。
Replay Result Row Event SQL:BatchStarting および RPC:Starting イベントの結果セットの各行につき 1 回。

再生構成ファイルの <RecordResultSet> オプションの値が Yesに設定されている場合のみキャプチャされます。
エラーおよび警告 Replay Internal Error 各内部エラーにつき 1 回 内部エラー条件による
Replay Provider Error 各プロバイダー エラーにつき 1 回 プロバイダー エラー条件による

次のことを考慮してください。

  • ターゲット サーバーで正常に再生される各イベントに対して、対応する出力イベント クラスは 1 つです。

  • それぞれのイベントの失敗またはキャンセルに対して、複数のエラーが生成される可能性があります。

イベント クラス列マッピング

次の図は、再生中にキャプチャされるイベント クラスのそれぞれの種類に対して使用できる結果トレースの列を示しています。

イベント クラス列マッピング

結果トレースの列の説明

次の表では、結果トレース データの列について説明します。

データ列名 データ型 説明 列 ID
EventClass nvarchar イベント クラスの名前。 1
EventSequence bigint プロバイダー エラー、内部エラー、および警告に対しては、これはエラーまたは警告に対応するキャプチャ イベント シーケンスです。

その他のすべてのイベント クラスに対しては、これは元のトレース データ内のイベント シーケンスです。		 2
ReplaySequence bigint プロバイダー エラー、内部エラー、および警告に対しては、これはエラーまたは警告に対応する再生イベント シーケンスです。

その他のすべてのイベント クラスに対しては、これは再生中に割り当てられるイベント シーケンスです。		 3
TextData ntext TextData の内容は、EventClass に依存します。

Audit Login および ExistingConnection では、これは接続の設定オプションです。

SQL:BatchStarting では、これはバッチ要求の本文です。

RPC:Starting では、これは呼び出されたストアド プロシージャです。

Replay Settings Event では、この列には再生構成ファイルで定義された設定が含まれます。

Replay Statistics Event では、これは次の情報を含みます。

- 再生対象 SQL Server

\- 再生可能なイベントの総数

\- プロバイダー エラーの数

\- 内部エラーの数

\- 内部の警告

\- エラーの総数

\- 全体のパス レート

\- 再生時間 (HH:MM:SS: MMM)

Replay Result Set Event では、これは返される結果の列ヘッダーのリストを示します。

Replay Result Row Event では、その行のすべての列の戻り値を示します。

Replay Internal Warning および Replay Provider Error では、この列はプロバイダー警告またはエラーを含みます。		 4
Attention bigint イベントのアテンション期間 (マイクロ秒)。 これは、キャプチャ トレースのアテンション イベントから計算されます。 イベントにクエリ タイムアウトが指定されていない場合は、この列は設定されません (null)。 5
SubmitTime datetime イベントが SQL Serverに送信された時刻。 6
IsSuccessful int 特定のイベントが正常に実行されたかどうか、および結果セットがクライアント側に返されたかどうかを示すブール型のフラグ。

警告を生成するイベント (アテンションまたはユーザー定義のタイムアウトにより、イベントが取り消された場合など) は成功と見なされます。

IsSuccessful の値は、次のいずれかです。

1 = 成功

0 = 失敗		 7
Duration [microsec] bigint イベントの応答時間の期間 (マイクロ秒)。 SQL Serverにログオン/ログオフ/RPC/言語イベントが送信されたときに測定が開始されます。

イベントが成功した場合は、完全な結果セットが使用されたときに測定が終了します。

イベントが成功しなかった場合は、イベントの失敗時またはキャンセル時に測定が終了します。		 8
RowCount bigint 再生構成ファイルの <RecordRowCount> の値によって設定されます。

<RecordRowCount> が Yes と等しい場合、このセルには SQL Serverで返される結果セット内の行数が含まれます。

<RecordRowCount> が No と等しい場合、このセルは設定されません (null)。		 9
CaptureSPID int イベントのキャプチャ セッションの ID。 10
ConnectionID int イベントのキャプチャ接続の ID。 11
ReplaySPID int イベントの再生セッションの ID。 12
DatabaseName nvarchar ユーザーのステートメントが実行されているデータベースの名前。 13
LoginName nvarchar ユーザーのログイン名。 SQL Server セキュリティ ログイン、または domain_name\user_nameの形式で表された Microsoft Windows ログイン資格情報です。 14
CaptureHostName nvarchar キャプチャ中にクライアント サービスが実行されているコンピューターの名前。 15
ReplayHostName nvarchar 再生中にクライアントが実行されているコンピューターの名前。 16
ApplicationName nvarchar キャプチャ中に SQL Server 接続を作成したクライアント アプリケーションの名前。 17

関連項目