Ejecutar U-SQL y depurar localmente en Visual Studio Code

  • 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.

En este artículo se describe cómo ejecutar trabajos de U-SQL en un equipo de desarrollo local para acelerar la primeras fases de codificación o depurar código localmente en Visual Studio Code. Para consultar instrucciones sobre las Herramientas de Azure Data Lake para Visual Studio Code, vea Uso de Herramientas de Azure Data Lake para Visual Studio Code.

Únicamente las instalaciones de Windows de las Herramientas de Azure Data Lake para Visual Studio admiten la acción para ejecutar y depurar U-SQL localmente. Las instalaciones en sistemas operativos basados en macOS y Linux no admiten esta característica.

Configuración del entorno de ejecución local de U-SQL

  1. Seleccione Ctrl+Mayús+P para abrir la paleta de comandos y luego escriba ADL: descargar paquete de ejecución local para descargar los paquetes.

    Descarga de los paquetes de dependencia de ADL LocalRun

  2. Busque los paquetes de dependencia de la ruta de acceso que se muestra en el panel Salida y, luego, instale BuildTools y Win10SDK 10240. Esta es una ruta de acceso de ejemplo:
    C:\Users\xxx\AppData\Roaming\LocalRunDependency

    Ubicación de los paquetes de dependencia

    2.1 Para instalar BuildTools, seleccione visualcppbuildtools_full.exe en la carpeta LocalRunDependency y siga las instrucciones del asistente.

    Instalación de BuildTools

    2.2 Para instalar Win10SDK 10240, seleccione sdksetup.exe en la carpeta LocalRunDependency/Win10SDK_10.0.10240_2 y siga las instrucciones del asistente.

    Instalación de Win10SDK 10240

  3. Configure la variable de entorno. Establezca la variable de entorno SCOPE_CPP_SDK en:
    C:\Users\XXX\AppData\Roaming\LocalRunDependency\CppSDK_3rdparty

Inicio del servicio de ejecución local y envío del trabajo de U-SQL a la cuenta local

Para los usuarios nuevos, use ADL: Download Local Run Package para descargar los paquetes de ejecución locales, si no ha configurado el entorno de ejecución local de U-SQL.

  1. Seleccione Ctrl+Mayús+P para abrir la paleta de comandos y luego escriba ADL: iniciar servicio de ejecución local.

  2. Seleccione Aceptar para aceptar los Términos de licencia del software de Microsoft por primera vez.

    Aceptación de los Términos de licencia del software de Microsoft

  3. Se abre la consola cmd. Para los usuarios nuevos, tiene que especificar 3 y asignar la ruta de acceso a la carpeta local para la entrada y salida de datos. Si no ha definido correctamente la ruta de acceso con barras diagonales inversas, pruebe las barras diagonales. Para otras opciones, puede usar los valores predeterminados.

    Cmd de ejecución local de Data Lake Tools para Visual Studio Code

  4. Seleccione Ctrl+Mayús+P para abrir la paleta de comandos, escriba ADL: enviar trabajo y luego seleccionar Local para enviar el trabajo a la cuenta local.

    Selección local de Herramientas de Data Lake para Visual Studio Code

  5. Una vez que envía el trabajo, puede ver los detalles del envío. Para hacerlo, seleccione jobUrl en la ventana Salida. También puede ver el estado de envío del trabajo en la consola cmd. Escriba 7 en la consola cmd si desea más información sobre los detalles del trabajo.

    Salida de ejecución local de Data Lake Tools para Visual Studio CodeEstado de cmd de ejecución local de Data Lake Tools para Visual Studio Code

Inicio de una depuración local para el trabajo de U-SQL

Para los usuarios nuevos:

  1. Use ADL: Download Local Run Package para descargar los paquetes de ejecución locales, si no ha configurado el entorno de ejecución local de U-SQL.
  2. Instale .NET Core SDK 2.0 como se sugiere en el cuadro de mensaje, si no está instalado.   recordatorio de instalación de Dotnet
  3. Instale C# para Visual Studio Code como se sugiere en el cuadro de mensaje, si no está instalado. Seleccione Instalar para continuar y, a continuación, reinicie VS Code.

Recordatorio de instalación de C#

Siga estos pasos para realizar la depuración local:

  1. Seleccione Ctrl+Mayús+P para abrir la paleta de comandos y luego escriba ADL: iniciar servicio de ejecución local. Se abre la consola cmd. Asegúrese de que se establece DataRoot.

  2. Establezca un punto de interrupción en el código subyacente de C#.

  3. Vuelva al editor de scripts, haga clic con el botón derecho y seleccione ADL: Depuración local.

    Resultado de la depuración local de Herramientas de Data Lake para Visual Studio Code

Pasos siguientes