Integración de CLR

Escenarios

Common language runtime (CLR) es el núcleo de Microsoft .NET Framework y proporciona el entorno de ejecución para todo el código de .NET Framework. El código que se ejecuta dentro del CLR se denomina código gestionado. El CLR proporciona varias funciones y servicios necesarios para la ejecución del programa, incluidas la compilación just-in-time (JIT), asignación y gestión de memoria, aplicación de seguridad de tipo, manejo de excepciones, gestión de subprocesos y seguridad.

SQL CLR es una nueva función de SQL Server 2005. Se inyecta el servicio CLR de .NET Framework en SQL Server, de modo que algunos objetos de base de datos de SQL Server se pueden desarrollar utilizando el lenguaje de programación de .NET Framework (actualmente, solo se admiten VB.NET y C#). Estos objetos de base de datos incluyen procedimientos almacenados, disparadores, funciones definidas por el usuario, tipos definidos por el usuario, y agregados definidos por el usuario. Para ejecutar el código CLR, primero debe habilitar la integración CLR.

Para obtener más información acerca de la integración de CLR, consulte Conceptos de programación de integración de Common Language Runtime (CLR).

Para obtener más información acerca de la seguridad de integración de CLR, consulte Seguridad de integración de CLR.

Prerrequisitos

RDS for SQL Server solo puede desplegar ensamblados SAFE.

Habilitación de CLR

1. Inicie sesión en la consola de gestión.
2. Haga clic en en la esquina superior izquierda y seleccione una región y un proyecto.
3. Haga clic en en la esquina superior izquierda de la página y seleccione Databases > Relational Database Service.
4. En la página Instances, haga clic en la instancia de base de datos de destino.
5. En el panel de navegación de la izquierda, elija Parameters. En la página mostrada, escriba clr enabled y clr strict security en el cuadro de búsqueda en la esquina superior derecha.
   

   • clr enabled determina si la integración CLR está habilitada.
   • clr strict security es un parámetro específico para RDS for SQL Server 2017. Este parámetro explica los permisos SAFE, EXTERNAL ACCESS, y UNSAFE de RDS for SQL Server. El valor 1 hace que el motor de base de datos ignore la información PERMISSION_SET de los ensamblados y siempre los interpreta como UNSAFE. Para obtener más información, consulte Seguridad estricta de CLR en el sitio de Microsoft.

6. Establezca el valor clr enabled.

   Establezca clr enabled en 1 y haga clic en Save. En el cuadro de diálogo que se muestra, haga clic en Yes para activar la función CLR.

   

   • clr enabled: El valor 1 indica que la función CLR está activada. El valor 0 indica que la función CLR está deshabilitada. Solo es necesario configurar clr enabled para habilitar la función CLR.
   • clr strict security: El valor predeterminado es 1 y no se requiere ninguna configuración.

7. En la pestaña Change History, compruebe que el valor de clr enabled se ha cambiado a 1.

Creación de un ensamblaje SAFE CLR

Al diseñar ensamblajes se deben tener en cuenta los siguientes factores:

• Conjuntos de ensamblaje
• Seguridad de ensamblaje de gestión
• Restricciones a los ensamblajes

Para obtener más información, consulte Diseño de ensamblajes.

Ejemplo: Creación de un ensamblaje C# CLR

RDS for SQL Server proporciona ensamblados para que las operaciones de base de datos sean sencillas y convenientes.

Al restaurar datos en una instancia de base de datos nueva o existente, el parámetro clr enabled está deshabilitado de forma predeterminada. Para utilizar la función de integración CLR, primero debe habilitar clr enabled.

Procedimiento

1. Cree una función de C# para compilar una DLL de RDS for SQL Server.
   Figura 1 Código de función C#
   
   

   Para obtener más información acerca de las funciones definidas por el usuario, consulte Funciones definidas por el usuario de CLR.

2. Utilice SQL Server Management Studio para conectarse a la base de datos.
   Figura 2 Conectarse al servidor
   

3. Seleccione la base de datos de destino y cree el ensamblaje correspondiente.
   

   • Solo se puede crear el ensamblado SAFE (el conjunto de Permission es Safe).
   • El archivo DLL se guarda en formato hexadecimal, como se muestra en Figura 4.
   Figura 3 Creación de un ensamblaje
   
   Figura 4 Archivo DLL
   

4. Ejecute el programa. Si el resultado de la ejecución se muestra como Figura 5, la ejecución se realiza correctamente. Se añade el conjunto TESTS, como se muestra en Figura 6.
   Figura 5 Resultado de la ejecución
   
   Figura 6 Ensamblaje de TESTS