sys.dm_clr_properties (Transact-SQL)

van toepassing op:SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)

Geeft een rij terug voor elke eigenschap die gerelateerd is aan de SQL Server common language runtime (CLR) integratie, inclusief de versie en status van de gehoste CLR. De gehoste CLR wordt geïnitialiseerd door de CREATE ASSEMBLY, ALTER ASSEMBLY, of DROP ASSEMBLY statements uit te voeren, of door een CLR-routine, type of trigger uit te voeren. De sys.dm_clr_properties-weergave specificeert niet of de uitvoering van gebruikers-CLR-code op de server is ingeschakeld. De uitvoering van gebruikers-CLR-code wordt mogelijk gemaakt door gebruik te maken van de sp_configure stored procedure met de clr-optie ingesteld op 1.

De sys.dm_clr_properties-weergave bevat de kolommen naam en waarde . Elke rij in deze weergave geeft details over een eigenschap van de gehoste CLR. Gebruik deze weergave om informatie te verzamelen over de gehoste CLR, zoals de CLR-installatiemap, de CLR-versie en de huidige status van de gehoste CLR. Deze weergave kan je helpen bepalen of de CLR-integratiecode niet werkt vanwege problemen met de CLR-installatie op de servercomputer.

Kolomnaam Gegevenstype Description
name nvarchar(128) De naam van de eigenschap.
waarde nvarchar(128) Waarde van de eigenschap.

Eigenschappen

De directory-eigenschap geeft de map aan waarin het .NET Framework op de server is geïnstalleerd. Er kunnen meerdere installaties van .NET Framework op de servercomputer zijn en de waarde van deze eigenschap geeft aan welke installatie SQL Server gebruikt.

De versie-eigenschap geeft de versie van het .NET Framework en de gehoste CLR op de server aan.

De sys.dm_clr_properties dynamische beheerde weergave kan zes verschillende waarden teruggeven voor de toestandseigenschap, wat de staat van de SQL Server gehoste CLR weerspiegelt. Dit zijn:

  • Mscoree is niet geladen.

  • Mscoree is geladen.

  • Vergrendelde CLR-versie met mscoree.

  • CLR is geïnitialiseerd.

  • CLR-initialisatie faalde permanent.

  • CLR is gestopt.

De Mscoree- en Mscoree-geladen-toestanden tonen de voortgang van de gehoste CLR-initialisatie bij het opstarten van de server, en zullen waarschijnlijk niet worden gezien.

De Locked CLR-versie met mscoree-status kan worden gezien wanneer de gehoste CLR niet wordt gebruikt en dus nog niet is geïnitialiseerd. De gehoste CLR wordt geïnitialiseerd de eerste keer dat een DDL-instructie (zoals CREATE ASSEMBLY (Transact-SQL)) of een beheerd databaseobject wordt uitgevoerd.

De geïnitialiseerde CLR-toestand geeft aan dat de gehoste CLR succesvol is geïnitialiseerd. Let op: dit geeft niet aan of de uitvoering van gebruikers-CLR-code was ingeschakeld. Als de uitvoering van gebruikerscode eerst wordt ingeschakeld en daarna uitgeschakeld met de Transact-SQL sp_configure stored procedure, wordt de statuswaarde CLR nog steeds geïnitialiseerd.

De CLR-initialisatie permanent mislukte toestand geeft aan dat de gehoste CLR-initialisatie is mislukt. Geheugendruk is waarschijnlijk een oorzaak, of het kan ook het gevolg zijn van een storing in de hostinghandshake tussen SQL Server en de CLR. In zo'n geval wordt er foutmelding 6512 of 6513 gegeven.

De CLR-staat is gestopt wordt alleen gezien wanneer SQL Server bezig is met afsluiten.

Remarks

De eigenschappen en waarden van deze weergave kunnen veranderen in een toekomstige versie van SQL Server door verbeteringen aan de CLR-integratiefunctionaliteit.

Permissions

Voor SQL Server en SQL Managed Instance is VIEW SERVER STATE machtiging vereist.

Op SQL Database Basic, S0en S1 servicedoelstellingen, en voor databases in elastische pools, is het serverbeheerder--account, het Microsoft Entra-beheerdersaccount of lidmaatschap van de ##MS_ServerStateReader##-server functie vereist. Voor alle andere SQL Database-servicedoelstellingen is de VIEW DATABASE STATE machtiging voor de database of het lidmaatschap van de ##MS_ServerStateReader##-serverfunctie vereist.

Machtigingen voor SQL Server 2022 en hoger

Vereist VIEW SERVER PERFORMANCE STATE toestemming op de server.

Voorbeelden

Het volgende voorbeeld haalt informatie op over de gehoste CLR:

SELECT name, value   
FROM sys.dm_clr_properties;  

Zie ook

Dynamische Beheerweergaven en -functies (Transact-SQL)
Dynamische beheersweergaven gerelateerd aan de uitvoering van de Common Language (Transact-SQL)