sys.dm_exec_xml_handles (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
sp_xml_preparedocumentによって開かれたアクティブなハンドルに関する情報を返します。
構文
dm_exec_xml_handles (session_id | 0 )
引数
session_id | 0,
セッションの ID。 session_idが指定されている場合、この関数は指定されたセッションの XML ハンドルに関する情報を返します。
0 を指定した場合、この関数ではすべてのセッションのすべての XML ハンドルに関する情報が返されます。
返されるテーブル
| 列名 | データ型 | 説明 |
|---|---|---|
| session_id | int | この XML ドキュメント ハンドルを保持するセッションのセッション ID。 |
| document_id | int | sp_xml_preparedocumentによって返される XML ドキュメント ハンドル ID。 |
| namespace_document_id | int | sp_xml_preparedocumentする 3 番目のパラメーターとして渡された、関連付けられている名前空間ドキュメントに使用される内部ハンドル ID。 名前空間ドキュメントがない場合は NULL になります。 |
| sql_handle | varbinary(64) | ハンドルが定義されている SQL コードのテキストへのハンドル。 |
| statement_start_offset | int | sp_xml_preparedocument呼び出しが発生する現在実行中のバッチまたはストアド プロシージャの文字数。 sql_handle、statement_end_offset、およびsys.dm_exec_sql_text動的管理機能と共に使用して、要求に対して現在実行中のステートメントを取得できます。 |
| statement_end_offset | int | sp_xml_preparedocument呼び出しが発生する現在実行中のバッチまたはストアド プロシージャの文字数。 sql_handle、statement_start_offset、およびsys.dm_exec_sql_text動的管理機能と共に使用して、要求に対して現在実行中のステートメントを取得できます。 |
| creation_time | datetime | sp_xml_preparedocumentが呼び出されたときのタイムスタンプ。 |
| original_document_size_bytes | bigint | 解析されていない XML ドキュメントのサイズ (バイト単位)。 |
| original_namespace_document_size_bytes | bigint | 解析されていない XML 名前空間ドキュメントのサイズ (バイト単位)。 名前空間ドキュメントがない場合は NULL になります。 |
| num_openxml_calls | bigint | このドキュメント ハンドルを使用した OPENXML 呼び出しの数。 |
| row_count | bigint | このドキュメント ハンドルに対する以前のすべての OPENXML 呼び出しによって返される行の数。 |
| dormant_duration_ms | bigint | 最後の OPENXML 呼び出しからのミリ秒。 OPENXML が呼び出されていない場合は、 sp_xml_preparedocument 呼び出しからミリ秒を返します。 |
解説
sp_xml_preparedocumentの呼び出しを実行した SQL テキストを取得するために使用されるsql_handlesの有効期間は、クエリの実行に使用されるキャッシュされたプランの有効期間を上回ります。 クエリ テキストがキャッシュ内で使用できない場合は、関数の結果に示された情報を使用してデータを取得することはできません。 これは、多数の大規模なバッチを実行している場合に発生する可能性があります。
アクセス許可
呼び出し元が所有していないすべてのセッションまたはセッション ID を表示するには、サーバーに対する VIEW SERVER STATE 権限が必要です。 呼び出し元は、自分の現在のセッション ID のデータをいつでも確認できます。
SQL Server 2022 以降でのアクセス許可
サーバーに対する VIEW SERVER PERFORMANCE STATE アクセス許可が必要です。
例
次の例では、アクティブ ハンドルをすべて選択します。
SELECT * FROM sys.dm_exec_xml_handles(0);
参照
動的管理ビューと動的管理関数 (Transact-SQL)
実行関連の動的管理ビューと関数 (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)