Procedimiento recomendado para administrar ensamblados de U-SQL en una canalización de CI/CD
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.
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.
Agregar el código de C# definido por el usuario en el proyecto de biblioteca de clases (para la aplicación U-SQL).
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.
Agregar una referencia al proyecto de biblioteca de clases de C# para el proyecto de base de datos U-SQL.
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.
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.
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
Haga clic con el botón derecho en el proyecto de base de datos U-SQL y, después, seleccione Implementar.
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.
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.
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.
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.
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.