بدء استخدام 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"

إنشاء حساب

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

مشاركة عبر