Executar U-SQL e depurar localmente no Visual Studio Code

  • Artigo

Importante

O Azure Data Lake Analytics desativado em 29 de fevereiro de 2024. Saiba mais nesse comunicado.

Para análise de dados, sua organização pode usar o Azure Synapse Analytics ou o Microsoft Fabric.

Este artigo descreve como executar trabalhos U-SQL em um computador de desenvolvimento local para acelerar as fases iniciais de codificação ou para depurar o código localmente no Visual Studio Code. Para obter instruções sobre como usar as Ferramentas do Azure Data Lake para Visual Studio Code, confira Usar as Ferramentas do Azure Data Lake para Visual Studio Code.

Apenas Windows instalações de ferramentas do Azure Data Lake para Visual Studio dão suporte a ação para executar o U-SQL localmente e depurar o U-SQL localmente. As instalações em sistemas operacionais baseados em macOS e Linux não dão suporte a esse recurso.

Configurar o ambiente de execução local do U-SQL

  1. Selecione Ctrl+Shift+P para abrir a paleta de comandos e, então, insira ADL: Fazer Download do Pacote de Execução Local para baixar os pacotes.

    Baixar os pacotes de Dependência de LocalRun do ADL

  2. Localize os pacotes de dependência do caminho mostrado no painel Saída abaixo e então instale o BuildTools e o Win10SDK 10240. Aqui está um caminho de exemplo:
    C:\Users\xxx\AppData\Roaming\LocalRunDependency

    Localizar os pacotes de dependência

    2.1 Para instalar o BuildTools, selecione visualcppbuildtools_full.exe na pasta LocalRunDependency e siga as instruções do assistente.

    Instalar BuildTools

    2.2 Para instalar o Win10SDK 10240, selecione sdksetup.exe na pasta LocalRunDependency/Win10SDK_10.0.10240_2 e siga as instruções do assistente.

    Instalar Win10SDK 10240

  3. Defina a variável de ambiente. Defina a variável de ambiente SCOPE_CPP_SDK como:
    C:\Users\XXX\AppData\Roaming\LocalRunDependency\CppSDK_3rdparty

Inicie o serviço de execução local e envie o trabalho U-SQL para uma conta local

Usuário novato: use ADL: Fazer Download do Pacote de Execução Local para baixar pacotes de execução local, se você ainda não tiver configurado o ambiente de execução local U-SQL.

  1. Pressione Ctrl+Shift+P para abrir a paleta de comandos e digite ADL: Iniciar Serviço de Execução Local.

  2. Selecione Aceito para aceitar os termos da Licença de Software da Microsoft pela primeira vez.

    Aceite os Termos de Licença para Software Microsoft

  3. O console cmd é aberto. Aos usuários de primeira viagem, será necessário inserir 3 e insira um caminho de pasta local para os dados de entrada e saída. Se você não tiver êxito ao definir o caminho com barras invertidas, tente avançar barras. Para outras opções, basta simplesmente usar os valores padrão.

    Ferramentas do Data Lake para Visual Studio Code cmd de execução local

  4. Select Ctrl+Shift+P para abrir a paleta de comandos, insira ADL: Enviar Trabalho e selecione Local para enviar o trabalho para sua conta local.

    Ferramentas do Data Lake para Visual Studio Code selecionar local

  5. Depois de enviar o trabalho, você poderá exibir os detalhes de envio. Para exibir os detalhes do envio, selecione jobUrl na janela Saída. Você também pode exibir o status de envio de trabalho do console do cmd. Digite 7 no console do cmd se você quiser saber mais detalhes do trabalho.

    Saída de execução local do Data Lake Tools para Visual Studio CodeStatus do cmd de execução local do Data Lake Tools para Visual Studio Code

Iniciar uma depuração local para o trabalho de U-SQL

Para o usuário novato:

  1. Use ADL: Fazer Download do Pacote de Execução Local para baixar pacotes de execução local, se você ainda não tiver configurado o ambiente de execução local U-SQL.
  2. Instale o SDK 2.0 do .NET Core, conforme sugerido na caixa de mensagem, se não estiver instalado.   lembrete instala Dotnet
  3. Instale o C# para Visual Studio Code, conforme sugerido na caixa de mensagem, se não estiver instalado. Selecione Instalar para continuar e reinicie o VS Code.

Lembrete para instalar o C#

Siga as etapas abaixo para executar a depuração local:

  1. Pressione Ctrl+Shift+P para abrir a paleta de comandos e digite ADL: Iniciar Serviço de Execução Local. O console cmd é aberto. Verifique se DataRoot está definido.

  2. Defina um ponto de interrupção no code-behind do C#.

  3. Volte ao editor de scripts, clique com o botão direito do mouse e selecione ADL: Depuração Local.

    Ferramentas do Data Lake para Visual Studio Code resultado da depuração local

Próximas etapas