Kontoverwaltungsvorgänge für Azure Data Lake Storage Gen1 mithilfe des .NET SDKAccount management operations on Azure Data Lake Storage Gen1 using .NET SDK

In diesem Artikel erfahren Sie, wie Sie mithilfe des .NET SDK Kontoverwaltungsvorgänge in Azure Data Lake Storage Gen1 ausführen.In this article, you learn how to perform account management operations on Azure Data Lake Storage Gen1 using .NET SDK. 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.Account management operations include creating a Data Lake Storage Gen1 account, listing the accounts in an Azure subscription, deleting the accounts, etc.

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.For instructions on how to perform data management operations on Data Lake Storage Gen1 using .NET SDK, see Filesystem operations on Data Lake Storage Gen1 using .NET SDK.

VoraussetzungenPrerequisites

  • Visual Studio 2013 und höher.Visual Studio 2013 or above. In der Anleitung unten wird Visual Studio 2019 verwendet.The instructions below use Visual Studio 2019.

  • Ein Azure-Abonnement.An Azure subscription. Siehe Kostenlose Azure-Testversion.See Get Azure free trial.

Erstellen einer .NET-AnwendungCreate a .NET application

  1. Wählen Sie in Visual Studio das Menü Datei, dann die Option Neu und anschließend Projekt aus.In Visual Studio, select the File menu, New, and then Project.

  2. Wählen Sie Konsolen-App (.NET Framework) und dann Weiter aus.Choose Console App (.NET Framework), and then select Next.

  3. Geben Sie unter ProjektnameCreateADLApplication ein, und wählen Sie dann Erstellen aus.In Project name, enter CreateADLApplication, and then select Create.

  4. Fügen Sie Ihrem Projekt die NuGet-Pakete hinzu.Add the NuGet packages to your project.

    1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen und dann auf NuGet-Pakete verwalten.Right-click the project name in the Solution Explorer and click Manage NuGet Packages.

    2. Stellen Sie auf der Registerkarte NuGet-Paket-Manager sicher, dass Paketquelle auf nuget.org festgelegt und das Kontrollkästchen Vorabversion einbeziehen aktiviert ist.In the NuGet Package Manager tab, make sure that Package source is set to nuget.org and that Include prerelease check box is selected.

    3. Suchen und installieren Sie die folgenden NuGet-Pakete:Search for and install the following NuGet packages:

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

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

        Hinzufügen einer NuGet-QuelleAdd a NuGet source

    4. Schließen Sie den NuGet-Paket-Manager.Close the NuGet Package 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.Open Program.cs, delete the existing code, and then include the following statements to add references to namespaces.

    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.Declare the variables and provide the values for placeholders. Stellen Sie außerdem sicher, dass der angegebene lokale Pfad und der Dateiname auf dem Computer vorhanden sind.Also, make sure the local path and file name you provide exist on the computer.

    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.In the remaining sections of the article, you can see how to use the available .NET methods to perform operations such as authentication, file upload, etc.

AuthentifizierungAuthentication

Erstellen des ClientobjektsCreate client object

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.The following snippet creates the Data Lake Storage Gen1 account client object, which is used to issue account management requests to the service, such as create account, delete account, etc.

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

Erstellen eines Data Lake Storage Gen1-KontosCreate a Data Lake Storage Gen1 account

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.The following snippet creates a Data Lake Storage Gen1 account in the Azure subscription you provided while creating the Data Lake Storage Gen1 account client object.

// 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 AbonnementList all Data Lake Storage Gen1 accounts within a subscription

Fügen Sie Ihrer Klassendefinition die folgende Methode hinzu:Add the following method to your class definition. Mit dem folgenden Codeausschnitt werden alle Data Lake Storage Gen1-Konten innerhalb eines bestimmten Azure-Abonnements aufgelistet:The following snippet lists all Data Lake Storage Gen1 accounts within a given Azure subscription.

// 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-KontosDelete a Data Lake Storage Gen1 account

Im folgenden Codeausschnitt wird das zuvor erstellte Data Lake Storage Gen1-Konto gelöscht.The following snippet deletes the Data Lake Storage Gen1 account you created earlier.

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

Weitere InformationenSee also

Nächste SchritteNext steps