Usare gli Strumenti Azure Data Lake per Visual Studio CodeUse Azure Data Lake Tools for Visual Studio Code

In questo articolo si apprenderà come usare gli Strumenti Azure Data Lake per Visual Studio Code (VS Code) per creare, testare ed eseguire gli script U-SQL.In this article, learn how you can use Azure Data Lake Tools for Visual Studio Code (VS Code) to create, test, and run U-SQL scripts. Le informazioni sono disponibili anche nel video seguente:The information is also covered in the following video:

prerequisitiPrerequisites

Gli Strumenti Azure Data Lake per VS Code supportano Windows, Linux e MacOS.Azure Data Lake Tools for VS Code supports Windows, Linux, and MacOS.

Per MacOS e Linux:For MacOS and Linux:

Installare Azure Data Lake ToolsInstall Azure Data Lake Tools

Dopo avere installato i prerequisiti, è possibile installare Strumenti Azure Data Lake per VS Code.After you install the prerequisites, you can install Azure Data Lake Tools for VS Code.

Per installare Strumenti Azure Data LakeTo install Azure Data Lake Tools

  1. Aprire Visual Studio Code.Open Visual Studio Code.
  2. Selezionare Estensioni nel riquadro sinistro.Select Extensions in the left pane. Immettere Strumenti Azure Data Lake nella casella di ricerca.Enter Azure Data Lake Tools in the search box.
  3. Selezionare Installa accanto a Strumenti Azure Data Lake.Select Install next to Azure Data Lake Tools.

    Selezioni per l'installazione degli Strumenti Data Lake

    Dopo alcuni secondi il pulsante Installa diventa Ricarica.After a few seconds, the Install button changes to Reload.

  4. Scegliere Ricarica per attivare l'estensione Strumenti Azure Data Lake.Select Reload to activate the Azure Data Lake Tools extension.
  5. Selezionare Ricarica finestra per confermare.Select Reload Window to confirm. La voce Strumenti Azure Data Lake sarà visualizzata nel riquadro Estensioni.You can see Azure Data Lake Tools in the Extensions pane.

Attivare Strumenti Azure Data LakeActivate Azure Data Lake Tools

Creare un file con estensione usql o aprirne uno esistente per attivare l'estensione.Create a .usql file or open an existing .usql file to activate the extension.

Uso di U-SQLWork with U-SQL

Per usare U-SQL, è necessario aprire una cartella o un file U-SQL.To work with U-SQL, you need open either a U-SQL file or a folder.

Per aprire lo script di esempioTo open the sample script

Usare il riquadro comandi (CTRL+MAIUSC+P) e immettere ADL: Open Sample Script (ADL: Apri script di esempio).Open the command palette (Ctrl+Shift+P) and enter ADL: Open Sample Script. Viene aperta un'altra istanza di questo esempio.It opens another instance of this sample. In questa istanza è anche possibile modificare, configurare e inviare uno script.You can also edit, configure, and submit a script on this instance.

Aprire una cartella per il progetto U-SQLTo open a folder for your U-SQL project

  1. Da Visual Studio Code selezionare il menu File e quindi selezionare Apri cartella.From Visual Studio Code, select the File menu, and then select Open Folder.
  2. Specificare una cartella e quindi scegliere Seleziona cartella.Specify a folder, and then select Select Folder.
  3. Selezionare il menu File e quindi scegliere Nuovo.Select the File menu, and then select New. Un file Untilted-1 viene aggiunto al progetto.An Untitled-1 file is added to the project.
  4. Immettere il codice seguente nel file Untitled-1:Enter the following code in the Untitled-1 file:

     @departments  = 
         SELECT * FROM 
             (VALUES
                 (31,    "Sales"),
                 (33,    "Engineering"), 
                 (34,    "Clerical"),
                 (35,    "Marketing")
             ) AS 
                   D( DepID, DepName );
    
     OUTPUT @departments
         TO "/Output/departments.csv"
     USING Outputters.Csv();
    

    Lo script crea un file departments.csv con alcuni dati inclusi nella cartella /output.The script creates a departments.csv file with some data included in the /output folder.

  5. Salvare il file come myUSQL.usql nella cartella aperta.Save the file as myUSQL.usql in the opened folder.

Compilare uno script U-SQLTo compile a U-SQL script

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Compile Script.Enter ADL: Compile Script. I risultati di compilazione vengono visualizzati nella finestra Output.The compile results appear in the Output window. È anche possibile fare clic con il pulsante destro del mouse su un file di script e selezionare ADL: Compile Script (ADL: Compila script) per eseguire la compilazione di un processo U-SQL.You can also right-click a script file, and then select ADL: Compile Script to compile a U-SQL job. Il risultato della compilazione viene visualizzato nel riquadro Output.The compilation result appears in the Output pane.

Inviare uno script U-SQLTo submit a U-SQL script

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Submit Job.Enter ADL: Submit Job. È anche possibile fare clic con il pulsante destro del mouse su un file di script e selezionare ADL: Invia processo.You can also right-click a script file, and then select ADL: Submit Job.

Dopo aver inviato un processo U-SQL, i log di invio vengono visualizzati nella finestra Output in VS Code.After you submit a U-SQL job, the submission logs appear in the Output window in VS Code. La visualizzazione del processo appare nel riquadro di destra.The job view appears in the right pane. Se l'invio ha esito positivo, viene visualizzato anche l'URL del processo.If the submission is successful, the job URL appears too. È possibile aprire l'URL del processo in un Web browser per monitorare lo stato del processo in tempo reale.You can open the job URL in a web browser to track the real-time job status.

Nella scheda RIEPILOGO della visualizzazione del processo è possibile vedere i dettagli del processo.On the job view's SUMMARY tab, you can see the job details. Le funzioni principali includono il reinvio e la duplicazione di uno script e l'apertura nel portale.Main functions include resubmit a script, duplicate a script, and open in the portal. Nella scheda DATI della visualizzazione del processo è possibile fare riferimento a file di input, di output e di risorse.On the job view's DATA tab, you can refer to the input files, output files, and resource files. I file possono essere scaricati nel computer locale.Files can be downloaded to the local computer.

Scheda Riepilogo nella visualizzazione del processo

Scheda Dati nella visualizzazione del processo

Per impostare il contesto predefinitoTo set the default context

È possibile impostare il contesto predefinito per applicare questa impostazione a tutti i file di script, se non sono stati impostati parametri specifici per ogni file.You can set the default context to apply this setting to all script files if you have not set parameters for files individually.

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Set Default Context (ADL: Imposta contesto predefinito).Enter ADL: Set Default Context. Oppure fare clic con il pulsante destro del mouse sull'editor di script e scegliere ADL: Set Default Context (ADL: Imposta contesto predefinito).Or right-click the script editor and select ADL: Set Default Context.
  3. Scegliere l'account, il database e lo schema desiderato.Choose the account, database, and schema that you want. L'impostazione viene salvata nel file di configurazione xxx_settings.json.The setting is saved to the xxx_settings.json configuration file.

    Account, database e schema impostati come contesto predefinito

Per impostare i parametri di scriptTo set script parameters

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Set Script Parameters (ADL: Imposta parametri di script).Enter ADL: Set Script Parameters.
  3. Si apre il file xxx_settings.json con le proprietà seguenti:The xxx_settings.json file is opened with the following properties:

    • account: un account di Azure Data Lake Analytics nella sottoscrizione di Azure necessario per compilare ed eseguire i processi U-SQL.account: An Azure Data Lake Analytics account under your Azure subscription that's needed to compile and run U-SQL jobs. È necessario configurare l'account del computer prima di compilare ed eseguire i processi di U-SQL.You need configure the computer account before you compile and run U-SQL jobs.
    • database: un database nel proprio account.database: A database under your account. Il database predefinito è master.The default is master.
    • schema: uno schema nel database.schema: A schema under your database. Lo schema è dbo.The default is dbo.
    • optionalSettings:optionalSettings:
      • priority: l'intervallo di priorità va da 1 a 1000 dove la priorità più alta corrisponde al valore 1.priority: The priority range is from 1 to 1000, with 1 as the highest priority. Il valore predefinito è 1000.The default value is 1000.
      • degreeOfParallelism: l'intervallo di parallelismo va da 1 a 150.degreeOfParallelism: The parallelism range is from 1 to 150. Il valore predefinito è il parallelismo massimo consentito nell'account Azure Data Lake Analytics.The default value is the maximum parallelism allowed in your Azure Data Lake Analytics account.

    Contenuto del file JSON

Nota

Dopo il salvataggio della configurazione, se non è stato configurato un contesto predefinito, le informazioni relative ad account, database e schema vengono visualizzate sulla barra di stato nell'angolo inferiore sinistro del file con estensione usql corrispondente.After you save the configuration, the account, database, and schema information appear on the status bar at the lower-left corner of the corresponding .usql file if you don’t have a default context set up.

Per impostare Git IgnoreTo set Git ignore

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Set Git Ignore (ADL: Imposta Git Ignore).Enter ADL: Set Git Ignore.

    • Se nella cartella di lavoro di VS Code non è presente un file con estensione gitIgnore, nella cartella viene creato un file denominato .gitIgnore.If you don’t have a .gitIgnore file in your VS Code working folder, a file named .gitIgnore is created in your folder. Per impostazione predefinita, nel file vengono aggiunti quattro elementi: usqlCodeBehindReference, usqlCodeBehindGenerated, .cache e obj.Four items (usqlCodeBehindReference, usqlCodeBehindGenerated, .cache, obj) are added in the file by default. Se necessario, è possibile effettuare altri aggiornamenti.You can make more updates if needed.
    • Se nella cartella di lavoro di VS Code è già presente un file con estensione gitIgnore e nel file non sono presenti gli elementi usqlCodeBehindReference, usqlCodeBehindGenerated, .cache e obj, lo strumento li aggiunge al file con estensione gitIgnore.If you already have a .gitIgnore file in your VS Code working folder, the tool adds four items (usqlCodeBehindReference, usqlCodeBehindGenerated, .cache, obj) in your .gitIgnore file if the four items were not included in the file.

    Elementi del file con estensione gitIgnore

Usare file code-behind: C Sharp, Python e RWork with code-behind files: C Sharp, Python, and R

Azure Data Lake Tools supporta più codici personalizzati.Azure Data Lake Tools supports multiple custom codes. Per istruzioni, vedere Eseguire lo sviluppo U-SQL con Python, R e C# per Azure Data Lake Analytics in Visual Studio Code.For instructions, see Develop U-SQL with Python, R, and C Sharp for Azure Data Lake Analytics in VS Code.

Usare gli assemblyWork with assemblies

Per informazioni sullo sviluppo di assembly, vedere Develop U-SQL assemblies for Azure Data Lake Analytics jobs (Sviluppare assembly U-SQL per i processi di Azure Data Lake Analytics).For information on developing assemblies, see Develop U-SQL assemblies for Azure Data Lake Analytics jobs.

È possibile usare Strumenti Data Lake per registrare gli assembly di codice personalizzato nel catalogo di Data Lake Analytics.You can use Data Lake Tools to register custom code assemblies in the Data Lake Analytics catalog.

Registrare un assemblyTo register an assembly

È possibile registrare l'assembly tramite il comando ADL: Register Assembly (ADL: Registra assembly) o ADL: Register Assembly (Advanced) (ADL: Registra assembly (Opzioni avanzate)).You can register the assembly through the ADL: Register Assembly or ADL: Register Assembly (Advanced) command.

Per eseguire la registrazione mediante il comando ADL: Register Assembly (ADL: Registra assembly)To register through the ADL: Register Assembly command

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Register Assembly (ADL: Registra assembly).Enter ADL: Register Assembly.
  3. Specificare il percorso dell'assembly locale.Specify the local assembly path.
  4. Selezionare un account di Data Lake Analytics.Select a Data Lake Analytics account.
  5. Selezionare un database.Select a database.

Il portale si apre in un browser e visualizza il processo di registrazione dell'assembly.The portal is opened in a browser and displays the assembly registration process.

Un modo più pratico per attivare il comando ADL: Register Assembly (ADL: Registra assembly) consiste nel fare clic con il pulsante destro del mouse sul file con estensione dll in Esplora file.A more convenient way to trigger the ADL: Register Assembly command is to right-click the .dll file in File Explorer.

Per eseguire la registrazione con il comando ADL: Register Assembly (ADL: Registra assembly (Opzioni avanzate))To register through the ADL: Register Assembly (Advanced) command

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Register Assembly (Advanced) (ADL: Registra assembly (avanzato)).Enter ADL: Register Assembly (Advanced).
  3. Specificare il percorso dell'assembly locale.Specify the local assembly path.
  4. Verrà visualizzato il file JSON.The JSON file is displayed. Esaminare e modificare le dipendenze dell'assembly e i parametri delle risorse, se necessario.Review and edit the assembly dependencies and resource parameters, if needed. Le istruzioni sono visualizzate nella finestra Output.Instructions are displayed in the Output window. Salvare (CTRL+S) il file JSON per procedere con la registrazione dell'assembly.To proceed to the assembly registration, save (Ctrl+S) the JSON file.

    File JSON con dipendenze dell'assembly e i parametri delle risorse

Nota

  • Strumenti Azure Data Lake rileva automaticamente se la DLL include dipendenze dell'assembly.Azure Data Lake Tools autodetects whether the DLL has any assembly dependencies. Le dipendenze vengono visualizzate nel file JSON dopo che sono state rilevate.The dependencies are displayed in the JSON file after they're detected.
  • È possibile caricare le risorse DLL (ad esempio file con estensione txt, png e csv) nel corso della registrazione dell'assembly.You can upload your DLL resources (for example, .txt, .png, and .csv) as part of the assembly registration.

Un altro modo per attivare il comando ADL: Register Assembly (Advanced) (ADL: Registra assembly (avanzato)) consiste nel fare clic con il pulsante destro del mouse sul file con estensione dll in Esplora file.Another way to trigger the ADL: Register Assembly (Advanced) command is to right-click the .dll file in File Explorer.

Il codice U-SQL seguente illustra come chiamare un assembly.The following U-SQL code demonstrates how to call an assembly. Nell'esempio il nome dell'assembly è test.In the sample, the assembly name is test.

    REFERENCE ASSEMBLY [test];

    @a = 
        EXTRACT 
            Iid int,
        Starts DateTime,
        Region string,
        Query string,
        DwellTime int,
        Results string,
        ClickedUrls string 
        FROM @"Sample/SearchLog.txt" 
        USING Extractors.Tsv();

    @d =
        SELECT DISTINCT Region 
        FROM @a;

    @d1 = 
        PROCESS @d
        PRODUCE 
            Region string,
        Mkt string
        USING new USQLApplication_codebehind.MyProcessor();

    OUTPUT @d1 
        TO @"Sample/SearchLogtest.txt" 
        USING Outputters.Tsv();

Usare l'esecuzione e il debug locali di U-SQL per utenti WindowsUse U-SQL local run and local debug for Windows users

L'esecuzione locale di U-SQL verifica i dati locali e convalida lo script localmente prima che il codice venga pubblicato in Data Lake Analytics.U-SQL local run tests your local data and validates your script locally before your code is published to Data Lake Analytics. È possibile usare la funzionalità di debug locale per completare le attività seguenti prima che il codice venga inviato a Data Lake Analytics:You can use the local debug feature to complete the following tasks before your code is submitted to Data Lake Analytics:

  • Eseguire il debug del code-behind di C#.Debug your C# code-behind.
  • Eseguire il codice passo per passo.Step through the code.
  • Convalidare lo script in locale.Validate your script locally.

Per istruzioni sull'esecuzione e il debug locali, vedere Esecuzione locale e debug locale di U-SQL con Visual Studio Code.For instructions on local run and local debug, see U-SQL local run and local debug with Visual Studio Code.

Connect to AzureConnect to Azure

Prima di compilare ed eseguire gli script U-SQL in Data Lake Analytics, è necessario connettersi al proprio account di Azure.Before you can compile and run U-SQL scripts in Data Lake Analytics, you must connect to your Azure account.

Per connettersi ad Azure tramite un comandoTo connect to Azure by using a command

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: Login (ADL: Accedi).Enter ADL: Login. Le informazioni di accesso vengono visualizzate in basso a destra.The login information appears on the lower right.

    Immissione del comando di accesso

    Notifica di accesso e di autenticazione

  3. Fare clic su Copy & Open (Copia e apri) per aprire la pagina Web di accesso.Select Copy & Open to open the login webpage. Incollare il codice nella casella e quindi selezionare Continua.Paste the code into the box, and then select Continue.

    Pagina Web di accesso

  4. Seguire le istruzioni per accedere dalla pagina Web.Follow the instructions to sign in from the webpage. Quando si è connessi viene visualizzato il nome di account di Azure sulla barra di stato nell'angolo inferiore sinistro della finestra VS Code.When you're connected, your Azure account name appears on the status bar in the lower-left corner of the VS Code window.

Nota

  • Se non si effettua la disconnessione, Data Lake Tools effettuerà automaticamente l'accesso la volta successiva.Data Lake Tools automatically signs you in the next time if you don't sign out.
  • Se l'account ha due fattori abilitati, è consigliabile usare l'autenticazione telefonica anziché un PIN.If your account has two factors enabled, we recommend that you use phone authentication rather than using a PIN.

Per disconnettersi immettere il comando ADL: Logout (ADL: Disconnetti).To sign out, enter the command ADL: Logout.

Per connettersi ad Azure da ExplorerTo connect to Azure from the explorer

Espandere AZURE DATALAKE, selezionare Sign in to Azure (Accedi ad Azure), quindi seguire i passaggi 3 e 4 della sezione Per connettersi ad Azure tramite un comando.Expand AZURE DATALAKE, select Sign in to Azure, and then follow step 3 and step 4 of To connect to Azure by using a command.

Selezione di "Accedi ad Azure" in Explorer

Non è possibile disconnettersi da Explorer.You can't sign out from the explorer. Per disconnettersi, vedere Per connettersi ad Azure tramite un comando.To sign out, see To connect to Azure by using a command.

Creare uno script di estrazioneCreate an extraction script

È possibile creare un script di estrazione per file con estensione csv, tsv e txt usando il comando ADL: Crea script EXTRACT o da Azure Data Lake Explorer.You can create an extraction script for .csv, .tsv, and .txt files by using the command ADL: Create EXTRACT Script or from the Azure Data Lake explorer.

Per creare uno script di estrazione tramite un comandoTo create an extraction script by using a command

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi e immettere ADL: Crea script EXTRACT.Select Ctrl+Shift+P to open the command palette, and enter ADL: Create EXTRACT Script.
  2. Specificare il percorso completo di un file di Archiviazione di Azure e premere INVIO.Specify the full path for an Azure Storage file, and select the Enter key.
  3. Selezionare un account.Select one account.
  4. Per il file con estensione txt, selezionare un delimitatore per estrarre il file.For a .txt file, select a delimiter to extract the file.

Processo per la creazione di uno script di estrazione

Lo script di estrazione viene generato in base ai valori immessi.The extraction script is generated based on your entries. Per uno script che non è in grado di rilevare le colonne, scegliere una tra le due opzioni.For a script that cannot detect the columns, choose one from the two options. In caso contrario, verrà generato un solo script.If not, only one script will be generated.

Risultato della creazione di uno script di estrazione

Per creare uno script di estrazione da ExplorerTo create an extraction script from the explorer

È possibile creare lo script di estrazione anche tramite il menu di scelta rapida che è possibile visualizzare facendo clic con il pulsante destro del mouse sul file con estensione csv, tsv o txt in Azure Data Lake Store o nell'archiviazione BLOB di Azure.Another way to create the extraction script is through the right-click (shortcut) menu on the .csv, .tsv, or .txt file in Azure Data Lake Store or Azure Blob storage.

Comando "Crea script EXTRACT" dal menu di scelta rapida

Integrazione con Azure Data Lake Analytics tramite un comandoIntegrate with Azure Data Lake Analytics through a command

È possibile accedere alle risorse di Azure Data Lake Analytics per elencare gli account, accedere ai metadati e visualizzare i processi di analisi.You can access Azure Data Lake Analytics resources to list accounts, access metadata, and view analytics jobs.

Per elencare gli account Azure Data Lake Analytics della sottoscrizione di AzureTo list the Azure Data Lake Analytics accounts under your Azure subscription

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere ADL: List Accounts (ADL: Elenca gli account).Enter ADL: List Accounts. L'account viene visualizzato nel riquadro Output.The accounts appear in the Output pane.

Per accedere ai metadati di Azure Data Lake AnalyticsTo access Azure Data Lake Analytics metadata

  1. Premere CTRL+MAIUSC+P e digitare ADL: List Tables (ADL: Elenca tabelle).Select Ctrl+Shift+P, and then enter ADL: List Tables.
  2. Selezionare uno degli account di Data Lake Analytics.Select one of the Data Lake Analytics accounts.
  3. Selezionare uno dei database di Data Lake Analytics.Select one of the Data Lake Analytics databases.
  4. Selezionare uno degli schemi.Select one of the schemas. È possibile visualizzare l'elenco delle tabelle.You can see the list of tables.

Per visualizzare i processi di Azure Data Lake AnalyticsTo view Azure Data Lake Analytics jobs

  1. Aprire il riquadro comandi (CTRL+MAIUSC+P) e selezionare ADL: Show Jobs (ADL: Mostra processi).Open the command palette (Ctrl+Shift+P) and select ADL: Show Jobs.
  2. Selezionare un account di Data Lake Analytics o locale.Select a Data Lake Analytics or local account.
  3. Attendere che venga visualizzato l'elenco dei processi per l'account.Wait for the job list to appear for the account.
  4. Selezionare un processo nell'elenco dei processi.Select a job from the job list. Strumenti Data Lake aprirà la visualizzazione del processo nel riquadro di destra e visualizzerà alcune informazioni nell'output VS Code.Data Lake Tools opens the job view in the right pane and displays some information in the VS Code output.

    Elenco processi

Integrazione con Azure Data Lake Store tramite un comandoIntegrate with Azure Data Lake Store through a command

È possibile usare i comandi correlati ad Azure Data Lake Store per:You can use Azure Data Lake Store-related commands to:

Elencare il percorso di archiviazioneList the storage path

Per elencare il percorso di archiviazione tramite il riquadro comandiTo list the storage path through the command palette

  1. Fare clic con il pulsante destro del mouse sull'editor di script e scegliere ADL: List Path (ADL: Elenca percorso).Right-click the script editor and select ADL: List Path.
  2. Scegliere la cartella nell'elenco o fare clic su Enter Path (Immetti un percorso) o su Browse from Root (Sfoglia da radice).Choose the folder in the list, or select Enter a path or Browse from root path. Questo passaggio usa Enter a path (Immetti un percorso) come esempio.(We're using Enter a path as an example.)
  3. Selezionare l'account di Data Lake Analytics.Select your Data Lake Analytics account.
  4. Andare al percorso della cartella di archiviazione o immetterlo manualmente, ad esempio /output/.Browse to or enter the storage folder path (for example, /output/).

Il riquadro comandi elenca le informazioni sul percorso in base all'input.The command palette lists the path information based on your entries.

Risultati del percorso di archiviazione

Un modo più pratico per elencare il percorso relativo consiste nell'usare il menu di scelta rapida.A more convenient way to list the relative path is through the shortcut menu.

Per elencare il percorso di archiviazione tramite il menu di scelta rapidaTo list the storage path through the shortcut menu

Fare clic con il pulsante destro del mouse sulla stringa del percorso e scegliere List Path (Elenca percorso).Right-click the path string and select List Path.

"List Path" (Elenca percorso) nel menu di scelta rapida

Visualizzare in anteprima il file di archiviazionePreview the storage file

  1. Fare clic con il pulsante destro del mouse sull'editor di script e scegliere ADL: Preview File (ADL: Anteprima file).Right-click the script editor and select ADL: Preview File.
  2. Selezionare l'account di Data Lake Analytics.Select your Data Lake Analytics account.
  3. Immettere un percorso di file di Archiviazione di Azure, ad esempio /output/SearchLog.txt.Enter an Azure Storage file path (for example, /output/SearchLog.txt).

Il file si apre in VS Code.The file opens in VS Code.

Passaggi e risultati per visualizzare in anteprima il file di archiviazione

Un altro modo per visualizzare l'anteprima del file è attraverso il menu di scelta rapida sul percorso completo o sul percorso relativo del file nell'editor di script.Another way to preview the file is through the shortcut menu on the file's full path or the file's relative path in the script editor.

Caricare un file o una cartellaUpload a file or folder

  1. Fare clic con il pulsante destro del mouse sull'editor di script e scegliere Upload File (Carica file) o Upload Folder (Carica cartella).Right-click the script editor and select Upload File or Upload Folder.
  2. Scegliere uno o più file se è stata selezionata l'opzione Carica file oppure scegliere l'intera cartella se è stata selezionata l'opzione Upload Folder (Carica cartella).Choose one file or multiple files if you selected Upload File, or choose the whole folder if you selected Upload Folder. Selezionare quindi Carica.Then select Upload.
  3. Scegliere la cartella di archiviazione nell'elenco o selezionare Enter Path (Immetti un percorso) o su Browse from Root (Sfoglia da radice).Choose the storage folder in the list, or select Enter a path or Browse from root path. Questo passaggio usa Enter a path (Immetti un percorso) come esempio.(We're using Enter a path as an example.)
  4. Selezionare l'account di Data Lake Analytics.Select your Data Lake Analytics account.
  5. Andare al percorso della cartella di archiviazione o immetterlo manualmente, ad esempio /output/.Browse to or enter the storage folder path (for example, /output/).
  6. Scegliere Choose Current Folder (Scegli cartella corrente) per specificare la destinazione di caricamento.Select Choose Current Folder to specify your upload destination.

Passaggi e risultati per il caricamento di un file o di una cartella

Un altro modo per caricare file da archiviare è attraverso il menu di scelta rapida sul percorso completo o sul percorso relativo del file nell'editor di script.Another way to upload files to storage is through the shortcut menu on the file's full path or the file's relative path in the script editor.

È possibile monitorare lo stato di caricamento.You can monitor the upload status.

Scaricare un fileDownload a file

È possibile scaricare un file usando i comandi ADL: Download File (ADL: Scarica file) o ADL: Download File (Advanced) (ADL: Scarica file - (Opzioni avanzate)).You can download a file by using the command ADL: Download File or ADL: Download File (Advanced).

Per scaricare un file tramite il comando ADL: Download file (Advanced) (ADL: Scarica file - (Opzioni avanzate))To download a file through the ADL: Download File (Advanced) command

  1. Fare clic con il pulsante destro del mouse sull'editor di script e scegliere Download file (Advanced) (Scarica file - Opzioni avanzate).Right-click the script editor, and then select Download File (Advanced).
  2. VS Code visualizza un file JSON.VS Code displays a JSON file. È possibile immettere i percorsi di file e scaricare più file contemporaneamente.You can enter file paths and download multiple files at the same time. Le istruzioni sono visualizzate nella finestra Output.Instructions are displayed in the Output window. Salvare (CTRL+S) il file JSON per procedere con il download dei file.To proceed to download the file or files, save (Ctrl+S) the JSON file.

    File JSON con i percorsi per il download dei file

La finestra Output mostra lo stato del download dei file.The Output window displays the file download status.

Finestra di output con lo stato del download

È possibile monitorare lo stato del download.You can monitor the download status.

Per scaricare un file tramite il comando ADL: Download file (ADL: Scarica file)To download a file through the ADL: Download File command

  1. Fare clic con il pulsante destro del mouse sull'editor di script, scegliere Download File (Scarica file) e quindi selezionare la cartella di destinazione nella finestra di dialogo Select Folder (Seleziona cartella).Right-click the script editor, select Download File, and then select the destination folder from the Select Folder dialog box.
  2. Scegliere la cartella nell'elenco o fare clic su Enter Path (Immetti un percorso) o su Browse from Root (Sfoglia da radice).Choose the folder in the list, or select Enter a path or Browse from root path. Questo passaggio usa Enter a path (Immetti un percorso) come esempio.(We're using Enter a path as an example.)
  3. Selezionare l'account di Data Lake Analytics.Select your Data Lake Analytics account.
  4. Andare al percorso della cartella di archiviazione o immetterlo manualmente, ad esempio /output/, e scegliere un file da scaricare.Browse to or enter the storage folder path (for example, /output/), and then choose a file to download.

Passaggi e risultati per il download di un file

Un altro modo per scaricare file di archiviazione è attraverso il menu di scelta rapida sul percorso completo o sul percorso relativo del file nell'editor di script.Another way to download storage files is through the shortcut menu on the file's full path or the file's relative path in the script editor.

È possibile monitorare lo stato del download.You can monitor the download status.

Controllare lo stato delle attività di archiviazioneCheck storage tasks' status

Sulla barra di stato viene visualizzato lo stato del caricamento e del download.The upload and download status appears on the status bar. Selezionare la barra di stato: viene visualizzato lo stato nella scheda OUTPUT.Select the status bar, and then the status appears on the OUTPUT tab.

Dettagli della barra di stato e di output

Integrazione con Azure Data Lake Analytics da ExplorerIntegrate with Azure Data Lake Analytics from the explorer

Dopo l'accesso, tutte le sottoscrizioni dell'account Azure sono elencate nel riquadro sinistro di AZURE DATALAKE.After you log in, all the subscriptions for your Azure account are listed in the left pane, under AZURE DATALAKE.

Data Lake Explorer

Navigazione nei metadati di Data Lake AnalyticsData Lake Analytics metadata navigation

Espandere la sottoscrizione di Azure.Expand your Azure subscription. Sotto il nodo Database U-SQL, è possibile esplorare il database U-SQL e visualizzare cartelle come Schemi, Credenziali, Assembly, Tabelle e Indice.Under the U-SQL Databases node, you can browse through your U-SQL database and view folders like Schemas, Credentials, Assemblies, Tables, and Index.

Gestione delle entità dei metadati di Azure Data Lake AnalyticsData Lake Analytics metadata entity management

Espandere i database U-SQL.Expand U-SQL Databases. È possibile creare un database, uno schema, una tabella, un tipo di tabella, un indice o una statistica facendo clic sul nodo corrispondente e quindi selezionando Script to Create (Script per la creazione) nel menu di scelta rapida.You can create a database, schema, table, table type, index, or statistic by right-clicking the corresponding node, and then selecting Script to Create on the shortcut menu. Nella pagina dello script aperta modificare lo script in base alle esigenze.On the opened script page, edit the script according to your needs. Quindi inviare il processo facendo clic su di esso e selezionando ADL: Submit Job (ADL: Invia processo).Then submit the job by right-clicking it and selecting ADL: Submit Job.

Al termine della creazione dell'elemento, fare clic con il pulsante destro del mouse sul nodo e quindi selezionare Aggiorna per visualizzare l'elemento.After you finish creating the item, right-click the node and then select Refresh to show the item. È anche possibile eliminare l'elemento facendo clic con il pulsante destro del mouse su di esso e scegliendo Elimina.You can also delete the item by right-clicking it and then selecting Delete.

Comando "Script to Create" (Script per la creazione) nel menu di scelta rapida in Data Lake Explorer

Pagina dello script per il nuovo elemento

Registrazione dell'assembly Data Lake AnalyticsData Lake Analytics assembly registration

È possibile registrare un assembly nel database corrispondente facendo clic con il pulsante destro del mouse sul nodo Assembly e selezionando Registra assembly.You can register an assembly in the corresponding database by right-clicking the Assemblies node, and then selecting Register assembly.

Comando "Registra assembly" nel menu di scelta rapida del nodo di Assembly

Integrazione con Azure Data Lake Store da ExplorerIntegrate with Azure Data Lake Store from the explorer

Passare a Data Lake Store:Browse to Data Lake Store:

  • Nel nodo della cartella è possibile fare clic con il pulsante destro del mouse e usare i comandi Aggiorna, Elimina, Carica, Upload Folder (Carica cartella), Copia percorso relativo e Copia percorso completo dal menu di scelta rapida.You can right-click the folder node and then use the Refresh, Delete, Upload, Upload Folder, Copy Relative Path, and Copy Full Path commands on the shortcut menu.

    Comandi di menu di scelta rapida per un nodo di cartella in Data Lake Explorer

  • È possibile fare clic con il pulsante destro del mouse sul nodo dei file e quindi usare i comandi Anteprima, Scarica, Elimina, Crea script EXTRACT (disponibile solo per file con estensione csv, tsv e txt), Copia percorso relativo e Copia percorso completo del menu di scelta rapida.You can right-click the file node and then use the Preview, Download, Delete, Create EXTRACT Script (available only for CSV, TSV, and TXT files), Copy Relative Path, and Copy Full Path commands on the shortcut menu.

    Comandi di menu di scelta rapida per un nodo di file in Data Lake Explorer

Integrazione con archiviazione BLOB di Azure da ExplorerIntegrate with Azure Blob storage from the explorer

Andare all'archiviazione BLOB:Browse to Blob storage:

  • È possibile fare doppio clic con il pulsante destro del mouse sul nodo contenitore BLOB e quindi usare i comandi Aggiorna, Elimina contenitore BLOB e Carica BLOB nel menu di scelta rapida.You can right-click the blob container node and then use the Refresh, Delete Blob Container, and Upload Blob commands on the shortcut menu.

    Comandi di menu di scelta rapida per un nodo contenitore BLOB nell'archiviazione BLOB

  • È possibile fare clic con il pulsante destro del mouse sul nodo della cartella e quindi usare i comandi Aggiorna e Carica BLOB nel menu di scelta rapida.You can right-click the folder node and then use the Refresh and Upload Blob commands on the shortcut menu.

    Comandi di menu di scelta rapida per un nodo della cartella nell'archiviazione BLOB

  • È possibile fare clic con il pulsante destro del mouse sul nodo dei file e quindi usare i comandi Preview/Edit (Anteprima/Modifica), Scarica, Elimina, Crea script EXTRACT (disponibile solo per file con estensione csv, tsv e txt), Copia percorso relativo e Copia percorso completo del menu di scelta rapida.You can right-click the file node and then use the Preview/Edit, Download, Delete, Create EXTRACT Script (available only for CSV, TSV, and TXT files), Copy Relative Path, and Copy Full Path commands on the shortcut menu.

    Comandi di menu di scelta rapida per un nodo di file nell'archiviazione BLOB

Aprire Esplora risorse di Data Lake ExplorerOpen the Data Lake explorer in the portal

  1. Premere CTRL+MAIUSC+P per aprire il riquadro comandi.Select Ctrl+Shift+P to open the command palette.
  2. Immettere Open Web Azure Storage Explorer (Apri Web Azure Storage Explorer) o fare clic con il pulsante destro del mouse su un percorso relativo o un percorso completo nell'editor di script e quindi scegliere Open Web Azure Storage Explorer (Apri Web Azure Storage Explorer).Enter Open Web Azure Storage Explorer or right-click a relative path or the full path in the script editor, and then select Open Web Azure Storage Explorer.
  3. Selezionare un account di Data Lake Analytics.Select a Data Lake Analytics account.

Strumenti Data Lake apre il percorso di Archiviazione di Azure nel portale di Azure.Data Lake Tools opens the Azure Storage path in the Azure portal. È possibile trovare il percorso e visualizzare in anteprima il file dal Web.You can find the path and preview the file from the web.

Funzionalità aggiuntiveAdditional features

Strumenti Data Lake per VS Code supporta le funzionalità seguenti:Data Lake Tools for VS Code supports the following features:

  • Completamento automatico IntelliSense: vengono visualizzati suggerimenti in finestre popup intorno agli elementi, ad esempio parole chiave, metodi e variabili.IntelliSense autocomplete: Suggestions appear in pop-up windows around items like keywords, methods, and variables. Icone diverse rappresentano vari tipi di oggetti:Different icons represent different types of objects:

    • Tipo di dati ScalaScala data type
    • Tipo di dati complessoComplex data type
    • UDT integratiBuilt-in UDTs
    • Raccolta e classi .NET.NET collection and classes
    • Espressioni C#C# expressions
    • UDF, UDO e UDAAG di C# integratiBuilt-in C# UDFs, UDOs, and UDAAGs
    • Funzioni di U-SQLU-SQL functions
    • Funzioni di windowing di U-SQLU-SQL windowing functions

    Tipi di oggetti IntelliSense

  • Completamento automatico IntelliSense per i metadati di Data Lake Analytics: Strumenti Data Lake scarica le informazioni di metadati di Data Lake Analytics localmente.IntelliSense autocomplete on Data Lake Analytics metadata: Data Lake Tools downloads the Data Lake Analytics metadata information locally. La funzionalità IntelliSense consente di popolare automaticamente gli oggetti dai metadati di Data Lake Analytics.The IntelliSense feature automatically populates objects from the Data Lake Analytics metadata. Questi oggetti includono il database, lo schema, la tabella, la vista, la funzione con valori di tabella, le procedure e gli assembly C#.These objects include the database, schema, table, view, table-valued function, procedures, and C# assemblies.

    Metadati di IntelliSense

  • Indicatore di errore di IntelliSense: Strumenti Data Lake sottolinea gli errori di modifica per U-SQL e C#.IntelliSense error marker: Data Lake Tools underlines editing errors for U-SQL and C#.

  • Evidenziazione della sintassi: Strumenti Data Lake usa colori diversi per distinguere gli elementi, ad esempio variabili, parole chiave, tipi di dati e funzioni.Syntax highlights: Data Lake Tools uses colors to differentiate items like variables, keywords, data types, and functions.

    Sintassi con diversi colori

Nota

Si consiglia di eseguire l'aggiornamento a Strumenti Azure Data Lake per Visual Studio versione 2.3.3000.4 o successiva.We recommend that you upgrade to Azure Data Lake Tools for Visual Studio version 2.3.3000.4 or later. Le versioni precedenti non sono più disponibili per il download e sono deprecate.The previous versions are no longer available for download and are now deprecated.

Passaggi successiviNext steps