Esecuzione locale e debug locale di U-SQL con Visual Studio Code

Prerequisiti

Prima di iniziare queste procedure, verificare che i prerequisiti seguenti siano disponibili:

  • Strumenti di Azure Data Lake per Visual Studio Code. Per istruzioni, vedere Usare Strumenti Azure Data Lake per Visual Studio Code.
  • C# per Visual Studio Code (per eseguire il debug locale di U-SQL).

    Installare C# in Strumenti Data Lake per Visual Studio Code

    Nota

    Attualmente le funzionalità di esecuzione locale e debug locale di U-SQL supportano solo gli utenti di Windows.

Configurare un ambiente di esecuzione locale di U-SQL

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi, quindi digitare ADL: Download LocalRun Dependency (ADL: scarica dipendenza esecuzione locale) per scaricare i pacchetti.

    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. Di seguito è fornito un esempio di percorso:
    C:\Users\xxx\.vscode\extensions\usqlextpublisher.usql-vscode-ext-x.x.x\LocalRunDependency
    Individuare i pacchetti di dipendenza

    a. Per installare BuildTools, seguire le istruzioni della procedura guidata.

    Installare BuildTools

    b. Per installare Win10SDK 10240, seguire le istruzioni della procedura guidata.

    Installare Win10SDK 10240

  3. Configurare la variabile di ambiente. Impostare la variabile di ambiente SCOPE_CPP_SDK per:
    C:\Users\xxx\.vscode\extensions\usqlextpublisher.usql-vscode-ext-x.x.x\LocalRunDependency\CppSDK_3rdparty

  4. Riavviare il sistema operativo per assicurarsi che le impostazioni della variabile di ambiente abbiano effetto.

    Assicurarsi che la variabile di ambiente SCOPE_CPP_SDK sia installata

Avviare il servizio di esecuzione locale e inviare il processo U-SQL a un account locale

Al primo utilizzo viene chiesto di scaricare i pacchetti di dipendenza LocalRun se non sono già installati.

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi e immettere ADL: Start Local Run Service (ADL: avvia servizio di esecuzione locale).
  2. Selezionare Accetto per accettare le condizioni di licenza software Microsoft per la prima volta.

    Accettare le condizioni di licenza software Microsoft

  3. Viene aperta la console dei comandi. 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. Per le altre opzioni è possibile usare il valore predefinito.

    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.

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

  5. Dopo aver inviato il processo è possibile visualizzare i dettagli di invio. Per visualizzare i dettagli di invio selezionare jobUrl nella finestra Output. È possibile visualizzare lo stato di invio del processo anche dalla console dei comandi. Immettere 7 nella console dei comandi se si desidera conoscere ulteriori dettagli del processo.

    Output dell'esecuzione locale di Strumenti Data Lake per Visual Studio Code Stato comandi dell'esecuzione locale di Strumenti Data Lake per Visual Studio Code

Avviare il debug locale per il processo U-SQL

Al primo utilizzo viene chiesto di scaricare i pacchetti di dipendenza LocalRun se non sono già installati.

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi e immettere ADL: Start Local Run Service (ADL: avvia servizio di esecuzione locale). Viene aperta la console dei comandi. Assicurarsi che DataRoot sia impostata.
  2. Impostare un punto di interruzione nel code-behind C#.
  3. Tornare all'editor di script, premere CTRL+MAIUSC+P per aprire il riquadro comandi e immettere Local Debug (Debug locale) per avviare il servizio di debug locale.

Risultati debug locale di Strumenti Data Lake per Visual Studio Code

Passaggi successivi