Aan de slag met Azure Data Lake Storage Gen1 met behulp van de Azure CLI
Notitie
Azure Data Lake Storage Gen1 is nu buiten gebruik gesteld. Bekijk hier de aankondiging van de buitengebruikstelling. Data Lake Storage Gen1 resources zijn niet meer toegankelijk. Als u speciale hulp nodig hebt, neem dan contact met ons op.
Leer hoe u de Azure CLI gebruikt om een Azure Data Lake Storage Gen1-account te maken en basisbewerkingen uit te voeren, zoals het maken van mappen, het uploaden en downloaden van gegevensbestanden, het verwijderen van uw account, enzovoort. Zie Overzicht van Data Lake Storage Gen1 voor meer informatie over Data Lake Storage Gen1.
Azure CLI is de nieuwe opdrachtregel van Azure voor het beheren van Azure-resources. Deze kan worden gebruikt in Mac OS, Linux en Windows. Zie Overzicht van Azure CLI voor meer informatie. U kunt ook de cli-verwijzing Azure Data Lake Storage Gen1 bekijken voor een volledige lijst met opdrachten en syntaxis.
Vereisten
Voordat u dit artikel gaat lezen, moet u beschikken over het volgende:
Een Azure-abonnement. Zie Gratis proefversie van Azure ophalen.
Azure CLI : zie Azure CLI installeren voor instructies.
Verificatie
In dit artikel wordt gebruikgemaakt van een eenvoudigere verificatiemethode met Data Lake Storage Gen1 waarbij u zich aanmeldt als eindgebruiker. Het toegangsniveau voor het Data Lake Storage Gen1-account en bestandssysteem wordt vervolgens beheerd door het toegangsniveau van de aangemelde gebruiker. Er zijn echter ook andere methoden om te verifiëren met Data Lake Storage Gen1, zoals verificatie van eindgebruikers of service-naar-service-verificatie. Zie Verificatie door eindgebruikers of Service-to-serviceverificatie voor instructies en meer informatie over verificatie.
Aanmelden bij uw Azure-abonnement
Meld u aan bij uw Azure-abonnement.
az loginU ontvangt een code die u in de volgende stap nodig hebt. Open de pagina https://aka.ms/devicelogin met een webbrowser en voer de code in om te verifiëren. U wordt gevraagd om u aan te melden met uw referenties.
Wanneer u bent aangemeld, wordt er een venster weergegeven met alle Azure-abonnementen die aan uw account zijn gekoppeld. Gebruik de volgende opdracht als u een specifiek abonnement wilt gebruiken.
az account set --subscription <subscription id>
Een Azure Data Lake Storage Gen1-account maken
Een nieuwe resourcegroep maken. Geef in de volgende opdracht de parameterwaarden op die u wilt gebruiken. Als de locatienaam spaties bevat, moet deze tussen dubbele aanhalingstekens worden geplaatst. Bijvoorbeeld 'US - oost 2'.
az group create --location "East US 2" --name myresourcegroupMaak het Data Lake Storage Gen1-account.
az dls account create --account mydatalakestoragegen1 --resource-group myresourcegroup
Mappen maken in een Data Lake Storage Gen1-account
U kunt mappen maken onder uw Azure Data Lake Storage Gen1-account om gegevens te beheren en op te slaan. Gebruik de volgende opdracht om een map met de naam mynewfolder te maken in de hoofdmap van het Data Lake Storage Gen1-account.
az dls fs create --account mydatalakestoragegen1 --path /mynewfolder --folder
Notitie
Met de parameter --folder geeft u aan dat u een map wilt maken. Als deze parameter niet aanwezig is, maakt de opdracht een leeg bestand met de naam mynewfolder in de hoofdmap van het Data Lake Storage Gen1-account.
Gegevens uploaden naar een Data Lake Storage Gen1-account
U kunt gegevens rechtstreeks uploaden naar Data Lake Storage Gen1 op hoofdniveau of naar een map die u in het account hebt gemaakt. De codefragmenten hieronder laten zien hoe u voorbeeldgegevens uploadt naar de map (mynewfolder) die u in de voorgaande sectie hebt gemaakt.
Als u nog geen voorbeeldgegevens hebt om te uploaden, kunt u de map Ambulance Data uit de Azure Data Lake Git-opslagplaats gebruiken. Download het bestand en sla het op in een lokale map op uw computer, zoals C:\sampledata.
az dls fs upload --account mydatalakestoragegen1 --source-path "C:\SampleData\AmbulanceData\vehicle1_09142014.csv" --destination-path "/mynewfolder/vehicle1_09142014.csv"
Notitie
Als bestemming moet u het volledige pad inclusief de bestandsnaam opgeven.
Bestanden in een Data Lake Storage Gen1-account weergeven
Gebruik de volgende opdracht om de bestanden in een Data Lake Storage Gen1-account weer te geven.
az dls fs list --account mydatalakestoragegen1 --path /mynewfolder
De uitvoer ziet er ongeveer als volgt uit:
[
{
"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"
}
]
De naam van een Data Lake Storage Gen1-account wijzigen, gegevens downloaden en verwijderen
Als u de naam van een bestand wilt wijzigen, gebruikt u de volgende opdracht:
az dls fs move --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csvGebruik de volgende opdracht om een bestand te downloaden. Zorg ervoor dat het doelpad dat u opgeeft al bestaat.
az dls fs download --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014_copy.csv --destination-path "C:\mysampledata\vehicle1_09142014_copy.csv"Notitie
Met de opdracht wordt de doelmap gemaakt als deze niet bestaat.
Als u een bestand wilt verwijderen, gebruikt u de volgende opdracht:
az dls fs delete --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014_copy.csvAls u de map mynewfolder en het bestand vehicle1_09142014_copy.csv met één opdracht wilt verwijderen, gebruikt u de parameter --recurse
az dls fs delete --account mydatalakestoragegen1 --path /mynewfolder --recurse
Werken met machtigingen en ACL's voor een Data Lake Storage Gen1-account
In deze sectie leert u hoe u ACL's en machtigingen beheert met behulp van de Azure CLI. Zie Toegangsbeheer in Azure Data Lake Storage Gen1 voor een gedetailleerde discussie over hoe ACL's worden geïmplementeerd in Azure Data Lake Storage Gen1.
Gebruik de volgende opdracht als u de eigenaar van een bestand/map wilt bijwerken:
az dls fs access set-owner --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --group 80a3ed5f-959e-4696-ba3c-d3c8b2db6766 --owner 6361e05d-c381-4275-a932-5535806bb323Gebruik de volgende opdracht als u de machtigingen voor een bestand/map wilt bijwerken:
az dls fs access set-permission --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --permission 777Gebruik de volgende opdracht als u de ACL's voor een gegeven pad wilt ophalen:
az dls fs access show --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csvDe uitvoer moet er ongeveer als volgt uitzien:
{ "entries": [ "user::rwx", "group::rwx", "other::---" ], "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20", "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20", "permission": "770", "stickyBit": false }Gebruik de volgende opdracht als u een item voor een ACL wilt instellen:
az dls fs access set-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323:-w-Gebruik de volgende opdracht als u een item voor een ACL wilt verwijderen:
az dls fs access remove-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323Gebruik de volgende opdracht als u een complete standaard-ACL wilt verwijderen:
az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder --default-aclGebruik de volgende opdracht als u een complete niet-standaard-ACL wilt verwijderen:
az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder
Een Data Lake Storage Gen1-account verwijderen
Gebruik de volgende opdracht om een Data Lake Storage Gen1-account te verwijderen.
az dls account delete --account mydatalakestoragegen1
Wanneer dit wordt gevraagd, typt u Y om het account te verwijderen.