sys.dm_exec_xml_handles (T-SQL)

Artikel
08/21/2023

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)