Bagikan melalui


sys.dm_exec_xml_handles (T-SQL)

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengembalikan informasi tentang handel aktif yang telah dibuka oleh sp_xml_preparedocument.

Sintaks

  
dm_exec_xml_handles (session_id | 0 )  

Argumen

session_id | 0,
ID sesi. Jika session_id ditentukan, fungsi ini mengembalikan informasi tentang handel XML dalam sesi yang ditentukan.

Jika 0 ditentukan, fungsi mengembalikan informasi tentang semua handel XML untuk semua sesi.

Tabel Dikembalikan

Nama kolom Jenis data Deskripsi
session_id int ID Sesi sesi yang menyimpan handel dokumen XML ini.
document_id int ID penanganan dokumen XML yang dikembalikan oleh sp_xml_preparedocument.
namespace_document_id int ID handel internal yang digunakan untuk dokumen namespace terkait yang telah diteruskan sebagai parameter ketiga untuk sp_xml_preparedocument. NULL jika tidak ada dokumen namespace layanan.
sql_handle varbinary(64) Tangani ke teks kode SQL tempat handel telah ditentukan.
statement_start_offset int Jumlah karakter ke dalam batch yang sedang dijalankan atau prosedur tersimpan di mana panggilan sp_xml_preparedocument terjadi. Dapat digunakan bersama dengan sql_handle, statement_end_offset, dan fungsi manajemen dinamis sys.dm_exec_sql_text untuk mengambil pernyataan yang sedang dijalankan untuk permintaan tersebut.
statement_end_offset int Jumlah karakter ke dalam batch yang sedang dijalankan atau prosedur tersimpan di mana panggilan sp_xml_preparedocument terjadi. Dapat digunakan bersama dengan sql_handle, statement_start_offset, dan fungsi manajemen dinamis sys.dm_exec_sql_text untuk mengambil pernyataan yang sedang dijalankan untuk permintaan tersebut.
creation_time datetime Tanda waktu ketika sp_xml_preparedocument dipanggil.
original_document_size_bytes bigint Ukuran dokumen XML yang tidak dipisahkan dalam byte.
original_namespace_document_size_bytes bigint Ukuran dokumen namespace XML yang tidak diurai, dalam byte. NULL jika tidak ada dokumen namespace layanan.
num_openxml_calls bigint Jumlah panggilan OPENXML dengan handel dokumen ini.
row_count bigint Jumlah baris yang dikembalikan oleh semua panggilan OPENXML sebelumnya untuk handel dokumen ini.
dormant_duration_ms bigint Milidetik sejak panggilan OPENXML terakhir. Jika OPENXML belum dipanggil, mengembalikan milidetik sejak sp_xml_preparedocumentidak memanggil.

Keterangan

Masa pakai sql_handles digunakan untuk mengambil teks SQL yang menjalankan panggilan untuk sp_xml_preparedocument keluar dari rencana cache yang digunakan untuk menjalankan kueri. Jika teks kueri tidak tersedia di cache, data tidak dapat diambil menggunakan informasi yang disediakan dalam hasil fungsi. Ini dapat terjadi jika Anda menjalankan banyak batch besar.

Izin

Memerlukan izin TAMPILKAN STATUS SERVER pada server untuk melihat semua sesi atau ID sesi yang tidak dimiliki oleh pemanggil. Penelepon selalu dapat melihat data untuk ID sesinya sendiri saat ini.

Izin untuk SQL Server 2022 dan yang lebih baru

Memerlukan izin TAMPILKAN STATUS PERFORMA SERVER pada server.

Contoh

Contoh berikut memilih semua handel aktif.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Lihat Juga


Tampilan dan Fungsi Manajemen Dinamis (Transact-SQL)
Tampilan dan Fungsi Manajemen Dinamis Terkait Eksekusi (Transact-SQL)
sp_xml_preparedocument (T-SQL)
sp_xml_removedocument (T-SQL)