Uso de un proyecto de base de datos de U-SQL para desarrollar una base de datos de U-SQL para Azure Data Lake
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.
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:
Agregue las referencias del proyecto de C# que incluya UDO/UDAG/UDF para el proyecto de base de datos de U-SQL.
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).
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
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 y 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 cargarán todos los recursos (ensamblados y archivos adicionales) y un trabajo de U-SQL que incluya todas las instrucciones DDL enviadas.
Implementación mediante el paquete de implementación de base de datos de U-SQL
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.
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.
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).
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.
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
.
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:
- Compilación del proyecto: configure los entornos de bases de datos referenciadas antes de compilar los scripts U-SQL.
- Ejecución local en cuenta (local-project) : los entornos de bases de datos referenciadas se implementan en la cuenta (local-project) antes de la ejecución del script U-SQL. Más información sobre la ejecución local y las diferencias entre las cuentas (local-machine) y (local-project).
Procedimiento para agregar una referencia de base de datos U-SQL
Haga clic con el botón derecho en el Explorador de soluciones y, después, elija Agregar referencia de base de datos U-SQL.
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.
Proporcione el nombre de la base de datos.