Introduzione ad Azure Data Lake Store con l'interfaccia della riga di comando di Azure 2.0Get started with Azure Data Lake Store using Azure CLI 2.0

Informazioni su come usare l'interfaccia della riga di comando di Azure 2.0 per creare un account di Azure Data Lake Store ed eseguire operazioni di base, ad esempio creare cartelle, caricare e scaricare i file di dati, eliminare l'account e così via. Per altre informazioni su Data Lake Store, vedere Panoramica di Data Lake Store.Learn how to use Azure CLI 2.0 to create an Azure Data Lake Store account and perform basic operations such as create folders, upload and download data files, delete your account, etc. For more information about Data Lake Store, see Overview of Data Lake Store.

L'interfaccia della riga di comando di Azure 2.0 è la nuova esperienza della riga di comando di Azure per gestire le risorse di Azure.The Azure CLI 2.0 is Azure's new command-line experience for managing Azure resources. Può essere usata in macOS, Linux e Windows.It can be used on macOS, Linux, and Windows. Per altre informazioni, vedere Overview of Azure CLI 2.0 (Panoramica dell'interfaccia della riga di comando di Azure 2.0).For more information, see Overview of Azure CLI 2.0. Per un elenco completo di comandi e per la sintassi, è anche possibile vedere le informazioni di riferimento sull'interfaccia della riga di comando di Azure Data Lake Store 2.0.You can also look at the Azure Data Lake Store CLI 2.0 reference for a complete list of commands and syntax.

PrerequisitiPrerequisites

Per eseguire le procedure descritte nell'articolo è necessario:Before you begin this article, you must have the following:

AutenticazioneAuthentication

Questo articolo usa un approccio di autenticazione più semplice con Data Lake Store in cui si accede come utente finale.This article uses a simpler authentication approach with Data Lake Store where you log in as an end-user user. Il livello di accesso al file system e all'account Data Lake Store viene quindi regolato dal livello di accesso dell'utente connesso.The access level to Data Lake Store account and file system is then governed by the access level of the logged in user. Esistono tuttavia altri approcci oltre all'autenticazione con Data Lake Store, ad esempio l'autenticazione dell'utente finale o l'autenticazione da servizio a servizio.However, there are other approaches as well to authenticate with Data Lake Store, which are end-user authentication or service-to-service authentication. Per altre informazioni e istruzioni su come eseguire l'autenticazione, vedere Autenticazione dell'utente finale o Autenticazione da servizio a servizio.For instructions and more information on how to authenticate, see End-user authentication or Service-to-service authentication.

Accedere alla sottoscrizione di AzureLog in to your Azure subscription

  1. Accedere alla propria sottoscrizione di Azure.Log into your Azure subscription.

    az login
    

    Si ottiene un codice da usare nel passaggio successivo.You get a code to use in the next step. Usare un Web browser per aprire la pagina https://aka.ms/devicelogin e immettere il codice per l'autenticazione.Use a web browser to open the page https://aka.ms/devicelogin and enter the code to authenticate. Verrà chiesto di accedere usando le proprie credenziali.You are prompted to log in using your credentials.

  2. Dopo l'accesso, la finestra elenca tutte le sottoscrizioni di Azure associate all'account.Once you log in, the window lists all the Azure subscriptions that are associated with your account. Usare il comando seguente per usare una sottoscrizione specifica.Use the following command to use a specific subscription.

    az account set --subscription <subscription id> 
    

Creare un account di Azure Data Lake StoreCreate an Azure Data Lake Store account

  1. Creare un nuovo gruppo di risorse.Create a new resource group. Nel comando seguente, fornire i valori dei parametri da utilizzare.In the following command, provide the parameter values you want to use. Se il nome del percorso contiene spazi, racchiuderlo tra virgolette doppie,If the location name contains spaces, put it in quotes. Ad esempio "Stati Uniti orientali 2".For example "East US 2".

    az group create --location "East US 2" --name myresourcegroup
    
  2. Creare un account Data Lake Store di Azure.Create the Data Lake Store account.

    az dls account create --account mydatalakestore --resource-group myresourcegroup
    

Creare delle cartelle in un account Archivio Data LakeCreate folders in a Data Lake Store account

È possibile creare delle cartelle con il proprio account di Azure Data Lake Store per gestire e archiviare i dati.You can create folders under your Azure Data Lake Store account to manage and store data. Usare il comando seguente per creare una cartella denominata mynewfolder nella directory radice di Data Lake Store.Use the following command to create a folder called mynewfolder at the root of the Data Lake Store.

az dls fs create --account mydatalakestore --path /mynewfolder --folder

Nota

Il parametro --folder assicura che il comando crei una cartella.The --folder parameter ensures that the command creates a folder. Se questo parametro non è presente, il comando crea un file vuoto denominato mynewfolder nella radice dell'account Data Lake Store.If this parameter is not present, the command creates an empty file called mynewfolder at the root of the Data Lake Store account.

Caricare dati in un account Data Lake StoreUpload data to a Data Lake Store account

È possibile caricare dati in Data Lake Store direttamente a livello di radice o in una cartella creata nell'account.You can upload data to Data Lake Store directly at the root level or to a folder that you created within the account. I frammenti di codice riportati di seguito illustrano come caricare alcuni dati di esempio nella cartella (mynewdirectory) creata nella sezione precedente.The snippets below demonstrate how to upload some sample data to the folder (mynewfolder) you created in the previous section.

Se si stanno cercando dati di esempio da caricare, è possibile ottenere la cartella Ambulance Data dal Repository GitHub per Azure Data Lake.If you are looking for some sample data to upload, you can get the Ambulance Data folder from the Azure Data Lake Git Repository. Scaricare il file e archiviarlo in una directory locale nel computer, ad esempio C:\sampledata.Download the file and store it in a local directory on your computer, such as C:\sampledata.

az dls fs upload --account mydatalakestore --source-path "C:\SampleData\AmbulanceData\vehicle1_09142014.csv" --destination-path "/mynewfolder/vehicle1_09142014.csv"

Nota

Per la destinazione, è necessario specificare il percorso completo, incluso il nome file.For the destination, you must specify the complete path including the file name.

Elencare i file in un account Data Lake StoreList files in a Data Lake Store account

Usare il comando seguente per elencare i file nell'account di Data Lake Store.Use the following command to list the files in a Data Lake Store account.

az dls fs list --account mydatalakestore --path /mynewfolder

L'output di questo comando dovrebbe essere simile al seguente:The output of this should be similar to the following:

[
    {
        "accessTime": 1491323529542,
        "aclBit": false,
        "blockSize": 268435456,
        "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "length": 1589881,
        "modificationTime": 1491323531638,
        "msExpirationTime": 0,
        "name": "mynewfolder/vehicle1_09142014.csv",
        "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "pathSuffix": "vehicle1_09142014.csv",
        "permission": "770",
        "replication": 1,
        "type": "FILE"
    }
]

Rinominare, scaricare ed eliminare i dati da un account Data Lake StoreRename, download, and delete data from a Data Lake Store account

  • Per rinominare un file, usare il comando seguente:To rename a file, use the following command:

    az dls fs move --account mydatalakestore --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csv
    
  • Per scaricare un file, usare il comando seguente.To download a file, use the following command. Assicurarsi che il percorso di destinazione specificato esista già.Make sure the destination path you specify already exists.

    az dls fs download --account mydatalakestore --source-path /mynewfolder/vehicle1_09142014_copy.csv --destination-path "C:\mysampledata\vehicle1_09142014_copy.csv"
    

    Nota

    Il comando crea la cartella di destinazione se non esiste.The command creates the destination folder if it does not exist.

  • Per eliminare un file, usare il comando seguente:To delete a file, use the following command:

    az dls fs delete --account mydatalakestore --path /mynewfolder/vehicle1_09142014_copy.csv
    

    Per eliminare la cartella mynewfolder e il file vehicle1_09142014_copy.csv con un unico comando, usare il parametro --recurse.If you want to delete the folder mynewfolder and the file vehicle1_09142014_copy.csv together in one command, use the --recurse parameter

    az dls fs delete --account mydatalakestore --path /mynewfolder --recurse
    

Utilizzare autorizzazioni ed elenchi di controllo di accesso per un account Data Lake StoreWork with permissions and ACLs for a Data Lake Store account

Questa sezione illustra come gestire elenchi di controllo di accesso e autorizzazioni usando l'interfaccia della riga di comando di Azure 2.0.In this section you learn about how to manage ACLs and permissions using Azure CLI 2.0. Per una spiegazione dettagliata di come vengono implementati gli elenchi di controllo di accesso in Azure Data Lake Store, vedere Controllo di accesso in Azure Data Lake Store.For a detailed discussion on how ACLs are implemented in Azure Data Lake Store, see Access control in Azure Data Lake Store.

  • Per aggiornare il proprietario di un file o di una cartella, usare il comando seguente:To update the owner of a file/folder, use the following command:

    az dls fs access set-owner --account mydatalakestore --path /mynewfolder/vehicle1_09142014.csv --group 80a3ed5f-959e-4696-ba3c-d3c8b2db6766 --owner 6361e05d-c381-4275-a932-5535806bb323
    
  • Per aggiornare le autorizzazioni per un file o per una cartella, usare il comando seguente:To update the permissions for a file/folder, use the following command:

    az dls fs access set-permission --account mydatalakestore --path /mynewfolder/vehicle1_09142014.csv --permission 777
    
  • Per ottenere gli elenchi di controllo di accesso per un determinato percorso, usare il comando seguente:To get the ACLs for a given path, use the following command:

    az dls fs access show --account mydatalakestore --path /mynewfolder/vehicle1_09142014.csv
    

    L'output dovrebbe essere simile al seguente:The output should be similar to the following:

      {
          "entries": [
          "user::rwx",
          "group::rwx",
          "other::---"
        ],
        "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "permission": "770",
        "stickyBit": false
      }
    
  • Per impostare una voce per un elenco di controllo di accesso, usare il comando seguente:To set an entry for an ACL, use the following command:

    az dls fs access set-entry --account mydatalakestore --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323:-w-
    
  • Per rimuovere una voce per un elenco di controllo di accesso, usare il comando seguente:To remove an entry for an ACL, use the following command:

    az dls fs access remove-entry --account mydatalakestore --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323
    
  • Per rimuovere un intero elenco di controllo di accesso predefinito, usare il comando seguente:To remove an entire default ACL, use the following command:

    az dls fs access remove-all --account mydatalakestore --path /mynewfolder --default-acl
    
  • Per rimuovere un intero elenco di controllo di accesso non predefinito, usare il comando seguente:To remove an entire non-default ACL, use the following command:

    az dls fs access remove-all --account mydatalakestore --path /mynewfolder
    

Eliminare un account Archivio Data LakeDelete a Data Lake Store account

Usare il comando seguente per eliminare l'account di Data Lake Store.Use the following command to delete a Data Lake Store account.

az dls account delete --account mydatalakestore

Quando viene richiesto, immettere Y per eliminare l'account.When prompted, enter Y to delete the account.

Passaggi successiviNext steps