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

Anmärkning

Azure Data Lake Storage Gen1 har nu dragits tillbaka. Se pensionsmeddelandet här. Data Lake Storage Gen1-resurser är inte längre tillgängliga.

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å Cli-referensen för Azure Data Lake Storage Gen1 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-kontot och filsystemet 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, placera det inom citattecken. Till exempel "Östra USA 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

Kommentar

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 skapade 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 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

  • Byt namn på en fil med hjälp av följande kommando:

    az dls fs move --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csv
    
  • Hämta en fil med hjälp av 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"
    

    Kommentar

    Kommandot skapar målmappen om den inte finns.

  • Ta bort en fil med hjälp av 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 diskussion om 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 ACL 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-
    
  • För att ta bort en post i en ACL 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