Eseguire test e debug di processi U-SQL tramite l'esecuzione locale e l'SDK U-SQL di Azure Data LakeTest and debug U-SQL jobs by using local run and the Azure Data Lake U-SQL SDK

È possibile usare Strumenti di Azure Data Lake per Visual Studio e l'SDK U-SQL di Azure Data Lake per eseguire i processi di U-SQL nella workstation, esattamente come nel servizio Azure Data Lake.You can use Azure Data Lake Tools for Visual Studio and the Azure Data Lake U-SQL SDK to run U-SQL jobs on your workstation, just as you can in the Azure Data Lake service. Queste due funzionalità eseguite localmente permettono di risparmiare tempo per le operazioni di test e debug dei processi di U-SQL.These two local-run features save you time in testing and debugging your U-SQL jobs.

Comprendere la cartella data-root e il percorso dei fileUnderstand the data-root folder and the file path

Sia l'SDK di U-SQL che l'esecuzione locale richiedono una cartella data-root.Both local run and the U-SQL SDK require a data-root folder. La cartella data-root è un "archivio locale" per l'account di calcolo locale,The data-root folder is a "local store" for the local compute account. equivalente all'account di Azure Data Lake Store di un account Data Lake Analytics.It's equivalent to the Azure Data Lake Store account of a Data Lake Analytics account. Il passaggio a un'altra cartella data-root è identico al passaggio a un account archivio differente.Switching to a different data-root folder is just like switching to a different store account. Se si vuole accedere a dati comunemente condivisi con cartelle data-root diverse, è necessario usare percorsi assoluti negli script.If you want to access commonly shared data with different data-root folders, you must use absolute paths in your scripts. In alternativa è possibile creare collegamenti simbolici del file system (ad esempio mklink in un sistema NTFS) nella cartella data-root che puntino ai dati condivisi.Or, create file system symbolic links (for example, mklink on NTFS) under the data-root folder to point to the shared data.

La cartella data-root viene usata per:The data-root folder is used to:

  • Archiviare i metadati, inclusi database, tabelle, funzione con valori di tabella e assembly.Store metadata, including databases, tables, table-valued functions (TVFs), and assemblies.
  • Cercare i percorsi di input e output che sono definiti come percorsi relativi in U-SQL.Look up the input and output paths that are defined as relative paths in U-SQL. L'uso di percorsi relativi semplifica la distribuzione dei progetti di U-SQL in Azure.Using relative paths makes it easier to deploy your U-SQL projects to Azure.

Negli script U-SQL è possibile usare sia un percorso relativo sia un percorso assoluto locale.You can use both a relative path and a local absolute path in U-SQL scripts. Il percorso relativo è relativo al percorso della cartella data-root specificato.The relative path is relative to the specified data-root folder path. È consigliabile usare "/" come separatore del percorso per rendere gli script compatibili con il lato server.We recommend that you use "/" as the path separator to make your scripts compatible with the server side. Di seguito sono riportati alcuni esempi di percorsi relativi e dei loro percorsi assoluti equivalenti.Here are some examples of relative paths and their equivalent absolute paths. In questi esempi la cartella data-root è C:\LocalRunDataRoot.In these examples, C:\LocalRunDataRoot is the data-root folder.

Percorso relativoRelative path Percorso assolutoAbsolute path
/abc/def/input.csv/abc/def/input.csv C:\LocalRunDataRoot\abc\def\input.csvC:\LocalRunDataRoot\abc\def\input.csv
abc/def/input.csvabc/def/input.csv C:\LocalRunDataRoot\abc\def\input.csvC:\LocalRunDataRoot\abc\def\input.csv
D:/abc/def/input.csvD:/abc/def/input.csv D:\abc\def\input.csvD:\abc\def\input.csv

Usare l'esecuzione locale per Visual StudioUse local run from Visual Studio

Gli Strumenti di Data Lake per Visual Studio offrono un'esperienza di esecuzione locale di U-SQL in Visual Studio.Data Lake Tools for Visual Studio provides a U-SQL local-run experience in Visual Studio. Questa funzionalità permette di:By using this feature, you can:

  • Eseguire uno script U-SQL in locale, insieme agli assembly C#.Run a U-SQL script locally, along with C# assemblies.
  • Eseguire il debug di un assembly C# localmente.Debug a C# assembly locally.
  • Creare, visualizzare ed eliminare i cataloghi di U-SQL (database locali, assembly, schemi e tabelle) da Esplora server.Create, view, and delete U-SQL catalogs (local databases, assemblies, schemas, and tables) from Server Explorer. Il catalogo locale è disponibile anche in Esplora server.You can also find the local catalog also from Server Explorer.

    Catalogo locale dell'esecuzione locale degli strumenti di Data Lake per Visual Studio

Il programma di installazione di Strumenti di Data Lake crea la cartella C:\LocalRunRoot che diventa la cartella data-root predefinita.The Data Lake Tools installer creates a C:\LocalRunRoot folder to be used as the default data-root folder. Il parallelismo di esecuzione locale predefinito è 1.The default local-run parallelism is 1.

Configurare l'esecuzione locale in Visual StudioTo configure local run in Visual Studio

  1. Aprire Visual Studio.Open Visual Studio.
  2. Aprire Esplora server.Open Server Explorer.
  3. Espandere Azure > Data Lake Analytics.Expand Azure > Data Lake Analytics.
  4. Aprire il menu Data Lake e fare clic su Opzioni e impostazioni.Click the Data Lake menu, and then click Options and Settings.
  5. Nella struttura ad albero a sinistra espandere Azure Data Lake e Generale.In the left tree, expand Azure Data Lake, and then expand General.

    Impostazioni di configurazione dell'esecuzione locale degli strumenti di Data Lake per Visual Studio

Per poter eseguire la funzionalità di esecuzione locale è richiesto un progetto U-SQL di Visual Studio.A Visual Studio U-SQL project is required for performing local run. Questa parte è diversa rispetto all'esecuzione di script U-SQL da Azure.This part is different from running U-SQL scripts from Azure.

Eseguire uno script U-SQL localmenteTo run a U-SQL script locally

  1. Aprire il progetto U-SQL in Visual Studio.From Visual Studio, open your U-SQL project.
  2. In Esplora soluzioni fare clic con il pulsante destro del mouse su uno script U-SQL e selezionare Invia script.Right-click a U-SQL script in Solution Explorer, and then click Submit Script.
  3. Selezionare (Locale) come account di Analytics per eseguire lo script in locale.Select (Local) as the Analytics account to run your script locally. È anche possibile fare clic sull'account (Locale) nella parte superiore della finestra dello script, quindi selezionare Invia (o usare la combinazione di tasti CTRL+F5).You can also click the (Local) account on the top of script window, and then click Submit (or use the Ctrl + F5 keyboard shortcut).

    Processi di invio dell'esecuzione locale degli strumenti di Data Lake per Visual Studio

Eseguire il debug degli script e delle assembly C# in localeDebug scripts and C# assemblies locally

È possibile eseguire il debug degli assembly C# senza inviarli e registrarli al servizio Azure Data Lake Analytics.You can debug C# assemblies without submitting and registering it to Azure Data Lake Analytics Service. È possibile impostare dei punti di interruzione sia nei file dietro il codice, sia nel progetto C# a cui si fa riferimento.You can set breakpoints in both the code behind file and in a referenced C# project.

Per eseguire il debug del codice locale nel file code-behindTo debug local code in code behind file

  1. Impostare dei punti di interruzione nel file dietro il codice.Set breakpoints in the code behind file.
  2. Premere F5 per eseguire il debug dello script in locale.Press F5 to debug the script locally.

Nota

La procedura seguente funziona solo in Visual Studio 2015.The following procedure only works in Visual Studio 2015. Nella versione precedente di Visual Studio potrebbe essere necessario aggiungere manualmente i file .pdb.In older Visual Studio you may need to manually add the pdb files.

Per eseguire il debug del codice locale in un progetto C# a cui si fa riferimentoTo debug local code in a referenced C# project

  1. Creare un progetto Assembly C# e compilarlo per generare l’output dll.Create a C# Assembly project, and build it to generate the output dll.
  2. Registrare la dll utilizzando un'istruzione U-SQL:Register the dll using a U-SQL statement:

     CREATE ASSEMBLY assemblyname FROM @"..\..\path\to\output\.dll";
    
  3. Impostare i punti di interruzione nel codice C#.Set breakpoints in the C# code.

  4. Premere F5 per eseguire il debug dello script con riferimento alla DLL C# in locale.Press F5 to debug the script with referencing the C# dll locally.

Usare l'esecuzione locale dall'SDK U-SQL di Data LakeUse local run from the Data Lake U-SQL SDK

Oltre a eseguire gli script U-SQL localmente con Visual Studio, è possibile usare anche l'SDK U-SQL di Azure Data Lake per eseguire gli script U-SQL localmente con le interfacce della riga di comando e di programmazione.In addition to running U-SQL scripts locally by using Visual Studio, you can use the Azure Data Lake U-SQL SDK to run U-SQL scripts locally with command-line and programming interfaces. In questo modo è possibile scalare il test locale di U-SQL.Through these, you can scale your U-SQL local test.

Sono disponibili altre informazioni sull'SDK U-SQL di Azure Data Lake.Learn more about Azure Data Lake U-SQL SDK.

Passaggi successiviNext steps