sys.dm_clr_properties (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)

Returnerar en rad för varje egenskap relaterad till SQL Server common language runtime (CLR)-integration, inklusive version och tillstånd för den hostade CLR:n. Den hostade CLR:n initieras genom att köra CREATE ASSEMBLY, ALTER ASSEMBLY, eller-satserna DROP ASSEMBLY , eller genom att köra någon CLR-rutin, typ eller trigger. sys.dm_clr_properties-vyn specificerar inte om exekvering av användarens CLR-kod har aktiverats på servern. Exekvering av användarens CLR-kod aktiveras genom att använda sp_configure stored procedure med clr-aktiverat alternativ inställt på 1.

Vyn sys.dm_clr_properties innehåller kolumnerna namn och värde. Varje rad i denna vy ger detaljer om en egenskap hos den hostade CLR:n. Använd denna vy för att samla information om den hostade CLR:n, såsom CLR:s installationskatalog, CLR-versionen och det aktuella tillståndet för den hostade CLR:n. Denna vy kan hjälpa dig att avgöra om CLR-integrationskoden inte fungerar på grund av problem med CLR-installationen på serverdatorn.

Egenskaper

Katalogegenskapen anger vilken katalog .NET Framework installerades i på servern. Det kan finnas flera installationer av .NET Framework på serverdatorn och värdet på denna egenskap identifierar vilken installation SQL Server använder.

Versionsegenskapen anger versionen av .NET Framework och den hostade CLR på servern.

Den sys.dm_clr_properties dynamiska hanterade vyn kan returnera sex olika värden för tillståndsegenskapen, vilket speglar tillståndet för den SQL Server hostade CLR:n. De är:

• Mscoree är inte laddad.

• Mscoree är laddad.

• Låst CLR-version med mscoree.

• CLR är initierad.

• CLR-initialiseringen misslyckades permanent.

• CLR är stoppad.

Mscoree- och Mscoree-laddade tillstånd visar progressionen av den hostade CLR-initialiseringen vid serverstart, och är inte sannolikt att ses.

Den låsta CLR-versionen med mscoree-tillstånd kan ses där den hostade CLR inte används och därför ännu inte har initierats. Den hostade CLR initieras första gången en DDL-sats (såsom CREATE ASSEMBLY (Transact-SQL)) eller ett hanterat databasobjekt körs.

CLR :s initialiserade tillstånd indikerar att den hostade CLR initierades framgångsrikt. Observera att detta inte anger om exekvering av användarens CLR-kod var aktiverad. Om exekveringen av användarens CLR-kod först aktiveras och sedan inaktiveras med Transact-SQL sp_configure lagrad procedur, kommer tillståndsvärdet fortfarande att vara CLR initierat.

CLR-initialiseringens permanent misslyckade tillstånd indikerar att hostad CLR-initiering misslyckades. Minnestryck är en sannolik orsak, eller så kan det också bero på ett fel i hosting-handshake mellan SQL Server och CLR. Felmeddelandet 6512 eller 6513 kommer att visas i ett sådant fall.

CLR:s stopptillstånd ses endast när SQL Server håller på att stängas ner.

Remarks

Egenskaperna och värdena för denna vy kan ändras i en framtida version av SQL Server på grund av förbättringar av CLR-integrationsfunktionen.

Permissions

På SQL Server och SQL Managed Instance kräver VIEW SERVER STATE behörighet.

I SQL Database Grundläggande, S0och S1 tjänstmål och för databaser i elastiska pooler, serveradministratör konto, Microsoft Entra-administratör konto eller medlemskap i ##MS_ServerStateReader##serverrollen krävs. För alla andra SQL Database-tjänstmål krävs antingen VIEW DATABASE STATE behörighet för databasen eller medlemskap i ##MS_ServerStateReader## serverrollen.

Behörigheter för SQL Server 2022 och senare

Kräver VIEW SERVER PERFORMANCE STATE behörighet på servern.

Examples

Följande exempel hämtar information om den hostade CLR:n:

SELECT name, value   
FROM sys.dm_clr_properties;  

Se även

Dynamiska hanteringsvyer och funktioner (Transact-SQL)
Dynamiska hanteringsvyer relaterade till Common Language Runtime (Transact-SQL)