Uso de un proyecto de base de datos de U-SQL para desarrollar una base de datos de U-SQL para Azure Data Lake

  • Artículo

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.

La base de datos de U-SQL proporciona vistas estructuradas a través de los datos no estructurados y datos estructurados administrados en las tablas. También proporciona un sistema de catálogo de metadatos generales para organizar los datos estructurados y el código personalizado. La base de datos es el concepto que agrupa estos objetos relacionados.

Obtenga más información sobre la base de datos de U-SQL y el lenguaje de definición de datos (DDL).

El proyecto de base de datos de U-SQL es un tipo de proyecto de Visual Studio que ayuda a los desarrolladores a desarrollar, administrar e implementar sus bases de datos de U-SQL rápida y fácilmente.

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

Las Herramientas de Azure Data Lake para Visual Studio agregaron una nueva plantilla de proyecto llamada proyecto de base de datos de U-SQL en la versión 2.3.3000.0. Para crear un proyecto de U-SQL, seleccione Archivo > Nuevo > Proyecto. El proyecto de base de datos de U-SQL puede encontrarse en Azure Data Lake > nodo U-SQL.

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

Desarrollo de objetos de bases de datos de U-SQL mediante un proyecto de base de datos

Haga clic con el botón derecho en el proyecto de base de datos de U-SQL. Seleccione Agregar > Nuevo elemento. Puede encontrar todos los nuevos tipos de objetos admitidos en el Asistente para Agregar nuevo elemento.

Para un objeto no ensamblado (por ejemplo, una función con valores de tabla), se crea un nuevo script U-SQL después de agregar el nuevo elemento. Puede empezar a desarrollar la instrucción DDL para ese objeto en el editor.

Para un objeto de ensamblado, la herramienta proporciona un editor de interfaz de usuario fácil de usar que le ayuda a registrar el ensamblado e implementar archivos DLL y otros archivos. Estos pasos le muestran cómo agregar una definición de objeto de ensamblado al proyecto de base de datos de U-SQL:

  1. Agregue las referencias del proyecto de C# que incluya UDO/UDAG/UDF para el proyecto de base de datos de 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 base de datos de U-SQL

  2. En la vista de diseño del ensamblado, elija el ensamblado referenciado en el menú desplegable Create assembly from reference (Crear el ensamblado desde la referencia).

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

  3. 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 tanto en la máquina local como en la máquina de compilación más adelante.

@_DeployTempDirectory es una variable predefinida que apunta 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 en un único script U-SQL en la carpeta DDL y todos los archivos DLL y archivos adicionales para los ensamblados en la carpeta Temp.

Mas información sobre cómo compilar un proyecto de base de datos U-SQL con la línea de comandos de MSBuild y la tarea de compilación de Azure DevOps Services.

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 mediante 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 de U-SQL mediante un proyecto de base de datos de 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 y 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 cargarán todos los recursos (ensamblados y archivos adicionales) y un trabajo de U-SQL que incluya todas las instrucciones DDL enviadas.

    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 mediante el paquete de implementación de base de datos de U-SQL

  1. Abra el Explorador de servidores. A continuación, expanda la cuenta de Azure Data Lake Analytics en la que desee implementar la base de datos.

  2. Haga clic con el botón derecho o mantenga presionada la tecla Bases de datos U-SQL y, a continuación, elija Implementar base de datos.

  3. Defina Origen de la base de datos como la ruta de acceso del paquete de implementación de la base de datos de U-SQL (archivo .usqldbpack).

  4. Escriba el Nombre de base de datos para crear una base de datos. Si hay una base de datos con el mismo nombre que ya existe 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.

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

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

Implementación de una base de datos U-SQL mediante el SDK

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.

Más información sobre el SDK y cómo configurar la canalización de CI/CD para la implementación de bases de datos de U-SQL.

Referencia de un proyecto de base de datos de U-SQL

Un proyecto de U-SQL puede hacer referencia a un proyecto de base de datos de U-SQL. La referencia afecta a dos cargas de trabajo:

Procedimiento para agregar una referencia de base de datos U-SQL

  1. Haga clic con el botón derecho en el Explorador de soluciones y, después, elija Agregar referencia de base de datos U-SQL.

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

  2. Configure una referencia de base de datos desde un proyecto de base de datos U-SQL en la solución actual o un archivo de paquete de base de datos U-SQL.

  3. Proporcione el nombre de la base de datos.

    Asistente para la adición de referencia de proyecto de base de datos de Herramientas de Data Lake para Visual Studio

Pasos siguientes