sys.dm_clr_properties (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)

Devuelve una fila para cada propiedad relacionada con la integración de Common Language Runtime (CLR) de SQL Server, incluida la versión y el estado del CLR hospedado. ClR hospedado se inicializa ejecutando las instrucciones CREATE ASSEMBLY, ALTER ASSEMBLY o DROP ASSEMBLY , o ejecutando cualquier rutina, tipo o desencadenador CLR. La vista sys.dm_clr_properties no especifica si la ejecución del código CLR de usuario se ha habilitado en el servidor. La ejecución del código CLR de usuario se habilita mediante el procedimiento almacenado sp_configure con la opción clr enabled establecida en 1.

La vista sys.dm_clr_properties contiene las columnas name y value . Cada una de las filas de esta vista proporciona información detallada acerca de una propiedad del entorno CLR hospedado. Utilice esta vista para recopilar información acerca del entorno CLR hospedado, como el directorio de instalación de CLR, la versión de CLR y el estado actual del entorno CLR hospedado. Esta vista puede ayudarle a determinar si el código de integración CLR no funciona debido a problemas con la instalación de CLR en el equipo servidor.

Nombre de la columna Tipo de datos Descripción
name nvarchar(128) El nombre de la propiedad.
value nvarchar(128) Valor de la propiedad.

Propiedades

La propiedad directory indica el directorio en el que se instaló .NET Framework en en el servidor. Podría haber varias instalaciones de .NET Framework en el equipo servidor y el valor de esta propiedad identifica qué instalación usa SQL Server.

La propiedad version indica la versión de .NET Framework y CLR hospedada en el servidor.

La sys.dm_clr_properties vista administrada dinámica puede devolver seis valores diferentes para la propiedad state , que refleja el estado del CLR hospedado en SQL Server. Son las siguientes:

  • Mscoree is not loaded.

  • Mscoree is loaded.

  • Locked CLR version with mscoree.

  • CLR is initialized.

  • CLR initialization permanently failed.

  • CLR is stopped.

Los estados de Mscoree no se cargan y Mscoree muestra la progresión de la inicialización de CLR hospedada en el inicio del servidor y es probable que no se vea.

La versión de CLR bloqueada con estado mscoree puede verse donde no se está usando el CLR hospedado y, por lo tanto, aún no se ha inicializado. El CLR hospedado se inicializa la primera vez que se ejecuta una instrucción DDL (como CREATE ASSEMBLY (Transact-SQL) o un objeto de base de datos administrado.

El CLR está inicializado indica que el CLR hospedado se inicializó correctamente. Tenga en cuenta que esto no indica si se ha habilitado la ejecución de código CLR de usuario. Si la ejecución del código CLR de usuario se habilita primero y, a continuación, se deshabilita mediante el procedimiento almacenado transact-SQL sp_configure , el valor de estado seguirá siendo CLR inicializado.

El estado de error permanente de inicialización clR indica que se produjo un error en la inicialización de CLR hospedada. La presión de memoria es una causa probable o también podría ser el resultado de un error en el protocolo de enlace de hospedaje entre SQL Server y CLR. En este caso se producirá el mensaje de error 6512 o 6513.

El estado CLR se detiene solo se ve cuando SQL Server está en proceso de apagado.

Comentarios

Las propiedades y los valores de esta vista podrían cambiar en una versión futura de SQL Server debido a mejoras de la funcionalidad de integración clR.

Permisos

En SQL Server y SQL Managed Instance, requiere el permiso VIEW SERVER STATE.

En los objetivos de servicio Básico, S0 y S1 de SQL Database y para bases de datos en grupos elásticos, se requiere la cuenta de administrador del servidor, la cuenta de administrador Microsoft Entra o la pertenencia al ##MS_ServerStateReader##rol del servidor. En el resto de objetivos del servicio de SQL Database, se requiere el permiso VIEW DATABASE STATE en la base de datos o la pertenencia en el rol del servidor ##MS_ServerStateReader##.

Permisos para SQL Server 2022 y versiones posteriores

Requiere el permiso VER ESTADO DE RENDIMIENTO DEL SERVIDOR en el servidor.

Ejemplos

En el siguiente ejemplo se recupera información acerca del entorno CLR hospedado:

SELECT name, value   
FROM sys.dm_clr_properties;

Consulte también

Funciones y vistas de administración dinámica (Transact-SQL)
Vistas de administración dinámica relacionadas con Common Language Runtime (Transact-SQL)