بدء استخدام Azure Data Lake Storage Gen1 باستخدام Azure PowerShell

مقالة
04/27/2022
قراءة خلال 3 دقائق

ملاحظة

في 29 فبراير 2024 سيتم توقف Azure Data Lake Storage Gen1. لمزيد من المعلومات، راجع الإعلان الرسمي. إذا كنت تستخدم Azure Data Lake Storage Gen1، تأكد من الترحيل إلىAzure Data Lake Storage Gen2 قبل ذلك التاريخ. لمعرفة كيفية القيام بذلك، راجع ترحيلAzure Data Lake Storage من Gen1 إلى Gen2

إذا لم يكن لديك بالفعل حساب Azure Data Lake Storage Gen1، لا يمكنك إنشاء حسابات جديدة.

تعرف على كيفية استخدام Azure PowerShell لإنشاء حساب Gen1 Azure Data Lake Storage وتنفيذ العمليات الأساسية مثل إنشاء مجلدات وتحميل ملفات البيانات وتنزيلها وحذف حسابك وما إلى ذلك. لمزيد من المعلومات حول Data Lake Storage Gen1، راجع نظرة عامة على Data Lake Storage Gen1.

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

ملاحظة

تستخدم هذه المقالة الوحدة النمطية Azure Az PowerShell، وهي الوحدة النمطية PowerShell الموصى بها للتفاعل مع Azure. لبدء استخدام الوحدة النمطية Az PowerShell، راجع تثبيت Azure PowerShell. لمعرفة كيفية الترحيل إلى الوحدة النمطية Az PowerShell، راجع ترحيل Azure PowerShell من AzureRM إلى Az.

اشتراك Azure. راجع الحصول على الإصدار التجريبي المجاني من Azure .
Azure PowerShell 1.0 أو أحدث. راجع كيفية تثبيت Azure PowerShell وتكوينه.

المصادقة

تستخدم هذه المقالة نهج مصادقة أبسط مع Data Lake Storage Gen1 حيث تتم مطالبتك بإدخال بيانات اعتماد حساب Azure الخاص بك. ثم يخضع مستوى الوصول إلى حساب Data Lake Storage Gen1 ونظام الملفات لمستوى وصول المستخدم الذي قام بتسجيل الدخول. ومع ذلك، هناك طرق أخرى للمصادقة باستخدام Data Lake Storage Gen1، وهي مصادقة المستخدم النهائي أو مصادقة الخدمة إلى الخدمة. للحصول على إرشادات ومزيد من المعلومات حول كيفية المصادقة، راجع مصادقة المستخدم النهائي أو مصادقة الخدمة إلى الخدمة.

إنشاء حساب "Data Lake Storage Gen1"

من سطح المكتب، افتح نافذة Windows PowerShell جديدة. أدخل المقتطف التالي لتسجيل الدخول إلى حساب Azure الخاص بك، وتعيين الاشتراك، وتسجيل موفر Data Lake Storage Gen1. عند مطالبتك بتسجيل الدخول، تأكد من تسجيل الدخول كأحد مسؤولي/مالكي الاشتراك:
```
# 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"
```

يقترن حساب Data Lake Storage Gen1 بمجموعة موارد Azure. ابدأ بإنشاء مجموعة موارد.

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

Create an Azure Resource Group

إنشاء حساب Data Lake Storage Gen1. يجب أن يحتوي الاسم الذي تحدده على أحرف وأرقام صغيرة فقط.

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

Create a Data Lake Storage Gen1 account

تحقق من إنشاء الحساب بنجاح.
```
Test-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name
```
يجب أن يكون إخراج cmdlet صحيحا.

إنشاء هياكل الدليل

يمكنك إنشاء أدلة ضمن حسابك Data Lake Storage Gen1 لإدارة البيانات وتخزينها.

حدد دليلا جذريا.
```
$myrootdir = "/"
```

إنشاء دليل جديد يسمى mynewdirectory تحت الجذر المحدد.

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

تحقق من إنشاء الدليل الجديد بنجاح.
```
Get-AzDataLakeStoreChildItem -AccountName $dataLakeStorageGen1Name -Path $myrootdir
```
يجب أن يظهر مخرجا كما هو موضح في لقطة الشاشة التالية:

تحميل البيانات

يمكنك تحميل بياناتك إلى Data Lake Storage Gen1 مباشرة على مستوى الجذر، أو إلى دليل أنشأته داخل الحساب. توضح المقتطفات في هذا القسم كيفية تحميل بعض نماذج البيانات إلى الدليل (mynewdirectory) الذي أنشأته في القسم السابق.

إذا كنت تبحث عن بعض نماذج البيانات لتحميلها، فيمكنك الحصول على مجلد بيانات الإسعاف من مستودع Azure Data Lake Git. قم بتنزيل الملف وتخزينه في دليل محلي على الكمبيوتر، مثل C:\sampledata.

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

إعادة تسمية البيانات وتنزيلها وحذفها

لإعادة تسمية ملف، استخدم الأمر التالي:

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

لتنزيل ملف، استخدم الأمر التالي:

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

لحذف ملف، استخدم الأمر التالي:

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

عند المطالبة، أدخل Y لحذف العنصر. إذا كان لديك أكثر من ملف واحد لحذفه، فيمكنك توفير كافة المسارات مفصولة بفاصلة.

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

حذف حسابك

استخدم الأمر التالي لحذف حساب Data Lake Storage Gen1 الخاص بك.

Remove-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name

عند المطالبة، أدخل Y لحذف الحساب.