SET SET STATISTICS XML (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceDatabase SQL di Microsoft Fabric

Menyebabkan Microsoft SQL Server menjalankan pernyataan Transact-SQL dan menghasilkan informasi terperinci tentang bagaimana pernyataan dijalankan dalam bentuk dokumen XML yang ditentukan dengan baik.

Konvensi sintaks transact-SQL

Sintaks

  
SET STATISTICS XML { ON | OFF }  

Keterangan

Pengaturan diatur SETSET STATISTICS XML pada waktu eksekusi atau eksekusi dan bukan pada waktu penguraian.

Saat SETSET STATISTICS XML AKTIF, SQL Server mengembalikan informasi eksekusi untuk setiap pernyataan setelah menjalankannya. Setelah opsi ini diatur AKTIF, informasi tentang semua pernyataan Transact-SQL berikutnya dikembalikan hingga opsi diatur ke NONAKTIF. Perhatikan bahwa tidak SETSET STATISTICS XML perlu menjadi satu-satunya pernyataan dalam batch.

SET SET STATISTICS XML mengembalikan output sebagai nvarchar(max) untuk aplikasi, seperti utilitas sqlcmd , di mana output XML kemudian digunakan oleh alat lain untuk menampilkan dan memproses informasi rencana kueri.

SET SET STATISTICS XML mengembalikan informasi sebagai kumpulan dokumen XML. Setiap pernyataan setelah SETSET STATISTICS XML pernyataan ON tercermin dalam output oleh satu dokumen. Setiap dokumen berisi teks pernyataan, diikuti dengan detail langkah-langkah eksekusi. Output menunjukkan informasi run-time seperti biaya, indeks yang diakses, dan jenis operasi yang dilakukan, urutan gabungan, berapa kali operasi fisik dilakukan, jumlah baris yang dihasilkan setiap operator fisik, dan banyak lagi.

Dokumen yang berisi skema XML untuk output XML oleh SETSET STATISTICS XML disalin selama penyiapan ke direktori lokal di komputer tempat Microsoft SQL Server diinstal. Ini dapat ditemukan pada drive yang berisi file penginstalan SQL Server, di:

\Microsoft SQL Server\100\Alat\Binn\schemas\sqlserver\2004\07\showplan\showplanxml.xsd

Skema Showplan juga dapat ditemukan di situs Web ini.

SET SET STATISTICS PROFILE dan SETSET STATISTICS XML merupakan mitra satu sama lain. Yang pertama menghasilkan output tekstual; yang terakhir menghasilkan output XML. Dalam versi SQL Server mendatang, informasi rencana eksekusi kueri baru hanya akan ditampilkan melalui pernyataanSETSET STATISTICS XML, bukan pernyataanSETSET STATISTICS PROFILE.

Izin

Untuk menggunakan SETSET STATISTICS XML dan melihat output, pengguna harus memiliki izin berikut:

• Izin yang sesuai untuk menjalankan pernyataan Transact-SQL.

• Izin SHOWPLAN pada semua database yang berisi objek yang dirujuk oleh pernyataan Transact-SQL.

Untuk pernyataan Transact-SQL yang tidak menghasilkan STATISTICS XML kumpulan hasil, hanya izin yang sesuai untuk menjalankan pernyataan Transact-SQL yang diperlukan. Untuk pernyataan Transact-SQL yang menghasilkan STATISTICS XML kumpulan hasil, pemeriksaan izin eksekusi pernyataan Transact-SQL dan izin SHOWPLAN harus berhasil, atau eksekusi pernyataan Transact-SQL dibatalkan dan tidak ada informasi Showplan yang dihasilkan.

Contoh

Dua pernyataan berikut menggunakan SETSET STATISTICS XML pengaturan untuk menunjukkan cara SQL Server menganalisis dan mengoptimalkan penggunaan indeks dalam kueri. Kueri pertama menggunakan operator perbandingan Equals (=) dalam klausa WHERE pada kolom terindeks. Kueri kedua menggunakan operator LIKE dalam klausa WHERE. Ini memaksa SQL Server untuk menggunakan pemindaian indeks berkluster untuk menemukan data yang memenuhi kondisi klausa WHERE. Nilai dalam atribut EstimateRows dan EstimatedTotalSubtreeCost lebih kecil untuk kueri terindeks pertama yang menunjukkan bahwa itu diproses jauh lebih cepat dan menggunakan lebih sedikit sumber daya daripada kueri yang tidak diindeks.

USE AdventureWorks2022;  
GO  
SET STATISTICS XML ON;  
GO  
-- First query.  
SELECT BusinessEntityID   
FROM HumanResources.Employee  
WHERE NationalIDNumber = '509647174';  
GO  
-- Second query.  
SELECT BusinessEntityID, JobTitle   
FROM HumanResources.Employee  
WHERE JobTitle LIKE 'Production%';  
GO  
SET STATISTICS XML OFF;  
GO  

Lihat Juga

SET SHOWPLAN_XML (Transact-SQL)
Utilitas sqlcmd