Freigeben über

Erste Schritte mit Azure Data Lake Storage Gen1 mithilfe von Azure PowerShell

  • Artikel

Hinweis

Azure Data Lake Storage Gen1 wurde außer Betrieb genommen. Sehen Sie sich hier die Ankündigung zur Einstellung an. Auf Data Lake Storage Gen1-Ressourcen kann nicht mehr zugegriffen werden.

Erfahren Sie, wie Sie Azure PowerShell verwenden, um ein Azure Data Lake Storage Gen1-Konto zu erstellen und grundlegende Vorgänge auszuführen, z. B. Ordner erstellen, Datendateien hochladen und herunterladen, Ihr Konto löschen usw. Weitere Informationen zu Data Lake Storage Gen1 finden Sie in der Übersicht über Data Lake Storage Gen1.

Voraussetzungen

Hinweis

Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Informationen zu den ersten Schritten finden Sie unter Installieren des Azure Az PowerShell-Moduls. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.

Authentifizierung

In diesem Artikel wird ein einfacheres Authentifizierungskonzept mit Data Lake Storage Gen1 verwendet, bei dem Sie zur Eingabe der Anmeldeinformationen für Ihr Azure-Konto aufgefordert werden. 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 der Endbenutzerauthentifizierung oder der 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.

Erstellen eines Data Lake Storage Gen1-Kontos

  1. Öffnen Sie auf Ihrem Desktop ein neues Windows PowerShell-Fenster. Geben Sie den folgenden Codeausschnitt ein, um sich bei Ihrem Azure-Konto anzumelden, das Abonnement festzulegen und den Data Lake Storage Gen1-Anbieter zu registrieren. Stellen Sie bei der Aufforderung zum Anmelden sicher, dass Sie sich als einer der Administratoren/Besitzer des Abonnements anmelden:

    # Log in to your Azure account
Connect-AzAccount

# List all the subscriptions associated to your account
Get-AzSubscription

# Select a subscription
Set-AzContext -SubscriptionId <subscription ID>

# Register for Azure Data Lake Storage Gen1
Register-AzResourceProvider -ProviderNamespace "Microsoft.DataLakeStore"

  2. Ein Data Lake Storage Gen1-Konto wird einer Azure-Ressourcengruppe zugeordnet. Beginnen Sie, indem Sie eine Ressourcengruppe erstellen.

    $resourceGroupName = "<your new resource group name>"
New-AzResourceGroup -Name $resourceGroupName -Location "East US 2"

    Erstellen einer Azure-Ressourcengruppe

  3. Erstellen Sie ein Data Lake Storage Gen1-Konto. Der angegebene Name darf nur Kleinbuchstaben und Zahlen enthalten.

    $dataLakeStorageGen1Name = "<your new Data Lake Storage Gen1 account name>"
New-AzDataLakeStoreAccount -ResourceGroupName $resourceGroupName -Name $dataLakeStorageGen1Name -Location "East US 2"

    Erstellen eines Data Lake Storage Gen1-Kontos

  4. Stellen Sie sicher, dass das Konto erfolgreich erstellt wurde.

    Test-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name

    Die Ausgabe für das Cmdlet sollte True lauten.

Erstellen von Verzeichnisstrukturen

Sie können in Ihrem Data Lake Storage Gen1-Konto Verzeichnisse zum Verwalten und Speichern von Daten erstellen.

  1. Legen Sie ein Stammverzeichnis fest.

    $myrootdir = "/"

  2. Erstellen Sie ein neues Verzeichnis namens mynewdirectory unter dem festgelegten Stammverzeichnis.

    New-AzDataLakeStoreItem -Folder -AccountName $dataLakeStorageGen1Name -Path $myrootdir/mynewdirectory

  3. Stellen Sie sicher, dass das neue Verzeichnis erfolgreich erstellt wurde.

    Get-AzDataLakeStoreChildItem -AccountName $dataLakeStorageGen1Name -Path $myrootdir

    Es sollte eine Ausgabe wie im folgenden Screenshot angezeigt werden:

    Überprüfen des Verzeichnisses

Hochladen von Daten

Sie können Ihre Daten direkt auf die Data Lake Storage Gen1-Stammebene oder in ein im Konto erstelltes Verzeichnis hochladen. Die Codeausschnitte in diesem Abschnitt veranschaulichen das Hochladen von Beispieldaten in das im vorigen Abschnitt erstellte Verzeichnis (mynewdirectory).

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“).

Import-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
   -Path "C:\sampledata\vehicle1_09142014.csv" `
   -Destination $myrootdir\mynewdirectory\vehicle1_09142014.csv

Umbenennen, Herunterladen und Löschen von Daten

Verwenden Sie zum Umbenennen einer Datei den folgenden Befehl:

Move-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Path $myrootdir\mynewdirectory\vehicle1_09142014.csv `
    -Destination $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv

Verwenden Sie zum Downloaden einer Datei den folgenden Befehl:

Export-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Path $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv `
    -Destination "C:\sampledata\vehicle1_09142014_Copy.csv"

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

Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Paths $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv

Geben Sie nach entsprechender Aufforderung Y ein, um das Element zu löschen. Wenn mehrere Dateien gelöscht werden sollen, können Sie die betreffenden Pfade durch Kommas getrennt bereitstellen.

Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Paths $myrootdir\mynewdirectory\vehicle1_09142014.csv, $myrootdir\mynewdirectoryvehicle1_09142014_Copy.csv

Löschen Ihres Kontos

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

Remove-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name

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

Nächste Schritte