ALTER ASSEMBLY (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

Modifica una ensamblado cambiando las propiedades del catálogo SQL Server de un ensamblado. ALTER ASSEMBLY lo actualiza a la última copia de los módulos de Microsoft .NET Framework que contienen su implementación y agrega o quita los archivos asociados con él. Los ensamblados se crean mediante CREATE ASSEMBLY.

Advertencia

CLR usa la seguridad de acceso del código (CAS) de .NET Framework, que ya no se admite como un límite de seguridad. Un ensamblado CLR creado con la opción PERMISSION_SET = SAFE puede tener acceso a los recursos externos del sistema, llamar a código no administrado y adquirir privilegios sysadmin. A partir de SQL Server 2017 (14.x), se incluye una opción de sp_configure denominada clr strict security para mejorar la seguridad de los ensamblados CLR. La opción clr strict security está habilitada de forma predeterminada y trata los ensamblados SAFE y EXTERNAL_ACCESS como si estuvieran marcados con UNSAFE. La opción clr strict security se puede deshabilitar para permitir la compatibilidad con versiones anteriores, pero no se recomienda hacerlo. Microsoft recomienda que todos los ensamblados estén firmados con un certificado o clave asimétrica con el correspondiente inicio de sesión que tenga concedido el permiso UNSAFE ASSEMBLY en la base de datos maestra. Para obtener más información, vea CLR strict security.

Convenciones de sintaxis de Transact-SQL

Sintaxis

ALTER ASSEMBLY assembly_name  
    [ FROM <client_assembly_specifier> | <assembly_bits> ]  
    [ WITH <assembly_option> [ ,...n ] ]  
    [ DROP FILE { file_name [ ,...n ] | ALL } ]  
    [ ADD FILE FROM   
    {   
        client_file_specifier [ AS file_name ]   
      | file_bits AS file_name   
    } [,...n ]   
    ] [ ; ]  
<client_assembly_specifier> :: =  
    '\\computer_name\share-name\[path\]manifest_file_name'  
  | '[local_path\]manifest_file_name'  
  
<assembly_bits> :: =  
    { varbinary_literal | varbinary_expression }  
  
<assembly_option> :: =  
    PERMISSION_SET = { SAFE | EXTERNAL_ACCESS | UNSAFE }   
  | VISIBILITY = { ON | OFF }  
  | UNCHECKED DATA

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

assembly_name
Es el nombre del ensamblado que se desea modificar. assembly_name ya debe existir en la base de datos.

FROM <client_assembly_specifier> | <assembly_bits>
Actualiza un ensamblado a la última copia de los módulos de .NET Framework que conservan su implementación. Esta opción solo se puede utilizar si no hay archivos asociados con el ensamblado especificado.

<client_assembly_specifier> especifica la ubicación local o de red donde se encuentra el ensamblado que se va a actualizar. La ubicación de red incluye el nombre del equipo, el nombre del recurso compartido y una ruta dentro de ese recurso compartido. manifest_file_name especifica el nombre del archivo que contiene el manifiesto del ensamblado.

Importante

Azure SQL Database no admite la referencia a un archivo.

<assembly_bits> es el valor binario para el ensamblado.

Deben generarse instrucciones ALTER ASSEMBLY independientes para cada ensamblado dependiente que también debe actualizarse.

PERMISSION_SET = { SAFE | EXTERNAL_ACCESS | UNSAFE }

Importante

La opción PERMISSION_SET se ve afectada por la opción clr strict security, descrita en la advertencia inicial. Cuando clr strict security está habilitada, todos los ensamblados se tratan como UNSAFE.
Especifica la propiedad del conjunto de permisos de acceso al código .NET Framework del ensamblado. Para obtener más información sobre esta propiedad, vea CREATE ASSEMBLY (Transact-SQL).

Nota:

Las opciones EXTERNAL_ACCESS y UNSAFE no están disponibles en una base de datos contenida.

VISIBILITY = { ON | OFF }
Indica si el ensamblado es visible para crear en él funciones CLR (Common Language Runtime), procedimientos almacenados, desencadenadores, tipos definidos por el usuario y funciones de agregado definidas por el usuario. Si se establece en OFF, el ensamblado se ha diseñado para que solo se lo llame con otros ensamblados. Si ya existen objetos de base de datos CLR creados en el ensamblado, la visibilidad del ensamblado no se puede cambiar. Los ensamblados a los que se haga referencia con assembly_name se cargan como no visibles, de forma predeterminada.

UNCHECKED DATA
De forma predeterminada, ALTER ASSEMBLY genera errores si debe comprobar la coherencia de filas de tabla individuales. Esta opción permite posponer las comprobaciones para más adelante con DBCC CHECKTABLE. Si se especifica, SQL Server ejecuta la instrucción ALTER ASSEMBLY aunque existan tablas en la base de datos que contienen lo siguiente:

  • Columnas calculadas persistentes que hacen referencia de forma directa o indirecta a métodos en el ensamblado, mediante funciones o métodos de Transact-SQL.

  • Restricciones CHECK que hacen referencia de forma directa o indirecta a métodos en el ensamblado.

  • Columnas con el tipo CLR definido por el usuario que dependen del ensamblado, y el tipo implementa un formato de serialización UserDefined (distinto de Native).

  • Columnas de un tipo definido por el usuario CLR que hacen referencia a vistas creadas con WITH SCHEMABINDING.

Si está presente alguna restricción CHECK, se deshabilita y se marca sin confianza. Las tablas que contienen columnas que dependen del ensamblado se marcan como que contienen datos sin comprobar hasta que se comprueban explícitamente.

Solo los miembros de los roles fijos de base de datos db_owner y db_ddlowner pueden especificar esta opción.

Requiere el permiso ALTER ANY SCHEMA para especificar esta opción.

Para obtener más información, vea Implementación de ensamblados.

[ DROP FILE { file_name[ ,...n] | ALL } ]
Quita de la base de datos el nombre de archivo o todos los archivos asociados con el ensamblado. Si se utiliza con ADD FILE a continuación, primero se ejecuta DROP FILE. Esto le permite reemplazar un archivo con el mismo nombre de archivo.

Nota:

Esta opción no está disponible en una base de datos independiente o en Azure SQL Database.

[ ADD FILE FROM { client_file_specifier [ AS file_name] | file_bitsAS file_name}
Carga un archivo que se asociará con el ensamblado, como código fuente, archivos de depuración u otra información relacionada, en el servidor y lo hace visible en la vista de catálogo sys.assembly_files. client_file_specifier especifica la ubicación desde la que se va a cargar el archivo. Se puede usar bits_de_archivo en lugar de especificar la lista de valores binarios que forman el archivo. file_name especifica el nombre con el que el archivo se debe almacenar en la instancia de SQL Server. Se debe especificar file_name si se especifica file_bits y es opcional si se especifica client_file_specifier. Si no se especifica file_name, la parte "nombre_de_archivo" de client_file_specifier se usa como file_name.

Nota:

Esta opción no está disponible en una base de datos independiente o en Azure SQL Database.

Observaciones

ALTER ASSEMBLY no interrumpe las sesiones en ejecución actuales que están ejecutando código en el ensamblado que se va a modificar. Las sesiones actuales completan su ejecución utilizando los bits no modificados del ensamblado.

Si se especifica la cláusula FROM, ALTER ASSEMBLY actualiza el ensamblado en relación con las últimas copias de los módulos proporcionados. Puesto que pueden existir funciones CLR, procedimientos almacenados, desencadenadores, tipos de datos y funciones de agregado definidas por el usuario en la instancia de SQL Server ya definidas en el ensamblado, la instrucción ALTER ASSEMBLY las vuelve a enlazar con la última implementación del ensamblado. Para realizar la operación de volver a enlazar, los métodos que asignan a funciones CLR, procedimientos almacenados y desencadenadores ya deben existir en el ensamblado modificado con las mismas firmas. Las clases que implementan tipos definidos por el usuario CLR y funciones de agregado definidas por el usuario deben cumplir los requisitos de ser un tipo o un agregado definido por el usuario.

Precaución

Si no se especifica WITH UNCHECKED DATA, SQL Server intentará evitar que ALTER ASSEMBLY se ejecute si la nueva versión de ensamblado afecta a los datos existentes de tablas, índices u otros sitios permanentes. Sin embargo, SQL Server no garantiza que las columnas calculadas, los índices, las vistas indizadas o las expresiones sean coherentes con rutinas y tipos subyacentes cuando el ensamblado CLR se actualice. Al ejecutar ALTER ASSEMBLY, tenga cuidado de que no se produzcan discrepancias entre el resultado de una expresión y los valores basados en esa expresión que se almacenen en el ensamblado.

ALTER ASSEMBLY cambia la versión de ensamblado. La referencia cultural y el símbolo (token) de clave pública del ensamblado siguen siendo los mismos.

La instrucción ALTER ASSEMBLY no se puede usar para cambiar lo siguiente:

  • Las firmas de funciones CLR, procedimientos almacenados y desencadenadores en una instancia de SQL Server que hace referencia al ensamblado. ALTER ASSEMBLY genera errores cuando SQL Server no puede volver a enlazar objetos de base de datos .NET Framework en SQL Server con la nueva versión del ensamblado.

  • Las firmas de métodos en el ensamblado que se llaman desde otros ensamblados.

  • La lista de ensamblados que dependen del ensamblado, como aparece en la propiedad DependentList del ensamblado.

  • La posibilidad de indización de un método, a menos que no existan índices o columnas calculadas persistentes que dependan de ese método, de forma directa o indirecta.

  • El atributo del nombre de método FillRow para funciones CLR con valores de tabla.

  • La firma de los métodos Accumulate y Terminate para agregados definidos por el usuario.

  • Ensamblados del sistema.

  • Propiedad del ensamblado. Consulte en su lugar ALTER AUTHORIZATION (Transact-SQL).

Además, para ensamblados que implementan tipos definidos por el usuario, se puede utilizar ALTER ASSEMBLY para realizar solo los siguientes cambios:

  • Modificar métodos públicos de la clase de tipo definido por el usuario, siempre que no se modifiquen firmas ni atributos.

  • Agregar nuevos métodos públicos.

  • Modificar métodos privados de cualquier manera.

Los campos incluidos en un tipo definido por el usuario de serialización nativa, incluidos los miembros de datos o clases base, no se pueden cambiar mediante ALTER ASSEMBLY. No se admiten otros cambios.

Si no se especifica ADD FILE FROM, ALTER ASSEMBLY quita los archivos asociados con el ensamblado.

Si se ejecuta ALTER ASSEMBLY sin la cláusula de datos UNCHECKED, se realizan comprobaciones para comprobar que la nueva versión del ensamblado no afecta a los datos existentes en las tablas. Dependiendo de la cantidad de datos que sea necesario comprobar, puede afectar al rendimiento.

Permisos

Se requiere el permiso ALTER en el ensamblado. Algunos requisitos adicionales son los siguientes:

  • Para modificar un ensamblado cuyo conjunto de permisos existente es EXTERNAL_ACCESS, se requiere el permiso EXTERNAL ACCESS ASSEMBLY en el servidor.

  • Para modificar un ensamblado cuyo conjunto de permisos existente es UNSAFE, se requiere el permiso UNSAFE ASSEMBLY en el servidor.

  • Para cambiar el conjunto de permisos de un ensamblado a EXTERNAL_ACCESS, se requiere el permiso EXTERNAL ACCESS ASSEMBLY en el servidor.

  • Para cambiar el conjunto de permisos de un ensamblado a UNSAFE, se requiere el permiso UNSAFE ASSEMBLY en el servidor.

  • Para especificar WITH UNCHECKED DATA, se requiere el permiso ALTER ANY SCHEMA.

Permisos con seguridad estricta de CLR

Los permisos siguientes son necesarios para modificar un ensamblado CLR cuando la opción CLR strict security está habilitada:

  • El usuario debe tener el permiso ALTER ASSEMBLY.
  • Y una de las siguientes condiciones también debe ser cierta:
    • El ensamblado debe estar firmado con un certificado o clave asimétrica que tenga el inicio de sesión correspondiente con el permiso UNSAFE ASSEMBLY en el servidor. Se recomienda firmar el ensamblado.
    • La base de datos tiene la propiedad TRUSTWORTHY establecida en ON y pertenece a un inicio de sesión que tiene el permiso UNSAFE ASSEMBLY en el servidor. Esta opción no se recomienda.

Para obtener más información sobre los conjuntos de permisos de ensamblado, vea Diseño de ensamblados.

Ejemplos

A. Actualización de un ensamblado

En el siguiente ejemplo se actualiza el ensamblado ComplexNumber a la última copia de los módulos de .NET Framework que conservan su implementación.

Nota:

El ensamblado ComplexNumber se puede crear ejecutando los scripts de ejemplo UserDefinedDataType. Para obtener más información, vea Tipo definido por el usuario.

ALTER ASSEMBLY ComplexNumber 
FROM 'C:\Program Files\Microsoft SQL Server\130\Tools\Samples\1033\Engine\Programmability\CLR\UserDefinedDataType\CS\ComplexNumber\obj\Debug\ComplexNumber.dll'

Importante

Azure SQL Database no admite la referencia a un archivo.

B. Agregar una archivo para asociarlo con el ensamblado

En el siguiente ejemplo se carga el archivo de código de origen Class1.cs para asociarlo con el ensamblado MyClass. En este ejemplo se asume que el ensamblado MyClass ya está creado en la base de datos.

ALTER ASSEMBLY MyClass   
ADD FILE FROM 'C:\MyClassProject\Class1.cs';

Importante

Azure SQL Database no admite la referencia a un archivo.

C. Cambiar los permisos de un ensamblado

En el ejemplo siguiente se cambia el conjunto de permisos del ensamblado ComplexNumber de SAFE a EXTERNAL ACCESS.

ALTER ASSEMBLY ComplexNumber WITH PERMISSION_SET = EXTERNAL_ACCESS;

Consulte también

CREATE ASSEMBLY (Transact-SQL)
DROP ASSEMBLY (Transact-SQL)
EVENTDATA (Transact-SQL)