sys.dm_clr_properties (T-SQL)

Artikel
08/21/2023

Berlaku untuk:SQL Server Azure SQL Managed Instance Analytics Platform System (PDW)

Mengembalikan baris untuk setiap properti yang terkait dengan integrasi runtime bahasa umum (CLR) SQL Server, termasuk versi dan status CLR yang dihosting. CLR yang dihosting diinisialisasi dengan menjalankan pernyataan CREATE ASSEMBLY, ALTER ASSEMBLY, atau DROP ASSEMBLY , atau dengan menjalankan rutinitas, jenis, atau pemicu CLR apa pun. Tampilan sys.dm_clr_properties tidak menentukan apakah eksekusi kode CLR pengguna telah diaktifkan di server. Eksekusi kode CLR pengguna diaktifkan dengan menggunakan prosedur tersimpan sp_configure dengan opsi yang diaktifkan clr diatur ke 1.

Tampilan sys.dm_clr_properties berisi kolom nama dan nilai . Setiap baris dalam tampilan ini menyediakan detail tentang properti CLR yang dihosting. Gunakan tampilan ini untuk mengumpulkan informasi tentang CLR yang dihosting, seperti direktori penginstalan CLR, versi CLR, dan status CLR yang dihosting saat ini. Tampilan ini dapat membantu Anda menentukan apakah kode integrasi CLR tidak berfungsi karena masalah dengan penginstalan CLR di komputer server.

Nama kolom	Jenis data	Deskripsi
nama	nvarchar(128)	Nama properti.
value	nvarchar(128)	Nilai properti.

Properti

Properti direktori menunjukkan direktori tempat .NET Framework diinstal pada server. Mungkin ada beberapa penginstalan .NET Framework di komputer server dan nilai properti ini mengidentifikasi penginstalan mana yang digunakan SQL Server.

Properti versi menunjukkan versi .NET Framework dan CLR yang dihosting di server.

Tampilan terkelola dinamis sys.dm_clr_properties dapat mengembalikan enam nilai berbeda untuk properti status , yang mencerminkan status CLR yang dihosting SQL Server. Yaitu:

Mscoree tidak dimuat.
Mscoree dimuat.
Versi CLR terkunci dengan mscoree.
CLR diinisialisasi.
Inisialisasi CLR gagal secara permanen.
CLR dihentikan.

Mscoree tidak dimuat dan Mscoree dimuat status menunjukkan perkembangan inisialisasi CLR yang dihosting pada startup server, dan tidak mungkin terlihat.

Versi CLR Terkunci dengan status mscoree dapat dilihat di mana CLR yang dihosting tidak digunakan dan, dengan demikian, belum diinisialisasi. CLR yang dihosting diinisialisasi pertama kali pernyataan DDL (seperti CREATE ASSEMBLY (Transact-SQL)) atau objek database terkelola dijalankan.

CLR adalah status yang diinisialisasi menunjukkan bahwa CLR yang dihosting berhasil diinisialisasi. Perhatikan bahwa ini tidak menunjukkan apakah eksekusi kode CLR pengguna diaktifkan. Jika eksekusi kode CLR pengguna pertama kali diaktifkan dan kemudian dinonaktifkan menggunakan prosedur tersimpan sp_configure Transact-SQL, nilai status masih akan menjadi CLR diinisialisasi.

Status inisialisasi CLR gagal secara permanen menunjukkan bahwa inisialisasi CLR yang dihosting gagal. Tekanan memori kemungkinan penyebabnya, atau bisa juga akibat kegagalan dalam jabat tangan hosting antara SQL Server dan CLR. Pesan kesalahan 6512 atau 6513 akan dilemparkan dalam kasus seperti itu.

Status CLR dihentikan hanya terlihat ketika SQL Server sedang dalam proses mematikan.

Keterangan

Properti dan nilai tampilan ini mungkin berubah dalam versi SQL Server di masa mendatang karena peningkatan fungsionalitas integrasi CLR.

Izin

Pada SQL Server dan SQL Managed Instance, memerlukan VIEW SERVER STATE izin.

Pada tujuan layanan SQL Database Basic, S0, dan S1, dan untuk database di kumpulan elastis, akun admin server, akun admin Microsoft Entra, atau keanggotaan dalam##MS_ServerStateReader## peran server diperlukan. Pada semua tujuan layanan SQL Database lainnya, izin VIEW DATABASE STATE pada database, atau keanggotaan dalam ##MS_ServerStateReader## peran server diperlukan.

Izin untuk SQL Server 2022 dan yang lebih baru

Memerlukan izin TAMPILKAN STATUS PERFORMA SERVER pada server.

Contoh

Contoh berikut mengambil informasi tentang CLR yang dihosting:

SELECT name, value   
FROM sys.dm_clr_properties;