Procedimiento recomendado para administrar ensamblados de U-SQL en una canalización de CI/CD

  • Artículo

En este artículo, aprenderá a administrar código fuente de ensamblados de U-SQL con el nuevo proyecto de base de datos U-SQL incorporado. También aprenderá a configurar una canalización de integración e implementación continua (CI/CD) para el registro de ensamblados con Azure DevOps.

Importante

Azure Data Lake Analytics retiró el 29 de febrero de 2024. Más información sobre este anuncio.

Para el análisis de datos, su organización puede usar Azure Synapse Analytics o Microsoft Fabric.

Usar el proyecto de base de datos U-SQL para administrar el código fuente de ensamblados

El proyecto de base de datos U-SQL es un tipo de proyecto de Visual Studio que ayuda a los desarrolladores a desarrollar, administrar e implementar sus bases de datos U-SQL rápida y fácilmente. Puede administrar todos los objetos de base de datos U-SQL (excepto las credenciales) con el proyecto de base de datos U-SQL.

Para administrar el código fuente de ensamblados de C# y los scripts U-SQL de DDL del registro de ensamblados, utilice:

  • El proyecto de base de datos U-SQL para administrar scripts U-SQL del registro de ensamblados.
  • La biblioteca de clases (para la aplicación U-SQL) para administrar el código fuente de C# y las dependencias de los operadores, las funciones y los agregadores definidos por el usuario (UDO, UDF y UDAG).
  • El proyecto de base de datos U-SQL para hacer referencia al proyecto de biblioteca de clases.

Un proyecto de base de datos U-SQL puede hacer referencia a un proyecto de biblioteca de clases (para la aplicación U-SQL). Se pueden crear ensamblados registrados en la base de datos U-SQL mediante el código fuente de C# de referencia desde este proyecto de biblioteca de clases (para la aplicación U-SQL).

Siga estos pasos para crear proyectos y agregarles referencias.

  1. Crear un proyecto de biblioteca de clases (para la aplicación U-SQL) seleccionando Archivo>Nuevo>Proyecto. El proyecto se encuentra bajo el nodo Azure Data Lake > U-SQL.

    Herramientas de Data Lake para Visual Studio: Creación de proyecto de biblioteca de clases de C#

  2. Agregar el código de C# definido por el usuario en el proyecto de biblioteca de clases (para la aplicación U-SQL).

  3. Cree un proyecto de U-SQL, para lo que debe seleccionar Archivo>Nuevo>Proyecto. El proyecto se encuentra bajo el nodo Azure Data Lake>U-SQL.

    Herramientas de Data Lake para Visual Studio: Creación de proyecto de base de datos U-SQL

  4. Agregar una referencia al proyecto de biblioteca de clases de C# para el proyecto de base de datos U-SQL.

    Herramientas de Data Lake para Visual Studio: Adición de referencia

    Herramientas de Data Lake para Visual Studio: Adición de referencia de proyecto de una base de datos de U-SQL

  5. Para crear un script de ensamblado en el proyecto de base de datos U-SQL, haga clic con el botón derecho en el proyecto y seleccione Agregar nuevo elemento.

    Herramientas de Data Lake para Visual Studio: Adición de script de ensamblado

  6. Abra el script de ensamblado en la vista de diseño del ensamblado. Seleccione el ensamblado referenciado en el menú desplegable Cree el ensamblado desde la referencia.

    Herramientas de Data Lake para Visual Studio: Creación de un ensamblado a partir de una referencia

  7. Agregue Dependencias administradas y Archivos adicionales, si los hay. Al agregar archivos adicionales, la herramienta usa la ruta de acceso relativa para asegurarse de que puede encontrar los ensamblados en la máquina local y en la máquina de compilación más adelante.

@_DeployTempDirectory en la ventana del editor de la parte inferior es una variable predefinida que dirige la herramienta a la carpeta de salida de compilación. En la carpeta de salida de compilación, cada ensamblado tiene una subcarpeta denominada con el nombre del ensamblado. Todos los archivos adicionales y DLL están en esa subcarpeta.

Compilación de un proyecto de base de datos U-SQL

La salida de compilación del proyecto de base de datos U-SQL es un paquete de implementación de la base de datos U-SQL, denominado con el sufijo .usqldbpack. El paquete .usqldbpack es un archivo ZIP que incluye todas las instrucciones DDL de un único script U-SQL en una carpeta DDL. Todos los archivos .dll compilados y archivos adicionales para los ensamblados están en la carpeta Temp.

Implementación de la base de datos U-SQL

El paquete .usqldbpack puede implementarse tanto en una cuenta local como en una cuenta de Azure Data Lake Analytics. Use Visual Studio o el SDK de implementación.

Implementación de una base de datos U-SQL en Visual Studio

Puede implementar una base de datos U-SQL mediante un proyecto de base de datos U-SQL o un paquete .usqldbpack en Visual Studio.

Implementación mediante un proyecto de base de datos U-SQL

  1. Haga clic con el botón derecho en el proyecto de base de datos U-SQL y, después, seleccione Implementar.

  2. En el Asistente para implementar la base de datos de U-SQL, seleccione la cuenta de ADLA en la que desea implementar la base de datos. Se admite tanto una cuenta local como una cuenta de ADLA.

  3. El origen de la base de datos se rellena automáticamente. Señala al paquete .usqldbpack en la carpeta de salida de compilación del proyecto.

  4. Escriba un nombre en Nombre de base de datos para crear una base de datos. Si ya hay una base de datos con el mismo nombre en la cuenta de Azure Data Lake Analytics de destino, todos los objetos definidos en el proyecto de base de datos se crean sin volver a crear la base de datos.

  5. Para implementar la base de datos de U-SQL, seleccione Enviar. Se cargan todos los recursos, como ensamblados y archivos adicionales. Se envía un trabajo de U-SQL que incluye todas las instrucciones de DDL.

    Herramientas de Data Lake para Visual Studio: Implementación un proyecto de base de datos U-SQL

    Herramientas de Data Lake para Visual Studio: Implementación mediante el asistente del proyecto de base de datos de U-SQL

Implementación de una base de datos U-SQL en Azure DevOps

PackageDeploymentTool.exe proporciona interfaces de programación y línea de comandos que ayudan a implementar bases de datos de U-SQL. El SDK se incluye en el paquete NuGet del SDK de U-SQL, ubicado en build/runtime/PackageDeploymentTool.exe.

En Azure DevOps, puede usar una tarea de línea de comandos y este SDK para configurar una canalización de automatización para la actualización de la base de datos U-SQL. Más información sobre el SDK y cómo configurar una canalización de CI/CD para la implementación de bases de datos de U-SQL.

Pasos siguientes