Kom igång med Azure Data Lake Storage Gen1 med hjälp av Azure CLI

  • Artikel

Anteckning

Azure Data Lake Storage Gen1 är nu tillbakadragen. Se pensionsmeddelandet här. Data Lake Storage Gen1 resurser är inte längre tillgängliga. Kontakta oss om du behöver särskild hjälp.

Lär dig hur du använder Azure CLI för att skapa ett Azure Data Lake Storage Gen1-konto och utföra grundläggande åtgärder som att skapa mappar, ladda upp och ladda ned datafiler, ta bort ditt konto osv. Mer information om Data Lake Storage Gen1 finns i Översikt över Data Lake Storage Gen1.

Azure CLI är Azures kommandoradsmiljö för att hantera Azure-resurser. Den kan användas i Mac OS, Linux och Windows. Mer information finns i Översikt över Azure CLI. Du kan också titta på Azure Data Lake Storage Gen1 CLI-referensen för en fullständig lista över kommandon och syntax.

Förutsättningar

Innan du påbörjar den här artikeln måste du ha:

Autentisering

Den här artikeln använder en enklare autentiseringsmetod med Data Lake Storage Gen1 där du loggar in som slutanvändare. Åtkomstnivån till Data Lake Storage Gen1 konto och filsystem styrs sedan av åtkomstnivån för den inloggade användaren. Det finns dock även andra metoder för att autentisera med Data Lake Storage Gen1, som är slutanvändarautentisering eller tjänst-till-tjänst-autentisering. Instruktioner och mer information om hur du autentiserar finns i Slutanvändarautentisering eller Tjänst-till-tjänst-autentisering.

Logga in till din Azure-prenumeration

  1. Logga in till din Azure-prenumeration.

    az login

    Du får en kod som du ska använda i nästa steg. Använd en webbläsare för att öppna sidan https://aka.ms/devicelogin och ange koden för att autentisera dig. Du uppmanas att logga in med dina autentiseringsuppgifter.

  2. När du loggar in visar fönstret alla Azure-prenumerationer som är kopplade till ditt konto. Välj en specifik prenumeration med hjälp av följande kommando.

    az account set --subscription <subscription id>

Skapa ett Azure Data Lake Storage Gen1-konto

  1. Skapa en ny resursgrupp. I följande kommando, anger du de parametervärden som du vill använda. Om platsnamnet innehåller blanksteg måste du placera det inom citattecken. Till exempel "USA, östra 2".

    az group create --location "East US 2" --name myresourcegroup

  2. Skapa Data Lake Storage Gen1-kontot.

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

Skapa mappar i ett Data Lake Storage Gen1 konto

Du kan skapa mappar under ditt Azure Data Lake Storage Gen1-konto för att hantera och lagra data. Använd följande kommando för att skapa en mapp med namnet mynewfolder i roten för Data Lake Storage Gen1-kontot.

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

Anteckning

Parametern --folder gör att kommandot skapar en mapp. Om den här parametern inte finns skapar kommandot en tom fil med namnet mynewfolder i roten för Data Lake Storage Gen1-kontot.

Ladda upp data till ett Data Lake Storage Gen1 konto

Du kan ladda upp data till Data Lake Storage Gen1 direkt på rotnivå eller till en mapp som du har skapat i kontot. Fragmenten nedan visar hur du laddar upp exempeldata till mappen (mynewfolder) som du skapade i föregående avsnitt.

Om du behöver exempeldata att ladda upp, kan du hämta mappen Ambulansdata från Azure Data Lake Git-lagringsplatsen. Ladda ned filen och lagra den i en lokal katalog på datorn, till exempel C:\sampledata.

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

Anteckning

För målet måste du ange den fullständiga sökvägen, inklusive filnamnet.

Visa en lista över filer i ett Data Lake Storage Gen1-konto

Använd följande kommando för att visa en lista över filerna i ett Data Lake Storage Gen1-konto.

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

Resultatet av detta ska se ut ungefär så här:

[
    {
        "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"
    }
]

Byta namn på, ladda ned och ta bort data från ett Data Lake Storage Gen1 konto

  • Om du vill byta namn på en fil använder du följande kommando:

    az dls fs move --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csv

  • Om du vill ladda ned en fil använder du följande kommando. Kontrollera att den målsökväg som du anger redan finns.

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

    Anteckning

    Kommandot skapar målmappen om den inte finns.

  • Om du vill ta bort en fil använder du följande kommando:

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

    Om du vill ta bort mappen mynewfolder och filen vehicle1_09142014_copy.csv i samma kommando använder du parametern --recurse

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

Arbeta med behörigheter och ACL:er för ett Data Lake Storage Gen1-konto

I det här avsnittet får du lära dig hur du hanterar ACL:er och behörigheter med hjälp av Azure CLI. En detaljerad beskrivning av hur ACL:er implementeras i Azure Data Lake Storage Gen1 finns i Åtkomstkontroll i Azure Data Lake Storage Gen1.

  • Om du vill uppdatera ägaren till en fil/mapp använder du följande kommando:

    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

  • Om du vill uppdatera behörigheterna för en fil/mapp använder du följande kommando:

    az dls fs access set-permission --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --permission 777

  • Om du vill hämta åtkomstkontrollistorna för en viss sökväg använder du följande kommando:

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

    Resultatet bör likna följande:

    {
    "entries": [
    "user::rwx",
    "group::rwx",
    "other::---"
    ],
    "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
    "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
    "permission": "770",
    "stickyBit": false
}

  • Om du vill ange en post för en åtkomstkontrollista använder du följande kommando:

    az dls fs access set-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323:-w-

  • Om du vill ta bort en post för en åtkomstkontrollista använder du följande kommando:

    az dls fs access remove-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323

  • Om du vill ta bort en hel standardåtkomstkontrollista använder du följande kommando:

    az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder --default-acl

  • Om du vill ta bort en hel åtkomstkontrollista som inte är en standardåtkomstkontrollista använder du följande kommando:

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

Ta bort ett Data Lake Storage Gen1 konto

Använd följande kommando för att ta bort ett Data Lake Storage Gen1 konto.

az dls account delete --account mydatalakestoragegen1

När du uppmanas, anger du Y för att ta bort kontot.

Nästa steg