Erste Schritte mit Azure Data Lake Storage Gen1 mithilfe der Azure CLI

  • Artikel

Hinweis

Azure Data Lake Storage Gen1 wurde eingestellt. Sehen Sie sich die Ankündigung zur Einstellung hier an. Data Lake Storage Gen1 Ressourcen sind nicht mehr zugänglich. Wenn Sie besondere Unterstützung benötigen, kontaktieren Sie uns bitte.

Erfahren Sie, wie Sie mit der Azure CLI ein Azure Data Lake Storage Gen1-Konto erstellen und grundlegende Vorgänge ausführen, z. B. Ordner erstellen, Datendateien hoch- und herunterladen, Ihr Konto löschen usw. Weitere Informationen zu Data Lake Storage Gen1 finden Sie unter Übersicht über Data Lake Storage Gen1.

Die Azure CLI ist die Befehlszeilenumgebung von Azure und dient zum Verwalten von Azure-Ressourcen. Sie kann unter macOS, Linux und Windows verwendet werden. Weitere Informationen finden Sie in der Übersicht über Azure CLI. In der Referenz für Azure Data Lake Storage Gen1 CLI finden Sie außerdem eine vollständige Liste mit Befehlen und Syntax.

Voraussetzungen

Bevor Sie mit diesem Artikel beginnen können, benötigen Sie Folgendes:

Authentifizierung

In diesem Artikel wird ein einfacheres Authentifizierungskonzept mit Data Lake Storage Gen1 verwendet, bei dem Sie sich als Endbenutzer anmelden. Die Zugriffsebene für das Data Lake Storage Gen1-Konto und das Dateisystem hängt dann von der Zugriffsebene des angemeldeten Benutzers ab. Für die Authentifizierung mit Data Lake Storage Gen1 stehen mit Endbenutzerauthentifizierung und Dienst-zu-Dienst-Authentifizierung aber auch noch andere Konzepte zur Verfügung. Anweisungen und weitere Informationen zur Authentifizierung finden Sie unter Endbenutzerauthentifizierung oder Dienst-zu-Dienst-Authentifizierung.

Melden Sie sich bei Ihrem Azure-Abonnement an.

  1. Melden Sie sich bei Ihrem Azure-Abonnement an.

    az login

    Sie erhalten einen Code, den Sie im nächsten Schritt benötigen. Verwenden Sie zum Öffnen der Seite https://aka.ms/devicelogin einen Webbrowser, und geben Sie dann zur Authentifizierung den Code ein. Sie werden aufgefordert, sich mit Ihren Anmeldeinformationen anzumelden.

  2. Nach der Anmeldung werden in dem Fenster alle mit Ihrem Konto verknüpften Azure-Abonnements aufgelistet. Verwenden Sie den folgenden Befehl, um ein bestimmtes Abonnement zu verwenden:

    az account set --subscription <subscription id>

Erstellen eines Azure Data Lake Storage Gen1-Kontos

  1. Erstellen Sie eine neue Ressourcengruppe. Geben Sie für den folgenden Befehl die Parameterwerte ein, die Sie verwenden möchten. Wenn der Name des Standorts Leerzeichen enthält, setzen Sie ihn in doppelte Anführungszeichen. Beispiel: „USA, Osten 2“.

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

  2. Erstellen Sie das Data Lake Storage Gen1-Konto.

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

Erstellen von Ordnern in einem Data Lake Storage Gen1-Konto

Sie können in Ihrem Azure Data Lake Storage Gen1-Konto Ordner zum Verwalten und Speichern von Daten erstellen. Verwenden Sie den folgenden Befehl, um im Stammverzeichnis des Data Lake Storage Gen1-Kontos einen Ordner mit dem Namen mynewfolder zu erstellen.

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

Hinweis

Der Parameter --folder stellt sicher, dass der Befehl einen Ordner erstellt. Ohne diesen Parameter erstellt der Befehl eine leere Datei namens „mynewfolder“ im Stammverzeichnis des Data Lake Storage Gen1-Kontos.

Hochladen von Daten in ein Data Lake Storage Gen1-Konto

Sie können Daten direkt auf die Stammebene von Data Lake Storage Gen1 oder in einen im Konto erstellten Ordner hochladen. Die folgenden Codeausschnitte veranschaulichen das Hochladen von Beispieldaten in den im vorigen Abschnitt erstellten Ordner (mynewfolder).

Wenn Sie Beispieldaten zum Hochladen verwenden möchten, können Sie den Ordner Ambulance Data aus dem Azure Data Lake-Git-Repositoryherunterladen. Laden Sie die Datei herunter, und speichern Sie sie auf dem Computer in einem lokalen Verzeichnis (beispielsweise „C:\sampledata“).

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

Hinweis

Als Ziel müssen Sie den vollständigen Pfad einschließlich des Dateinamens angeben.

Auflisten von Dateien in einem Data Lake Storage Gen1-Konto

Verwenden Sie den folgenden Befehl, um die Dateien in einem Data Lake Storage Gen1-Konto aufzulisten.

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

Die Ausgabe sollte in etwa wie folgt aussehen:

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

Umbenennen, Herunterladen und Löschen von Daten in einem Data Lake Storage Gen1-Konto

  • Verwenden Sie zum Umbenennen einer Datei den folgenden Befehl:

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

  • Verwenden Sie zum Herunterladen einer Datei den folgenden Befehl: Stellen Sie sicher, dass der angegebene Zielpfad bereits vorhanden ist.

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

    Hinweis

    Falls der Zielordner nicht vorhanden ist, wird er erstellt.

  • Verwenden Sie zum Löschen einer Datei den folgenden Befehl:

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

    Wenn Sie den Ordner mynewfolder und die Datei vehicle1_09142014_copy.csv mit einem einzelnen Befehl löschen möchten, verwenden Sie den Parameter „--recurse“.

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

Arbeiten mit Berechtigungen und ACLs für ein Data Lake Storage Gen1-Konto

In diesem Abschnitt erfahren Sie, wie Sie ACLs und Berechtigungen mithilfe der Azure CLI verwalten. Ausführliche Informationen zur Implementierung von ACLs in Azure Data Lake Storage Gen1 finden Sie unter Zugriffssteuerung in Azure Data Lake Storage Gen1.

  • Befehl zum Aktualisieren des Besitzers einer Datei bzw. eines Ordners:

    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

  • Befehl zum Aktualisieren der Berechtigungen für eine Datei bzw. einen Ordner:

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

  • Befehl zum Abrufen der ACLs für einen bestimmten Pfad:

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

    Die Ausgabe sollte ähnlich der Folgenden aussehen:

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

  • Befehl zum Festlegen eines Eintrags für eine ACL:

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

  • Befehl zum Entfernen eines Eintrags für eine ACL:

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

  • Befehl zum Entfernen einer vollständigen Standard-ACL:

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

  • Befehl zum Entfernen einer vollständigen nicht standardmäßigen ACL:

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

Löschen eines Data Lake Storage Gen1-Kontos

Verwenden Sie den folgenden Befehl zum Löschen eines Data Lake Storage Gen1-Kontos.

az dls account delete --account mydatalakestoragegen1

Geben Sie nach entsprechender Aufforderung Y ein, um das Konto zu löschen.

Nächste Schritte