Kontoverwaltungsvorgänge für Azure Data Lake Storage Gen1 mithilfe des .NET SDK

  • Artikel

In diesem Artikel erfahren Sie, wie Sie mithilfe des .NET SDK Kontoverwaltungsvorgänge in Azure Data Lake Storage Gen1 ausführen. Zu den Kontoverwaltungsvorgängen zählen unter anderem das Erstellen eines Data Lake Storage Gen1-Kontos, das Auflisten der Konten in einem Azure-Abonnement und das Löschen der Konten.

Eine Anleitung zum Durchführen von Datenverwaltungsvorgängen in Data Lake Storage Gen1 per .NET SDK finden Sie unter Dateisystemvorgänge in Azure Data Lake Storage Gen1 mit dem .NET SDK.

Voraussetzungen

  • Visual Studio 2013 und höher. In der Anleitung unten wird Visual Studio 2019 verwendet.

  • Ein Azure-Abonnement. Siehe Kostenlose Azure-Testversion.

Erstellen einer .NET-Anwendung

  1. Wählen Sie in Visual Studio das Menü Datei, dann die Option Neu und anschließend Projekt aus.

  2. Wählen Sie Konsolen-App (.NET Framework) und dann Weiter aus.

  3. Geben Sie unter ProjektnameCreateADLApplication ein, und wählen Sie dann Erstellen aus.

  4. Fügen Sie Ihrem Projekt die NuGet-Pakete hinzu.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen und dann auf NuGet-Pakete verwalten.

    2. Stellen Sie auf der Registerkarte NuGet-Paket-Manager sicher, dass Paketquelle auf nuget.org festgelegt und das Kontrollkästchen Vorabversion einbeziehen aktiviert ist.

    3. Suchen und installieren Sie die folgenden NuGet-Pakete:

      • Microsoft.Azure.Management.DataLake.Store: In diesem Tutorial wird „v2.1.3-preview“ verwendet.

      • Microsoft.Rest.ClientRuntime.Azure.Authentication: In diesem Tutorial wird „v2.2.12“ verwendet.

        Hinzufügen einer NuGet-Quelle

    4. Schließen Sie den NuGet-Paket-Manager.

  5. Öffnen Sie Program.cs, löschen Sie den vorhandenen Code, und fügen Sie dann die folgenden Anweisungen ein, um Verweise auf Namespaces hinzuzufügen.

    using System;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading;
using System.Collections.Generic;
using System.Security.Cryptography.X509Certificates; // Required only if you are using an Azure AD application created with certificates

using Microsoft.Rest;
using Microsoft.Rest.Azure.Authentication;
using Microsoft.Azure.Management.DataLake.Store;
using Microsoft.Azure.Management.DataLake.Store.Models;
using Microsoft.IdentityModel.Clients.ActiveDirectory;

  6. Deklarieren Sie die Variablen, und geben Sie die Werte für Platzhalter an. Stellen Sie außerdem sicher, dass der angegebene lokale Pfad und der Dateiname auf dem Computer vorhanden sind.

    namespace SdkSample
{
    class Program
    {
        private static DataLakeStoreAccountManagementClient _adlsClient;

        private static string _adlsAccountName;
        private static string _resourceGroupName;
        private static string _location;
        private static string _subId;

        private static void Main(string[] args)
        {
            _adlsAccountName = "<DATA-LAKE-STORAGE-GEN1-NAME>.azuredatalakestore.net"; 
            _resourceGroupName = "<RESOURCE-GROUP-NAME>"; 
            _location = "East US 2";
            _subId = "<SUBSCRIPTION-ID>";                    
        }
    }
}

In den restlichen Abschnitten dieses Artikels erfahren Sie, wie Sie die verfügbaren .NET-Methoden verwenden, um Vorgänge wie Authentifizierung, Dateiupload usw. durchzuführen.

Authentifizierung

Erstellen des Clientobjekts

Im folgenden Codeausschnitt wird das Data Lake Storage Gen1-Kontoclientobjekt erstellt, das verwendet wird, um Kontoverwaltungsanforderungen (etwa zum Erstellen oder Löschen eines Kontos) an den Dienst zu senden.

// Create client objects and set the subscription ID
_adlsClient = new DataLakeStoreAccountManagementClient(armCreds) { SubscriptionId = _subId };

Erstellen eines Data Lake Storage Gen1-Kontos

Im folgenden Codeausschnitt wird ein Data Lake Storage Gen1-Konto in dem Azure-Abonnement erstellt, das Sie beim Erstellen des Data Lake Storage Gen1-Kontoclientobjekts angegeben haben.

// Create Data Lake Storage Gen1 account
var adlsParameters = new DataLakeStoreAccount(location: _location);
_adlsClient.Account.Create(_resourceGroupName, _adlsAccountName, adlsParameters);

Auflisten aller Data Lake Storage Gen1-Konten in einem Abonnement

Fügen Sie Ihrer Klassendefinition die folgende Methode hinzu: Mit dem folgenden Codeausschnitt werden alle Data Lake Storage Gen1-Konten innerhalb eines bestimmten Azure-Abonnements aufgelistet:

// List all Data Lake Storage Gen1 accounts within the subscription
public static List<DataLakeStoreAccountBasic> ListAdlStoreAccounts()
{
    var response = _adlsClient.Account.List(_adlsAccountName);
    var accounts = new List<DataLakeStoreAccountBasic>(response);

    while (response.NextPageLink != null)
    {
        response = _adlsClient.Account.ListNext(response.NextPageLink);
        accounts.AddRange(response);
    }

    return accounts;
}

Löschen eines Data Lake Storage Gen1-Kontos

Im folgenden Codeausschnitt wird das zuvor erstellte Data Lake Storage Gen1-Konto gelöscht.

// Delete Data Lake Storage Gen1 account
_adlsClient.Account.Delete(_resourceGroupName, _adlsAccountName);

Weitere Informationen

Nächste Schritte