sys.dm_external_script_execution_stats

Artikel
08/21/2023

Berlaku untuk: SQL Server 2016 (13.x) dan Azure SQL Managed Instance yang lebih baru

Mengembalikan satu baris untuk setiap jenis permintaan skrip eksternal. Permintaan skrip eksternal dikelompokkan menurut bahasa skrip eksternal yang didukung. Satu baris dihasilkan untuk setiap fungsi skrip eksternal yang terdaftar. Fungsi skrip eksternal arbitrer tidak direkam kecuali dikirim oleh proses induk, seperti rxExec.

Catatan

Tampilan manajemen dinamis (DMV) ini hanya tersedia jika Anda telah menginstal dan mengaktifkan fitur yang mendukung eksekusi skrip eksternal. Untuk informasi selengkapnya, lihat Layanan R di SQL Server 2016, Layanan Pembelajaran Mesin (R, Python) di SQL Server 2017 dan yang lebih baru dan Azure SQL Managed Instance Machine Learning Services.

Nama kolom	Jenis data	Deskripsi
`language`	nvarchar	Nama bahasa skrip eksternal yang terdaftar. Setiap skrip eksternal harus menentukan bahasa dalam permintaan skrip untuk memulai peluncur terkait.
`counter_name`	nvarchar	Nama fungsi skrip eksternal terdaftar. Tidak dapat diubah ke null.
`counter_value`	Integer	Jumlah total instans yang telah dipanggil oleh fungsi skrip eksternal terdaftar di server. Nilai ini bersifat kumulatif, dimulai dengan waktu fitur diinstal pada instans, dan tidak dapat diatur ulang.

Izin

Untuk SQL Server 2019 (15.x) dan versi sebelumnya, memerlukan izin TAMPILKAN STATUS SERVER di server.

Untuk SQL Server 2022 (16.x) dan versi yang lebih baru, memerlukan izin TAMPILKAN STATUS PERFORMA SERVER di server.

Pengguna yang menjalankan skrip eksternal harus memiliki izin tambahan JALANKAN SKRIP EKSTERNAL APA PUN. Namun, DMV ini dapat digunakan oleh administrator tanpa izin ini.

Keterangan

DMV ini disediakan untuk telemetri internal, untuk memantau penggunaan keseluruhan fitur eksekusi skrip eksternal baru yang disediakan di SQL Server. Layanan telemetri dimulai ketika LaunchPad melakukan dan menambah penghitung berbasis disk setiap kali fungsi skrip eksternal terdaftar dipanggil.

Secara umum, penghitung kinerja hanya berlaku selama proses yang menghasilkannya aktif. Oleh karena itu, kueri pada DMV tidak dapat menampilkan data terperinci untuk layanan yang telah berhenti berjalan. Misalnya, jika peluncur menjalankan skrip eksternal dan menyelesaikannya dengan cepat, DMV konvensional mungkin tidak menampilkan data apa pun.

Oleh karena itu, penghitung yang dilacak oleh DMV ini terus berjalan, dan status untuk sys.dm_external_script_requests dipertahankan dengan menggunakan tulisan ke disk, bahkan jika instans dimatikan.

Nilai penghitung

Di SQL Server 2016 (13.x), satu-satunya bahasa eksternal yang didukung adalah R dan permintaan skrip eksternal ditangani oleh Layanan R (Dalam Database). Di SQL Server 2017 (14.x) dan versi yang lebih baru, dan pada Azure SQL Managed Instance, R dan Python didukung bahasa eksternal dan permintaan skrip eksternal ditangani oleh Layanan Pembelajaran Mesin.

Untuk R, DMV ini melacak jumlah panggilan R yang dilakukan pada instans. Misalnya, jika rxLinMod dipanggil dan dijalankan secara paralel, penghitung bertambah 1.

Untuk bahasa R, nilai penghitung yang ditampilkan di bidang counter_name mewakili nama fungsi ScaleR terdaftar. Nilai di bidang counter_value mewakili jumlah instans kumulatif yang fungsi ScaleR tertentu.

Untuk Python, DMV ini melacak jumlah panggilan Python yang dilakukan pada instans.

Jumlah dimulai ketika fitur diinstal dan diaktifkan pada instans, dan bersifat kumulatif hingga file yang mempertahankan status dihapus atau ditimpa oleh administrator. Oleh karena itu, umumnya tidak mungkin untuk mengatur ulang nilai dalam counter_value. Jika Anda ingin memantau penggunaan berdasarkan sesi, waktu kalender, atau interval lainnya, kami sarankan Anda mengambil hitungan ke tabel.

Pendaftaran fungsi skrip eksternal di R

R mendukung skrip arbitrer, dan komunitas R menyediakan ribuan paket, masing-masing dengan fungsi dan metodenya sendiri. Namun, DMV ini hanya memantau fungsi ScaleR yang diinstal dengan Layanan R SQL Server 2016 (13.x).

Pendaftaran fungsi-fungsi ini dilakukan saat fitur diinstal, dan fungsi terdaftar tidak dapat ditambahkan atau dihapus.

Contoh

Menampilkan jumlah skrip R yang dijalankan di server

Contoh berikut menampilkan jumlah kumulatif eksekusi skrip eksternal untuk bahasa R.

SELECT counter_name, counter_value
FROM sys.dm_external_script_execution_stats
WHERE language = 'R';

Menampilkan jumlah skrip Python yang dijalankan di server

Contoh berikut menampilkan jumlah kumulatif eksekusi skrip eksternal untuk bahasa Python.

SELECT counter_name, counter_value
FROM sys.dm_external_script_execution_stats
WHERE language = 'Python';