Compartir a través de


Implementar tipos definidos por el usuario

Actualizado: 14 de abril de 2006

En este tema se describe cómo crear y quitar tipos definidos por el usuario CLR (Common Language Runtime) en SQL Server.

Crear tipos definidos por el usuario

Para crear un tipo definido por el usuario en SQL Server, debe realizar los siguientes pasos en el orden especificado:

  • Defina el tipo definido por el usuario como una clase o estructura en un lenguaje compatible con Microsoft .NET Framework. Para obtener más información acerca de cómo programar tipos para CLR, vea CLR User-Defined Types. A continuación, compile la clase o estructura para generar un ensamblado en .NET Framework mediante el compilador del lenguaje correspondiente.
  • Registre el ensamblado en SQL Server mediante la instrucción CREATE ASSEMBLY. Para obtener más información acerca de los ensamblados de SQL Server, vea Ensamblados (motor de base de datos).
  • Cree el tipo que hace referencia al ensamblado registrado.

[!NOTA] Al implementar un Proyecto de servidor de SQL en Microsoft Visual Studio se registra un ensamblado en la base de datos que se especificó para el proyecto. La implementación del proyecto también crea tipos CLR definidos por el usuario en la base de datos para todas las definiciones de clase anotadas con el atributo SqlUserDefinedType. Para obtener más información, vea Deploying CLR Database Objects.

[!NOTA] De manera predeterminada, la capacidad de SQL Server de ejecutar código CLR está establecida en OFF. Se pueden crear, modificar y quitar objetos de base de datos que hagan referencia a módulos de código administrado, pero estas referencias no se ejecutarán en SQL Server a menos que se habilite la opción clr enabled mediante sp_configure.

Para crear, modificar o quitar un ensamblado

Para crear un tipo definido por el usuario

Quitar tipos definidos por el usuario

Para quitar un tipo definido por el usuario

[!NOTA] Los tipos definidos por el usuario no se pueden modificar una vez creados, ya que los cambios podrían invalidar datos de tablas o índices. Para modificar un tipo, debe quitarlo y después volver a crearlo o emitir una instrucción ALTER ASSEMBLY mediante la cláusula WITH UNCHECKED DATA.

No se puede quitar un tipo definido por el usuario hasta que se hayan quitado todas las referencias a dicho tipo. Entre dichas referencias figuran las siguientes:

  • Columnas definidas en el tipo.
  • Columnas calculadas y restricciones CHECK cuyas expresiones hacen referencia al tipo.
  • Vistas y funciones enlazadas a esquemas que presentan expresiones en sus definiciones que hacen referencia al tipo.
  • Parámetros de funciones y procedimientos almacenados.

Para encontrar columnas que dependen de un tipo definido por el usuario

En el ejemplo siguiente se recuperan metadatos de columnas definidas en un tipo definido por el usuario ComplexNumber.

SELECT * FROM sys.columns 
WHERE user_type_id = TYPE_ID('ComplexNumber');

En el ejemplo siguiente se recuperan metadatos limitados para usuarios con menos privilegios de columnas definidas en el tipo definido por el usuario ComplexNumber.

SELECT * FROM sys.column_type_usages 
WHERE user_type_id = TYPE_ID('ComplexNumber');

Para encontrar expresiones de columnas calculadas, expresiones de restricciones CHECK y expresiones de vistas y funciones enlazadas a esquemas que dependen de un tipo definido por el usuario

En el ejemplo siguiente se recuperan los nombres de las columnas calculadas (y todas sus tablas) que presentan una dependencia en el tipo definido por el usuario ComplexNumber.

SELECT OBJECT_NAME(object_id) AS object_name,
    COL_NAME(object_id, column_id) AS column_name
FROM sys.sql_dependencies
WHERE referenced_major_id = TYPE_ID('ComplexNumber')
    AND class = 2 
    AND OBJECTPROPERTY(object_id, 'IsTable')=1; 

En el ejemplo siguiente se recuperan los nombres de las restricciones CHECK (y los objetos en los que están definidas) que presentan una dependencia en el tipo definido por el usuario ComplexNumber.

SELECT SCHEMA_NAME(o.schema_id) AS schema_name,
    OBJECT_NAME(o.parent_object_id) AS table_name,
    OBJECT_NAME(o.object_id) AS constraint_name
FROM sys.sql_dependencies AS d
JOIN sys.objects AS o
ON o.object_id = d.object_id
WHERE referenced_major_id = TYPE_ID('ComplexNumber')
AND class = 2 
AND OBJECTPROPERTY(o.object_id, 'IsCheckCnst')=1;

En el ejemplo siguiente se recuperan los nombres de las funciones y las vistas enlazadas a esquemas cuyas definiciones hacen referencia al tipo definido por el usuario ComplexNumber.

[!NOTA] SQL Server no mantiene los metadatos de dependencia entre los tipos definidos por el usuario y su uso en el cuerpo de los procedimientos almacenados, los desencadenadores, las funciones no enlazadas a esquemas o las vistas no enlazadas a esquemas.

SELECT SCHEMA_NAME(o.schema_id) AS dependent_object_schema,
    OBJECT_NAME(o.object_id) AS dependent_object_name,
    o.type_desc AS dependent_object_type,
    d.class_desc AS kind_of_dependency,
    d.referenced_major_id AS referenced_object
FROM sys.sql_dependencies AS d 
JOIN sys.objects AS o
    ON d.object_id = o.object_id
        AND o.type IN ('FN','IF','TF', 'V')
WHERE  d.class = 2
    AND d.referenced_major_id IN (TYPE_ID('ComplexNumber'))
ORDER BY dependent_object_schema, dependent_object_name;

Para encontrar parámetros que dependen de un tipo definido por el usuario

En el ejemplo siguiente se recuperan los nombres de los parámetros (y los objetos a los que pertenecen) definidos en el tipo definido por el usuario ComplexNumber.

SELECT OBJECT_NAME(object_id) AS object_name,
    NULL AS procedure_number,
    name AS param_name,
    parameter_id AS param_num,
    TYPE_NAME(p.user_type_id) AS type_name
FROM sys.parameters AS p
WHERE p.user_type_id = TYPE_ID('ComplexNumber')
ORDER BY object_name, procedure_number, param_num;

En el ejemplo siguiente se recuperan metadatos limitados para usuarios con menos privilegios de parámetros definidos en el tipo definido por el usuario ComplexNumber.

SELECT * FROM sys.parameter_type_usages 
WHERE user_type_id = TYPE_ID('ComplexNumber');

Vea también

Conceptos

Trabajar con tipos definidos por el usuario para CLR

Otros recursos

Ejemplos de programación de CLR

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

14 de abril de 2006

Contenido nuevo:
  • Se agregó la sección "Quitar tipos definidos por el usuario", con información acerca de la localización de dependencias en tipos definidos por el usuario.