CREATE ASSEMBLY (Transact-SQL)

Crea un módulo de aplicación administrada que contiene metadatos de clase y código administrado como un objeto en una instancia de SQL Server. Mediante este módulo, puede crear en la base de datos funciones CLR (Common Language Runtime), procedimientos almacenados, desencadenadores, funciones de agregado definidas por el usuario y tipos definidos por el usuario.

Convenciones de sintaxis de Transact-SQL

Sintaxis

CREATE ASSEMBLY assembly_name
[ AUTHORIZATION owner_name ]
FROM { <client_assembly_specifier> | <assembly_bits> [ ,...n ] }
[ WITH PERMISSION_SET = { SAFE | EXTERNAL_ACCESS | UNSAFE } ]
[ ; ]

<client_assembly_specifier> :: =
        '[\\computer_name\]share_name\[path\]manifest_file_name'
  | '[local_path\]manifest_file_name'

<assembly_bits> :: =
{ varbinary_literal | varbinary_expression }

Argumentos

• assembly_name
  Es el nombre del ensamblado. El nombre debe ser único en la base de datos y un identificador válido.

• AUTHORIZATION owner_name
  Especifica el nombre de un usuario o función como propietario del ensamblado. El valor de owner_namedebe ser el nombre de una función de la que el usuario actual es miembro o el usuario actual debe tener el permiso IMPERSONATE sobre owner_name. Si no se especifica, la propiedad se otorga al usuario actual.

• <client_assembly_specifier>
  Especifica la ruta de acceso local o ubicación de red en la que se encuentra el ensamblado que se carga y, además, el nombre de archivo de manifiesto que se corresponde con el ensamblado. <client_assembly_specifier> puede expresarse como una cadena fija o una expresión que se evalúe como una cadena fija, con variables. CREATE ASSEMBLY no admite la carga de ensamblados de varios módulos. SQL Server también busca cualquier ensamblado dependiente de este ensamblado en la misma ubicación y lo carga con el mismo propietario que el ensamblado de nivel raíz. Si estos ensamblados dependientes no se encuentran o aún no están cargados en la base de datos actual, CREATE ASSEMBLY produce un error. Si los ensamblados dependientes ya están cargados en la base de datos actual, el propietario de los mismos deberá ser el mismo que el del ensamblado nuevo que se crea.

  No se puede especificar <client_assembly_specifier> si el usuario que ha iniciado sesión es suplantado.

• <assembly_bits>
  Es la lista de valores binarios que forman el ensamblado y sus ensamblados dependientes. El primer valor de esta lista se considera el ensamblado raíz. Los valores correspondientes a los ensamblados dependientes pueden suministrarse en cualquier orden. Se ignora cualquier valor que no se corresponda con los ensamblados dependientes del ensamblado raíz.

• varbinary_literal
  Es un valor literal varbinary.

• varbinary_expression
  Es una expresión de tipo varbinary.

• PERMISSION_SET { SAFE | EXTERNAL_ACCESS | UNSAFE }
  Especifica un conjunto de permisos de acceso a código que se conceden al ensamblado cuando SQL Server tiene acceso al mismo. Si no se especifica, el valor SAFE se aplica de forma predeterminada.

  Es recomendable el uso de SAFE. SAFE es el conjunto de permisos más restrictivo. El código que ejecuta un ensamblado con permisos SAFE no puede tener acceso a recursos externos del sistema, como archivos, la red, variables de entorno o el registro.

  EXTERNAL_ACCESS permite que los ensamblados tengan acceso a determinados recursos externos del sistema, como archivos, redes, variables de entorno y el registro.

  UNSAFE permite que los ensamblados tengan acceso ilimitado a los recursos, tanto dentro como fuera de una instancia de SQL Server. El código que se ejecuta desde dentro de un ensamblado UNSAFE puede llamarse código no administrado.

  Nota de seguridad:

  SAFE es el ajuste de permiso recomendado para ensamblados que realizan tareas de administración de datos y cálculos sin tener acceso a los recursos fuera de una instancia de SQL Server. Es recomendable el uso de EXTERNAL_ACCESS para ensamblados que tengan acceso a recursos fuera de una instancia de SQL Server. Los ensamblados EXTERNAL_ACCESS incluyen la protección de escalabilidad y confiabilidad ofrecida por los ensamblados SAFE; sin embargo, desde el punto de vista de la seguridad, son similares a los ensamblados UNSAFE. Esto se debe a que el código en los ensamblados EXTERNAL_ACCESS se ejecuta de forma predeterminada con la cuenta del servicio SQL Server y tiene acceso a los recursos externos con esa misma cuenta, a no ser que el código suplante al autor de la llamada de forma explícita. Por esta razón, el permiso para crear ensamblados EXTERNAL_ACCESS sólo debe concederse a los inicios de sesión en los que se confíe para ejecutar código con la cuenta del servicio SQL Server. Para obtener más información acerca de la suplantación, vea CLR Integration Security. Si especifica UNSAFE, otorga libertad absoluta al código en el ensamblado para realizar operaciones en el espacio de procesos de SQL Server que pueden comprometer la solidez de SQL Server. Los ensamblados UNSAFE también pueden trastornar potencialmente el sistema de seguridad de SQL Server o de Common Language Runtime. Los permisos UNSAFE sólo deben otorgarse a los ensamblados de gran confianza. Sólo los miembros de la función fija de servidor sysadmin pueden crear y alterar los ensamblados UNSAFE.

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

Notas

CREATE ASSEMBLY carga un ensamblado que ha sido compilado anteriormente como un archivo .dll desde código administrado para su uso dentro de una instancia de SQL Server.

SQL Server no permite registrar versiones diferentes de un ensamblado con el mismo nombre, cultura y clave pública.

Cuando intente obtener acceso al ensamblado especificado en <client_assembly_specifier>, SQL Server suplantará el contexto de seguridad del inicio de sesión de Windows actual. Si <client_assembly_specifier> especifica una ubicación de red (ruta de acceso UNC), la suplantación del inicio de sesión actual no se mantiene en la ubicación de red a causa de las limitaciones de delegación. En este caso, el acceso se realiza mediante el contexto de seguridad de la cuenta del servicio SQL Server. Para obtener más información, vea Credenciales.

Además del ensamblado raíz especificado en assembly_name, SQL Server intenta cargar cualquier ensamblado al que haga referencia el ensamblado raíz que se carga. Si ya se ha cargado en la base de datos un ensamblado referenciado por la existencia de una instrucción CREATE ASSEMBLY anterior, este ensamblado no se carga, sino que está disponible para el ensamblado raíz. Si no se ha cargado antes un ensamblado dependiente, pero SQL Server no puede localizar el archivo de manifiesto en el directorio de origen, CREATE ASSEMBLY produce un error.

Si un ensamblado dependiente referenciado por el ensamblado raíz no está aún en la base de datos y se ha cargado implícitamente junto con el ensamblado raíz, este ensamblado tiene establecidos los mismos permisos que el ensamblado raíz. Si se deben crear ensamblados dependientes mediante el uso de permisos diferentes de los del ensamblado raíz, estos deben cargarse explícitamente antes del ensamblado raíz con los permisos apropiados establecidos.

Validación del ensamblado

SQL Server realiza comprobaciones en los binarios del ensamblado cargados mediante la instrucción CREATE ASSEMBLY para garantizar que lo siguiente se cumple:

• El binario del ensamblado está formado por metadatos y segmentos de código válidos; los segmentos de código tienen instrucciones MSIL (Lenguaje intermedio de Microsoft) válidas.
• El conjunto de ensamblados del sistema al que se hace referencia es uno de los siguientes ensamblados admitidos en SQL Server: Microsoft.Visualbasic.dll, Mscorlib.dll, System.Data.dll, System.dll, System.Xml.dll, Microsoft.Visualc.dll, Custommarshallers.dll, System.Security.dll, System.Web.Services.dll y System.Data.SqlXml.dll. Se puede hacer referencia a otros ensamblados del sistema, pero deben estar registrados de forma explícita en la base de datos.
• Para ensamblados creados mediante los conjuntos de permisos SAFE o EXTERNAL ACCESS:
  • El código del ensamblado debe tener seguridad de tipos. La seguridad de tipos se establece ejecutando el comprobador de Common Language Runtime en el ensamblado.
  • El ensamblado no debe contener ningún miembro de datos estáticos en sus clases, a menos que esté marcado como de sólo lectura.
  • Las clases en el ensamblado no pueden contener métodos de finalizador.
  • Las clases o métodos del ensamblado deben anotarse solamente con atributos de código permitidos. Para obtener más información, vea Custom Attributes for CLR Routines.

Además de las comprobaciones previas realizadas al ejecutar CREATE ASSEMBLY, existen comprobaciones adicionales que se realizan en el tiempo de ejecución del código en el ensamblado:

• Si se llama a determinadas API Microsoft .NET Framework que requieren un permiso de acceso a código específico, puede dar error si el conjunto de permisos del ensamblado no incluye tal permiso.
• En el caso de ensamblados SAFE y EXTERNAL_ACCESS, cualquier intento de llamada a las API .NET Framework anotadas con HostProtectionAttributes dará error.

Para obtener más información, vea Diseñar ensamblados.

Permisos

Requiere el permiso CREATE ASSEMBLY.

Si se especifica PERMISSION_SET = EXTERNAL_ACCESS, el inicio de sesión de SQL Server debe tener el permiso EXTERNAL ACCESS ASSEMBLY en el servidor. Si se especifica PERMISSION_SET = UNSAFE, es necesaria la pertenencia a la función fija de servidor sysadmin.

El usuario debe ser el propietario de cualquier ensamblado al que el ensamblado que se va a cargar haga referencia (si los ensamblados ya existen en la base de datos). Para cargar un ensamblado usando una ruta de acceso de archivo, el usuario actual debe ser miembro del inicio de sesión autenticado de Windows o de la función fija de servidor sysadmin. El inicio de sesión de Windows del usuario que ejecuta CREATE ASSEMBLY debe tener permisos de lectura en el recurso compartido y en los archivos que se cargan por medio de la instrucción.

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

Ejemplos

En el ejemplo siguiente se asume que los ejemplos del SQL Server Database Engine (Motor de base de datos de SQL Server) se han instalado en la ubicación predeterminada del equipo local y que la aplicación de ejemplo HelloWorld.csproj se ha compilado. Para obtener más información, vea Hello World (ejemplo).

DECLARE @SamplesPath nvarchar(1024)
SELECT @SamplesPath = REPLACE(physical_name, 
    'Microsoft SQL Server\MSSQL.1\MSSQL\DATA\master.mdf', 
    'Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\') 
FROM master.sys.database_files 
WHERE name = 'master';
CREATE ASSEMBLY HelloWorld 
FROM @SamplesPath + 'HelloWorld\CS\HelloWorld\bin\debug\HelloWorld.dll'
WITH PERMISSION_SET = SAFE;

Vea también

Referencia

ALTER ASSEMBLY (Transact-SQL)
DROP ASSEMBLY (Transact-SQL)
CREATE FUNCTION (Transact-SQL)
CREATE PROCEDURE (Transact-SQL)
CREATE TRIGGER (Transact-SQL)
CREATE TYPE (Transact-SQL)
CREATE AGGREGATE (Transact-SQL)
EVENTDATA (Transact-SQL)

Otros recursos

Ejemplos de programación de CLR

Ayuda e información

Obtener ayuda sobre SQL Server 2005