Partilhar via


Executar U-SQL e depurar localmente no Visual Studio Code

Importante

O Azure Data Lake Analytics foi desativado em 29 de fevereiro de 2024. Saiba mais com este anúncio.

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 uma máquina de desenvolvimento local para acelerar as fases iniciais de codificação ou para depurar código localmente no Visual Studio Code. Para obter instruções sobre o Azure Data Lake Tool for Visual Studio Code, consulte Usar o Azure Data Lake Tools for Visual Studio Code.

Somente as instalações do Windows do Azure Data Lake Tools for Visual Studio dão suporte à ação para executar o U-SQL localmente e depurar o U-SQL localmente. As instalações em sistemas operativos baseados em macOS e Linux não suportam esta funcionalidade.

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

  1. Selecione Ctrl+Shift+P para abrir a paleta de comandos e, em seguida, digite ADL: Download Local Run Package para baixar os pacotes.

    Baixe os pacotes de dependência do ADL LocalRun

  2. Localize os pacotes de dependência a partir do caminho mostrado no painel Output e instale BuildTools e Win10SDK 10240. Aqui está um exemplo de caminho:
    C:\Users\xxx\AppData\Roaming\LocalRunDependency

    Localize os pacotes de dependência

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

    instalar BuildTools

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

    Instalar Win10SDK 10240

  3. Configure 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

Para o usuário iniciante, use ADL: Download Local Run Package para baixar pacotes de execução local, se você não tiver configurado ambiente de execução local U-SQL.

  1. Selecione Ctrl+Shift+P para abrir a paleta de comandos e digite ADL: Start Local Run Service.

  2. Selecione Aceitar para aceitar os Termos de Licença para Software Microsoft pela primeira vez.

    aceitar os Termos de Licença para Software Microsoft

  3. O console cmd é aberto. Para usuários iniciantes, você precisa inserir 3e, em seguida, localizar o caminho da pasta local para sua entrada e saída de dados. Caso não consiga definir o caminho com barras invertidas, experimente usar barras para frente. Para outras opções, você pode usar os valores padrão.

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

  4. Selecione Ctrl+Shift+P para abrir a paleta de comandos, digite ADL: Enviar trabalhoe, em seguida, selecione Local para enviar o trabalho para a sua conta local.

    Ferramentas do Data Lake para o Visual Studio Code, selecione local

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

    Ferramentas Data Lake para Visual Studio Code saída de execução local Ferramentas Data Lake para Visual Studio Code status do comando de execução local

Iniciar uma depuração local para a tarefa U-SQL

Para o utilizador pela primeira vez:

  1. Use ADL: Download Local Run Package para baixar pacotes de execução local, se ainda não configuraste o ambiente de execução local U-SQL.
  2. Instale o .NET Core SDK 2.0 como sugerido na caixa de mensagem, se não estiver instalado.   lembrete de instalar Dotnet
  3. Instale o C# para Visual Studio Code como sugerido na caixa de mensagem, se não estiver instalado. Selecione Instalar para continuar e, em seguida, reinicie o VS Code.

Lembrete para instalar o C#

Siga os passos abaixo para realizar a depuração local:

  1. Selecione Ctrl+Shift+P para abrir a paleta de comandos e digite ADL: Start Local Run Service. O console cmd é aberto. Certifique-se de que o DataRoot está definido.

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

  3. De volta ao editor de scripts, clique com o botão direito do mouse e selecione ADL: Local Debug.

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

Próximos passos