你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 .NET SDK 对 Azure Data Lake Storage Gen1 进行的帐户管理操作

本文介绍如何使用 .NET SDK 在 Azure Data Lake Storage Gen1 上执行帐户管理操作。 帐户管理操作包括创建 Data Lake Storage Gen1 帐户、列出 Azure 订阅中的帐户、删除帐户,等等。

若要了解如何使用 .NET SDK 在 Data Lake Storage Gen1 上执行数据管理操作,请参阅在 Data Lake Storage Gen1 上使用 .NET SDK 进行的文件系统操作

先决条件

  • Visual Studio 2013 或更高版本。 以下说明使用的是 Visual Studio 2019。

  • Azure 订阅。 请参阅获取 Azure 免费试用版

创建 .NET 应用程序

  1. 在 Visual Studio 中,依次选择“文件”菜单、“新建”,然后选择“项目”。

  2. 选择“控制台应用(.NET Framework)”,然后选择“下一步” 。

  3. 在“项目名称”中,输入 CreateADLApplication,然后选择“创建”

  4. 将 NuGet 包添加到项目。

    1. 在解决方案资源管理器中右键单击项目名称,单击“管理 NuGet 包”

    2. 在“NuGet 包管理器”选项卡上,确保“包源”设置为“nuget.org”,“包含预发行版”复选框处于选中状态。

    3. 搜索并安装以下 NuGet 包:

      • Microsoft.Azure.Management.DataLake.Store - 本教程使用 v2.1.3-预览版。

      • Microsoft.Rest.ClientRuntime.Azure.Authentication - 本教程使用 v2.2.12。

        Add a NuGet source

    4. 关闭“NuGet 包管理器”。

  5. 打开“Program.cs” ,删除现有代码,并包含以下语句,添加对命名空间的引用。

    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. 声明变量,并提供占位符的值。 此外,确保计算机中存在所提供的本地路径和文件名。

    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>";                    
            }
        }
    }
    

本文的剩余部分介绍如何使用现有的 .NET 方法来执行操作,例如身份验证和文件上传等。

身份验证

创建客户端对象

以下代码片段创建 Data Lake Storage Gen1 帐户客户端对象,该对象用于向服务发出帐户管理请求,例如创建帐户、删除帐户,等等。

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

创建 Data Lake Storage Gen1 帐户

以下代码片段在 Azure 订阅中创建 Data Lake Storage Gen1 帐户,该订阅是在创建 Data Lake Storage Gen1 帐户客户端对象时提供的。

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

列出订阅中的所有 Data Lake Storage Gen1 帐户

向类定义添加以下方法。 以下代码片段列出了给定 Azure 订阅中的所有 Data Lake Storage Gen1 帐户。

// 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;
}

删除 Data Lake Storage Gen1 帐户

以下代码片段删除此前创建的 Data Lake Storage Gen1 帐户。

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

另请参阅

后续步骤