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

مقالة
06/27/2018

ملاحظة

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

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

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

ملاحظة

نوصي باستخدام وحدة Azure Az PowerShell للتفاعل مع Azure. راجع تثبيت 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"

إنشاء مجموعة موارد Azure

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

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

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

تحقق من إنشاء الحساب بنجاح.
```
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 لحذف الحساب.