sys.dm_clr_properties (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)

Devolve uma linha para cada propriedade relacionada com a integração com o SQL Server Common Language runtime (CLR), incluindo a versão e o estado do CLR alojado. O CLR hospedado é inicializado executando as CREATE ASSEMBLYinstruções , ALTER ASSEMBLY, ou DROP ASSEMBLY executando qualquer rotina, tipo ou gatilho CLR. A vista sys.dm_clr_properties não especifica se a execução do código CLR do utilizador foi ativada no servidor. A execução do código CLR do utilizador é ativada usando o procedimento armazenado sp_configure com a opção habilitada clr definida para 1.

A vista sys.dm_clr_properties contém as colunas de nome e valor . Cada linha nesta vista fornece detalhes sobre uma propriedade do CLR alojado. Use esta vista para recolher informações sobre o CLR alojado, como o diretório de instalação do CLR, a versão do CLR e o estado atual do CLR hospedado. Esta vista pode ajudá-lo a determinar se o código de integração do CLR não está a funcionar devido a problemas com a instalação do CLR no computador servidor.

Nome da coluna Tipo de dados Description
name nvarchar(128) O nome da propriedade.
valor nvarchar(128) Valor do imóvel.

Propriedades

A propriedade diretório indica o diretório onde o .NET Framework foi instalado no servidor. Podem existir múltiplas instalações do .NET Framework no computador servidor e o valor desta propriedade identifica qual instalação o SQL Server está a usar.

A propriedade de versão indica a versão do .NET Framework e o CLR alojado no servidor.

A vista dinâmica gerida sys.dm_clr_properties pode devolver seis valores diferentes para a propriedade de estado, que reflete o estado do CLR SQL Server alojado. Eles são:

  • O Mscoree não está carregado.

  • O Mscoree está cheio.

  • Versão CLR bloqueada com mscoree.

  • O CLR está inicializado.

  • A inicialização do CLR falhou permanentemente.

  • O CLR está parado.

Os estados do Mscoree não estão carregados e o Mscoree está carregado mostram a progressão da inicialização do CLR alojado no arranque do servidor, e é pouco provável que sejam vistos.

A versão CLR bloqueada com o estado mscoree pode ser vista quando o CLR hospedado não está a ser usado e, portanto, ainda não foi inicializado. O CLR alojado é inicializado na primeira vez que uma instrução DDL (como CREATE ASSEMBLY (Transact-SQL)) ou um objeto de base de dados gerida é executado.

O estado de inicialização do CLR indica que o CLR hospedado foi inicializado com sucesso. Note que isto não indica se a execução do código CLR do utilizador estava ativada. Se a execução do código CLR do utilizador for primeiro ativada e depois desativada usando o procedimento Transact-SQL sp_configure armazenado, o valor de estado continuará a ser CLR inicializado.

O estado de falha permanente de inicialização CLR indica que a inicialização CLR hospedada falhou. A pressão de memória é uma causa provável, ou pode também ser resultado de uma falha no handshake de alojamento entre o SQL Server e o CLR. A mensagem de erro 6512 ou 6513 será lançada nesse caso.

O estado CLR está parado só é visto quando o SQL Server está em processo de desligar.

Remarks

As propriedades e valores desta visão poderão mudar numa versão futura do SQL Server devido a melhorias na funcionalidade de integração do CLR.

Permissions

No SQL Server e na Instância Gerenciada do SQL, requer VIEW SERVER STATE permissão.

No Banco de Dados SQL Basic, S0e S1 objetivos de serviço e para bancos de dados em pools elásticos , a conta de de administrador do servidor , a conta de de administrador do Microsoft Entra ou a associação ao de função de servidor é necessária. Em todos os outros objetivos de serviço do Banco de dados SQL, é necessária a permissão VIEW DATABASE STATE no banco de dados ou a associação à função de servidor ##MS_ServerStateReader##.

Permissões para SQL Server 2022 e posterior

Requer VIEW permissão ESTADO DE DESEMPENHO DO SERVIDOR no servidor.

Examples

O exemplo seguinte recolhe informações sobre o CLR alojado:

SELECT name, value   
FROM sys.dm_clr_properties;  

Consulte também

Visões e funções de gerenciamento dinâmico (Transact-SQL)
Vistas de Gestão Dinâmica Relacionadas com o Tempo de Execução da Common Language (Transact-SQL)