Compartir a través de


sys.dm_clr_properties (Transact-SQL)

Devuelve una fila para cada propiedad relacionada con la integración de SQL Server y Common Language Runtime (CLR), incluidos la versión y el estado del entorno CLR alojado. El entorno CLR alojado se inicializa ejecutando las instrucciones CREATE ASSEMBLY, ALTER ASSEMBLY o DROP ASSEMBLY, o ejecutando cualquier rutina, tipo o desencadenador de CLR. La vista sys.dm_clr_properties no especifica si se ha habilitado la ejecución de código CLR de usuario en el servidor. La ejecución de 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 alojado. Utilice esta vista para recopilar información acerca del entorno CLR alojado, como el directorio de instalación de CLR, la versión de CLR y el estado actual del entorno CLR alojado. 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 columna

Tipo de datos

Descripción

name

nvarchar(128)

Nombre de la propiedad.

value

nvarchar(128)

Valor de la propiedad.

Propiedades

La propiedad directory indica el directorio en que se instaló .NET Framework en el servidor. Podría haber varias instalaciones de .NET Framework en el equipo servidor y el valor de esta propiedad identificaría la instalación que SQL Server estaría utilizando.

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

La vista de administración dinámica sys.dm_clr_properties puede devolver seis valores distintos para la propiedad state que reflejan el estado del entorno CLR alojado de SQL Server. Estos valores son:

  • Mscoree is not loaded.

  • Mscoree is loaded.

  • Locked CLR version with mscoree.

  • CLR is initialized.

  • CLR initialization permanently failed.

  • CLR is stopped.

Los estados Mscoree is not loaded y Mscoree is loaded muestran la progresión de la inicialización del entorno CLR alojado al iniciar el servidor; es probable que no se produzcan.

El estado Locked CLR version with mscoree puede producirse cuando no se está utilizando el entorno CLR alojado y, por tanto, aún no se ha inicializado. El entorno CLR alojado 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 estado CLR is initialized indica que el entorno CLR alojado se ha inicializado correctamente. Tenga en cuenta que esto no indica si se ha habilitado la ejecución de código CLR de usuario. Si se habilita primero la ejecución de código CLR de usuario y después se deshabilita mediante el procedimiento almacenado sp_configure de Transact-SQL, el valor de estado seguirá siendo CLR is initialized.

El estado CLR initialization permanently failed indica un error de inicialización del entorno CLR alojado. Una causa probable es la presión de memoria, o también podría ser el resultado de un error del protocolo de enlace de alojamiento entre SQL Server y el entorno CLR. En este caso se producirá el mensaje de error 6512 o 6513.

El estado CLR is stopped state sólo se produce cuando SQL Server se está cerrando.

Notas

Las propiedades y los valores de esta vista podrían cambiar en una futura versión de SQL Server como consecuencia de las mejoras de la funcionalidad de integración CLR.

Permisos

Requiere el permiso VIEW SERVER STATE en el servidor.

Ejemplos

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

select name, value 
from sys.dm_clr_properties