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)