sys.dm_exec_xml_handles (Transact-SQL)
Şunlar için geçerlidir:
SQL ServerAzure SQL Yönetilen Örneği
sp_xml_preparedocumenttarafından açılmış olan etkin tanıtıcılar hakkındaki bilgileri döndürür.
Sözdizimi
dm_exec_xml_handles (session_id | 0 )
Bağımsız değişken
session_id | 0,
Oturumun kimliği.
session_id belirtilirse, bu işlev belirtilen oturumdaki XML tanıtıcıları hakkındaki bilgileri döndürür.
0 belirtilirse, işlev tüm oturumlar için tüm XML tanıtıcıları hakkındaki bilgileri döndürür.
Döndürülen Tablo
| Sütun adı | Veri tipi | Açıklama |
|---|---|---|
| session_id | int | Bu XML belge tutamacını barındıran oturumun oturum kimliği. |
| document_id | int | sp_xml_preparedocumenttarafından döndürülen XML belgesi tanıtıcı kimliği. |
| namespace_document_id | int | sp_xml_preparedocumentüçüncü parametre olarak geçirilen ilişkili ad alanı belgesi için kullanılan iç tanıtıcı kimliği. Ad alanı belgesi yoksa NULL. |
| sql_handle | varbinary(64) | Tanıtıcının tanımlandığı SQL kodunun metnine ilişkin tanıtıcı. |
| statement_start_offset | int | sp_xml_preparedocument çağrısının gerçekleştiği şu anda yürütülen toplu işlem veya saklı yordamdaki karakter sayısı. sql_handle, statement_end_offsetve sys.dm_exec_sql_text dinamik yönetim işleviyle birlikte istek için şu anda yürütülen deyimini almak için kullanılabilir. |
| statement_end_offset | int | sp_xml_preparedocument çağrısının gerçekleştiği şu anda yürütülen toplu işlem veya saklı yordamdaki karakter sayısı. sql_handle, statement_start_offsetve sys.dm_exec_sql_text dinamik yönetim işleviyle birlikte kullanılarak istek için şu anda yürütülen deyimi alınabilir. |
| creation_time | datetime |
sp_xml_preparedocument çağrıldığı zaman damgası. |
| original_document_size_bytes | bigint | Ayrıştırılmamış XML belgesinin bayt cinsinden boyutu. |
| original_namespace_document_size_bytes | bigint | Ayrıştırılmamış XML ad alanı belgesinin bayt cinsinden boyutu. Ad alanı belgesi yoksa NULL. |
| num_openxml_calls | bigint | Bu belge tanıtıcısına sahip OPENXML çağrılarının sayısı. |
| row_count | bigint | Bu belge tanıtıcısı için önceki tüm OPENXML çağrıları tarafından döndürülen satır sayısı. |
| dormant_duration_ms | bigint | Son OPENXML çağrısından bu yana milisaniye. OPENXML çağrılmadıysa, sp_xml_preparedocument çağrısından bu yana milisaniye döndürür. |
Açıklamalar
sp_xml_preparedocument çağrısı yürüten SQL metnini almak için kullanılan sql_handles ömrü, sorguyu yürütmek için kullanılan önbelleğe alınmış plandan daha uzun sürer. Sorgu metni önbellekte kullanılamıyorsa, veriler işlev sonucunda sağlanan bilgiler kullanılarak alınamaz. Çok sayıda büyük toplu iş çalıştırıyorsanız bu durum oluşabilir.
İzinler
Çağıranın sahip olmadığı tüm oturumları veya oturum kimliklerini görmek için sunucuda SUNUCU DURUMUNU GÖRÜNTÜLE izni gerektirir. Arayan her zaman kendi geçerli oturum kimliğinin verilerini görebilir.
SQL Server 2022 ve üzeri için izinler
Sunucuda SUNUCU PERFORMANS DURUMUNU GÖRÜNTÜLE izni gerektirir.
Örnekler
Aşağıdaki örnek tüm etkin tanıtıcıları seçer.
SELECT * FROM sys.dm_exec_xml_handles(0);
Ayrıca Bkz.
dinamik yönetim görünümlerini ve işlevlerini (Transact-SQL)
Yürütmeyle İlgili Dinamik Yönetim Görünümleri ve İşlevleri (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)