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_handlestatement_end_offset、およびsys.dm_exec_sql_text動的管理機能と共に使用して、要求に対して現在実行中のステートメントを取得できます。
statement_end_offset int sp_xml_preparedocument呼び出しが発生する現在実行中のバッチまたはストアド プロシージャの文字数。 sql_handlestatement_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)