Introduzione a Azure Data Lake Storage Gen1 con l'interfaccia della riga di comando di Azure

  • Articolo

Nota

Azure Data Lake Storage Gen1 è stato ritirato. Vedere l'annuncio di ritiro qui. Data Lake Storage Gen1 risorse non sono più accessibili. Se hai bisogno di assistenza speciale, contattaci.

Informazioni su come usare l'interfaccia della riga di comando di Azure per creare un account Azure Data Lake Storage Gen1 ed eseguire operazioni di base, ad esempio creare cartelle, caricare e scaricare file di dati, eliminare l'account e così via. Per altre informazioni sulle Data Lake Storage Gen1, vedere Panoramica di Data Lake Storage Gen1.

L'interfaccia della riga di comando di Azure è l'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 Panoramica dell'interfaccia della riga di comando di Azure. 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 Storage Gen1.

Prerequisiti

Per eseguire le procedure descritte nell'articolo è necessario:

Authentication

Questo articolo usa un approccio di autenticazione più semplice con Data Lake Storage Gen1 in cui si accede come utente finale. Il livello di accesso all'account Data Lake Storage Gen1 e al file system viene quindi controllato dal livello di accesso dell'utente connesso. Ci sono tuttavia altri approcci oltre all'autenticazione con Data Lake Storage Gen1, 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 Azure Data Lake Storage Gen1

  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 l'account Data Lake Storage Gen1.

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

Creare cartelle in un account Data Lake Storage Gen1

È possibile creare cartelle nell'account Azure Data Lake Storage Gen1 per gestire e archiviare i dati. Usare il comando seguente per creare una cartella denominata mynewfolder nella radice dell'account Data Lake Storage Gen1.

az dls fs create --account mydatalakestoragegen1 --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 Storage Gen1.

Caricare i dati in un account Data Lake Storage Gen1

È possibile caricare i dati in Data Lake Storage Gen1 direttamente al livello 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 mydatalakestoragegen1 --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 Storage Gen1

Usare il comando seguente per elencare i file in un account Data Lake Storage Gen1.

az dls fs list --account mydatalakestoragegen1 --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 Storage Gen1

  • Per rinominare un file, usare il comando seguente:

    az dls fs move --account mydatalakestoragegen1 --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 mydatalakestoragegen1 --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 mydatalakestoragegen1 --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 mydatalakestoragegen1 --path /mynewfolder --recurse

Usare le autorizzazioni e gli elenchi di controllo di accesso per un account Data Lake Storage Gen1

Questa sezione illustra come gestire elenchi di controllo di accesso e autorizzazioni usando l'interfaccia della riga di comando di Azure. Per una spiegazione dettagliata di come vengono implementati gli elenchi di controllo di accesso in Azure Data Lake Storage Gen1, vedere Controllo di accesso in Azure Data Lake Storage Gen1.

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

    az dls fs access set-owner --account mydatalakestoragegen1 --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 mydatalakestoragegen1 --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 mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv

    L'output avrà un aspetto analogo 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 mydatalakestoragegen1 --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 mydatalakestoragegen1 --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 mydatalakestoragegen1 --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 mydatalakestoragegen1 --path /mynewfolder

Eliminare un account Data Lake Storage Gen1

Usare il comando seguente per eliminare un account Data Lake Storage Gen1.

az dls account delete --account mydatalakestoragegen1

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

Passaggi successivi