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 hospedado. El entorno CLR hospedado 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 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 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 hospedado 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 hospedado 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 hospedado 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 hospedado y, por tanto, aún no se ha inicializado. El entorno 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 estado CLR is initialized indica que el entorno CLR hospedado 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 hospedado. 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 hospedaje 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 solo se produce cuando SQL Server se está cerrando.
Comentarios
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 hospedado:
select name, value
from sys.dm_clr_properties
Vea también
Referencia
Funciones y vistas de administración dinámica (Transact-SQL)
Vistas de administración dinámica relacionadas con Common Language Runtime (Transact-SQL)