عمليات إدارة الحساب على Azure Data Lake Storage Gen1 باستخدام .NET SDK

  • مقالة

في هذه المقالة، ستتعلم كيفية تنفيذ عمليات إدارة الحساب على Azure Data Lake Storage Gen1 باستخدام .NET SDK. تتضمن عمليات إدارة الحساب إنشاء حساب Data Lake Storage Gen1، وإدراج الحسابات في اشتراك Azure، وحذف الحسابات، وما إلى ذلك.

للحصول على إرشادات حول كيفية تنفيذ عمليات إدارة البيانات على Data Lake Storage Gen1 باستخدام .NET SDK، راجع عمليات نظام الملفات على Data Lake Storage Gen1 باستخدام .NET SDK.

المتطلبات الأساسية

إنشاء تطبيق .NET

  1. في Visual Studio، حدد القائمة ملف ، جديد، ثم Project.

  2. اختر تطبيق وحدة التحكم (.NET Framework)، ثم حدد التالي.

  3. في Project name، أدخل CreateADLApplication، ثم حدد Create.

  4. أضف حزم NuGet إلى مشروعك.

    1. انقر بزر الماوس الأيمن فوق اسم المشروع في مستكشف الحلول وانقر فوق إدارة حزم NuGet.

    2. في علامة التبويب NuGet Package Manager ، تأكد من تعيين مصدر الحزمة إلى nuget.org وتحديد خانة الاختيار Include prerelease .

    3. ابحث عن حزم NuGet التالية وقم بتثبيتها:

      • Microsoft.Azure.Management.DataLake.Store - يستخدم هذا البرنامج التعليمي الإصدار 2.1.3-preview.

      • Microsoft.Rest.ClientRuntime.Azure.Authentication - يستخدم هذا البرنامج التعليمي الإصدار 2.2.12.

        إضافة مصدر NuGet

    4. أغلق NuGet Package Manager.

  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"

تنشئ القصاصة البرمجية التالية حساب Data Lake Storage Gen1 في اشتراك Azure الذي قدمته أثناء إنشاء كائن عميل حساب 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 ضمن اشتراك

أضف الأسلوب التالي إلى تعريف الفئة. تسرد القصاصة البرمجية التالية جميع حسابات Data Lake Storage Gen1 ضمن اشتراك Azure معين.

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

راجع أيضًا

الخطوات التالية