Esecuzione locale e debug locale di U-SQL per Windows con Visual Studio CodeU-SQL local run and local debug for Windows with Visual Studio Code

In questo documento vengono fornite informazioni su come eseguire i processi di U-SQL in un computer di sviluppo locale per velocizzare le fasi iniziali di codifica o eseguire il debug di codice in locale in Visual Studio Code.In this document, you learn how to run U-SQL jobs on a local development machine to speed up early coding phases or to debug code locally in Visual Studio Code. Per istruzioni su Strumenti Azure Data Lake per Visual Studio Code, vedere Usare Strumenti Azure Data Lake per Visual Studio Code.For instructions on Azure Data Lake Tool for Visual Studio Code, see Use Azure Data Lake Tools for Visual Studio Code.

Configurare un ambiente di esecuzione locale di U-SQLSet up the U-SQL local run environment

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi e quindi digitare ADL: Download Local Run Dependency (ADL: Scarica dipendenza esecuzione locale) per scaricare i pacchetti.Select Ctrl+Shift+P to open the command palette, and then enter ADL: Download Local Run Dependency to download the packages.

    Scaricare i pacchetti di dipendenza ADL LocalRun

  2. Trovare i pacchetti di dipendenza nel percorso visualizzato nel pannello Output, quindi installare BuildTools e Win10SDK 10240.Locate the dependency packages from the path shown in the Output pane, and then install BuildTools and Win10SDK 10240. Di seguito è fornito un esempio di percorso:Here is an example path:
    C:\Users\xxx\AppData\Roaming\LocalRunDependency

    Individuare i pacchetti di dipendenze

    2.1 Per installare BuildTools, fare clic su visualcppbuildtools_full.exe nella cartella LocalRunDependency e quindi seguire le istruzioni della procedura guidata.2.1 To install BuildTools, click visualcppbuildtools_full.exe in the LocalRunDependency folder, then follow the wizard instructions.

    Installare BuildTools

    2.2 Per installare Win10SDK 10240, fare clic su sdksetup.exe nella cartella LocalRunDependency/Win10SDK_10.0.10240_2 e quindi seguire le istruzioni della procedura guidata.2.2 To install Win10SDK 10240, click sdksetup.exe in the LocalRunDependency/Win10SDK_10.0.10240_2 folder, then follow the wizard instructions.

    Installare Win10SDK 10240

  3. Configurare la variabile di ambiente.Set up the environment variable. Impostare la variabile di ambiente SCOPE_CPP_SDK per:Set the SCOPE_CPP_SDK environment variable to:
    C:\Users\XXX\AppData\Roaming\LocalRunDependency\CppSDK_3rdparty

Avviare il servizio di esecuzione locale e inviare il processo U-SQL a un account localeStart the local run service and submit the U-SQL job to a local account

Per gli utenti non esperti usare il comando ADL: Download Local Run Dependency (ADL: Scarica dipendenza esecuzione locale) per scaricare i pacchetti di esecuzione locali se in precedenza non è stato configurato l'ambiente di esecuzione locale di U-SQL.For the first-time user, use ADL: Download Local Run Dependency to download local run packages, if you have not set up U-SQL local run environment.

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi e immettere ADL: Start Local Run Service (ADL: avvia servizio di esecuzione locale).Select Ctrl+Shift+P to open the command palette, and then enter ADL: Start Local Run Service.
  2. Selezionare Accetto per accettare le condizioni di licenza software Microsoft per la prima volta.Select Accept to accept the Microsoft Software License Terms for the first time.

    Accettare le condizioni di licenza software Microsoft

  3. Viene aperta la console dei comandi.The cmd console opens. Dato che si accede per la prima volta immettere 3 e quindi individuare il percorso di cartella locale per l'input e l'output di dati.For first-time users, you need to enter 3, and then locate the local folder path for your data input and output. Per le altre opzioni è possibile usare il valore predefinito.For other options, you can use the default values.

    Console dei comandi per esecuzione locale di Strumenti Data Lake per Visual Studio Code

  4. Premere CTRL+MAIUSC+P per aprire il riquadro comandi, immettere ADL: Submit Job (ADL: Invia processo), quindi selezionare Local (Locale) per inviare il processo all'account locale.Select Ctrl+Shift+P to open the command palette, enter ADL: Submit Job, and then select Local to submit the job to your local account.

    Selezionare Local (Locale) in Strumenti Data Lake per Visual Studio Code

  5. Dopo aver inviato il processo è possibile visualizzare i dettagli di invio.After you submit the job, you can view the submission details. Per visualizzare i dettagli di invio, selezionare jobUrl nella finestra Output.To view the submission details, select jobUrl in the Output window. È possibile visualizzare lo stato di invio del processo anche dalla console dei comandi.You can also view the job submission status from the cmd console. Immettere 7 nella console dei comandi se si desidera conoscere ulteriori dettagli del processo.Enter 7 in the cmd console if you want to know more job details.

    Output dell'esecuzione locale di Strumenti Data Lake per Visual Studio Code Stato comandi dell'esecuzione locale di Strumenti Data Lake per Visual Studio CodeData Lake Tools for Visual Studio Code local run output Data Lake Tools for Visual Studio Code local run cmd status

Avviare il debug locale per il processo U-SQLStart a local debug for the U-SQL job

Per gli utenti non esperti:For the first-time user:

  1. Usare il comando ADL: Download Local Run Dependency (ADL: Scarica dipendenza esecuzione locale) per scaricare i pacchetti di esecuzione locali se in precedenza non è stato configurato l'ambiente di esecuzione locale di U-SQL.Use ADL: Download Local Run Dependency to download local run packages, if you have not set up U-SQL local run environment.
  2. Installare .NET Core SDK 2.0 come suggerito nella finestra di messaggio, se non è già installato.Install .NET Core SDK 2.0 as suggested in the message box, if not installed.

    Promemoria di installazione di Dotnet

  3. Installare C# per Visual Studio Code come suggerito nella finestra di messaggio, se non è già installato.Install C# for Visual Studio Code as suggested in the message box if not installed. Fare clic su Installa per continuare e quindi riavviare VSCode.Click Install to continue, and then restart VSCode.

    Promemoria di installazione di C#

Attenersi alla procedura seguente per eseguire il debug locale:Follow steps below to perform local debug:

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi e immettere ADL: Start Local Run Service (ADL: avvia servizio di esecuzione locale).Select Ctrl+Shift+P to open the command palette, and then enter ADL: Start Local Run Service. Viene aperta la console dei comandi.The cmd console opens. Assicurarsi che DataRoot sia impostata.Make sure that the DataRoot is set.
  2. Impostare un punto di interruzione nel code-behind C#.Set a breakpoint in your C# code-behind.
  3. Nell'editor di script fare clic con il pulsante destro del mouse e selezionare ADL: Local Debug (ADL: Debug locale).Back to script editor, right-click and select ADL: Local Debug.

    Risultati debug locale di Strumenti Data Lake per Visual Studio Code

Passaggi successiviNext steps