Introduzione ad Azure Data Lake Store con l'interfaccia della riga di comando di Azure 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.

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. Può essere usata in macOS, Linux e Windows. Per altre informazioni, vedere Overview of Azure CLI 2.0 (Panoramica dell'interfaccia della riga di comando di Azure 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.

Prerequisiti

Per eseguire le procedure descritte nell'articolo è necessario:

Autenticazione

Questo articolo usa un approccio di autenticazione più semplice con Data Lake Store in cui si accede come utente finale. Il livello di accesso al file system e all'account Data Lake Store viene quindi regolato dal livello di accesso dell'utente connesso. 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. Per altre informazioni e istruzioni su come eseguire l'autenticazione, vedere Autenticazione dell'utente finale o Autenticazione da servizio a servizio.

Accedere alla sottoscrizione di Azure

  1. Accedere alla propria sottoscrizione di Azure.

    az login
    

    Si ottiene un codice da usare nel passaggio successivo. Usare un Web browser per aprire la pagina https://aka.ms/devicelogin e immettere il codice per l'autenticazione. Verrà chiesto di accedere usando le proprie credenziali.

  2. Dopo l'accesso, la finestra elenca tutte le sottoscrizioni di Azure associate all'account. Usare il comando seguente per usare una sottoscrizione specifica.

    az account set --subscription <subscription id> 
    

Creare un account di Azure Data Lake Store

  1. Creare un nuovo gruppo di risorse. Nel comando seguente, fornire i valori dei parametri da utilizzare. Se il nome del percorso contiene spazi, racchiuderlo tra virgolette doppie, Ad esempio "Stati Uniti orientali 2".

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

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

Creare delle cartelle in un account Archivio Data Lake

È possibile creare delle cartelle con il proprio account di Azure Data Lake Store per gestire e archiviare i dati. Usare il comando seguente per creare una cartella denominata mynewfolder nella directory radice di Data Lake Store.

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

Il parametro --folder assicura che il comando crei una cartella. Se questo parametro non è presente, il comando crea un file vuoto denominato mynewfolder nella radice dell'account Data Lake Store.

Caricare dati in un account Data Lake Store

È possibile caricare dati in Data Lake Store direttamente a livello di radice o in una cartella creata nell'account. I frammenti di codice riportati di seguito illustrano come caricare alcuni dati di esempio nella cartella (mynewdirectory) creata nella sezione precedente.

Se si stanno cercando dati di esempio da caricare, è possibile ottenere la cartella Ambulance Data dal Repository GitHub per Azure Data Lake. Scaricare il file e archiviarlo in una directory locale nel computer, ad esempio 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.

Elencare i file in un account Data Lake Store

Usare il comando seguente per elencare i file nell'account di Data Lake Store.

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

L'output di questo comando dovrebbe essere simile al seguente:

[
    {
        "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 Store

  • Per rinominare un file, usare il comando seguente:

    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. Assicurarsi che il percorso di destinazione specificato esista già.

    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.

  • Per eliminare un file, usare il comando seguente:

    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.

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

Utilizzare autorizzazioni ed elenchi di controllo di accesso per un account Data Lake Store

Questa sezione illustra come gestire elenchi di controllo di accesso e autorizzazioni usando l'interfaccia della riga di comando di Azure 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.

  • Per aggiornare il proprietario di un file o di una cartella, usare il comando seguente:

    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:

    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:

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

    L'output dovrebbe essere simile al seguente:

      {
          "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:

    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:

    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:

    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:

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

Eliminare un account Archivio Data Lake

Usare il comando seguente per eliminare l'account di Data Lake Store.

az dls account delete --account mydatalakestore

Quando viene richiesto, immettere Y per eliminare l'account.

Passaggi successivi