sys.dm_exec_xml_handles （Transact-SQL）
適用於：
SQL ServerAzure SQL 受控執行個體
傳回已由 sp_xml_preparedocument 開啟之使用中句柄的相關信息。
語法
dm_exec_xml_handles (session_id | 0 )
引數
session_id | 0，
工作階段的識別碼。 如果 指定session_id ，此函式會傳回指定會話中 XML 句柄的相關信息。
如果指定 0，函式會傳回所有工作階段之所有 XML 句柄的相關信息。
傳回的資料表
| 資料行名稱 | 資料類型 | 描述 |
|---|---|---|
| session_id | int | 保存此 XML 檔句柄之工作階段的作業階段識別碼。 |
| document_id | int | sp_xml_preparedocument所 傳回的 XML 檔句柄標識碼。 |
| namespace_document_id | int | 用於傳遞為第三個參數之相關聯命名空間檔的內部句柄標識碼，以 sp_xml_preparedocument。 如果沒有命名空間檔，則為 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 呼叫之後的毫秒。 |
備註
sql_handles存留期，用來擷取執行呼叫的SQL文字，sp_xml_preparedocument快取計劃用來執行查詢。 如果快取中無法使用查詢文字，就無法使用函式結果中提供的資訊來擷取數據。 如果您正在執行許多大型批次，就會發生這種情況。
權限
需要伺服器上的 VIEW SERVER STATE 許可權，才能查看呼叫端未擁有的所有作業階段或會話識別碼。 呼叫端一律可以看到自己目前會話標識符的數據。
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)