بدء استخدام Azure Data Lake Storage Gen1 باستخدام Azure CLI
ملاحظة
في 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 CLI لإنشاء حساب Gen1 Azure Data Lake Storage وتنفيذ العمليات الأساسية مثل إنشاء المجلدات وتحميل ملفات البيانات وتنزيلها وحذف حسابك وما إلى ذلك. لمزيد من المعلومات حول Data Lake Storage Gen1، راجع نظرة عامة على Data Lake Storage Gen1.
تُعد Azure CLI عبارة عن تجربة سطر أوامر Azure الخاصة بإدارة موارد Azure. يمكن استخدامه على أنظمة macOS وLinux وWindows. لمزيد من المعلومات، راجع نظرة عامة حول Azure CLI. يمكنك أيضا إلقاء نظرة على مرجع Azure Data Lake Storage Gen1 CLI للحصول على قائمة كاملة بالأوامر وبناء الجملة.
المتطلبات الأساسية
قبل أن تبدأ هذه المقالة، يجب أن يكون لديك ما يلي:
اشتراك Azure. راجع الحصول على الإصدار التجريبي المجاني من Azure .
Azure CLI - راجع تثبيت Azure CLI للحصول على التعليمات.
المصادقة
تستخدم هذه المقالة نهج مصادقة أبسط مع Data Lake Storage Gen1 حيث تقوم بتسجيل الدخول كمستخدم نهائي. ثم يخضع مستوى الوصول إلى حساب Data Lake Storage Gen1 ونظام الملفات لمستوى وصول المستخدم الذي قام بتسجيل الدخول. ومع ذلك ، هناك طرق أخرى أيضا للمصادقة باستخدام Data Lake Storage Gen1 ، وهي مصادقة المستخدم النهائي أو مصادقة الخدمة إلى الخدمة. للحصول على إرشادات ومزيد من المعلومات حول كيفية المصادقة، راجع مصادقة المستخدم النهائي أو مصادقة الخدمة إلى الخدمة.
تسجيل الدخول إلى اشتراكك في Azure
سجل الدخول إلى اشتراكك في Azure.
az loginيمكنك الحصول على رمز لاستخدامه في الخطوة التالية. استخدم مستعرض ويب لفتح الصفحة https://aka.ms/devicelogin وإدخال الرمز المراد مصادقته. تتم مطالبتك بتسجيل الدخول باستخدام بيانات الاعتماد الخاصة بك.
بمجرد تسجيل الدخول، تسرد النافذة جميع اشتراكات Azure المقترنة بحسابك. استخدم الأمر التالي لاستخدام اشتراك معين.
az account set --subscription <subscription id>
إنشاء حساب Gen1 Azure Data Lake Storage
إنشاء مجموعة موارد جديدة. في الأمر التالي، قم بتوفير قيم المعلمات التي تريد استخدامها. إذا كان اسم الموقع يحتوي على مسافات، فضعه في علامات اقتباس. على سبيل المثال "شرق الولايات المتحدة 2".
az group create --location "East US 2" --name myresourcegroupإنشاء حساب Data Lake Storage Gen1.
az dls account create --account mydatalakestoragegen1 --resource-group myresourcegroup
إنشاء مجلدات في حساب Data Lake Storage Gen1
يمكنك إنشاء مجلدات ضمن حسابك Azure Data Lake Storage Gen1 لإدارة البيانات وتخزينها. استخدم الأمر التالي لإنشاء مجلد يسمى mynewfolder في جذر حساب Data Lake Storage Gen1.
az dls fs create --account mydatalakestoragegen1 --path /mynewfolder --folder
ملاحظة
تضمن المعلمة --folder أن الأمر ينشئ مجلدا. في حالة عدم وجود هذه المعلمة، يقوم الأمر بإنشاء ملف فارغ يسمى mynewfolder في جذر حساب Data Lake Storage Gen1.
Upload البيانات إلى حساب Data Lake Storage Gen1
يمكنك تحميل البيانات إلى Data Lake Storage Gen1 مباشرة على مستوى الجذر أو إلى مجلد قمت بإنشائه داخل الحساب. توضح المقتطفات أدناه كيفية تحميل بعض نماذج البيانات إلى المجلد (mynewfolder) الذي أنشأته في القسم السابق.
إذا كنت تبحث عن بعض نماذج البيانات لتحميلها، فيمكنك الحصول على مجلد بيانات الإسعاف من مستودع Azure Data Lake Git. قم بتنزيل الملف وتخزينه في دليل محلي على الكمبيوتر، مثل C:\sampledata.
az dls fs upload --account mydatalakestoragegen1 --source-path "C:\SampleData\AmbulanceData\vehicle1_09142014.csv" --destination-path "/mynewfolder/vehicle1_09142014.csv"
ملاحظة
بالنسبة للوجهة، يجب تحديد المسار الكامل بما في ذلك اسم الملف.
سرد الملفات في حساب Data Lake Storage Gen1
استخدم الأمر التالي لسرد الملفات في حساب Data Lake Storage Gen1.
az dls fs list --account mydatalakestoragegen1 --path /mynewfolder
يجب أن يكون ناتج هذا مشابها لما يلي:
[
{
"accessTime": 1491323529542,
"aclBit": false,
"blockSize": 268435456,
"group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
"length": 1589881,
"modificationTime": 1491323531638,
"msExpirationTime": 0,
"name": "mynewfolder/vehicle1_09142014.csv",
"owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
"pathSuffix": "vehicle1_09142014.csv",
"permission": "770",
"replication": 1,
"type": "FILE"
}
]
إعادة تسمية البيانات وتنزيلها وحذفها من حساب Data Lake Storage Gen1
لإعادة تسمية ملف، استخدم الأمر التالي:
az dls fs move --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csvلتنزيل ملف، استخدم الأمر التالي. تأكد من أن مسار الوجهة الذي تحدده موجود بالفعل.
az dls fs download --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014_copy.csv --destination-path "C:\mysampledata\vehicle1_09142014_copy.csv"ملاحظة
يقوم الأمر بإنشاء المجلد الوجهة إذا لم يكن موجودا.
لحذف ملف، استخدم الأمر التالي:
az dls fs delete --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014_copy.csvإذا كنت ترغب في حذف المجلد mynewfolder والملفvehicle1_09142014_copy.csv معا في أمر واحد، استخدم المعلمة --recurse
az dls fs delete --account mydatalakestoragegen1 --path /mynewfolder --recurse
استخدام الأذونات وقوائم التحكم بالوصول لحساب Data Lake Storage Gen1
في هذا القسم، يمكنك التعرف على كيفية إدارة قوائم التحكم بالوصول والأذونات باستخدام Azure CLI. للحصول على مناقشة مفصلة حول كيفية تنفيذ قوائم التحكم في الوصول في Azure Data Lake Storage Gen1، راجع التحكم في الوصول في Azure Data Lake Storage Gen1.
لتحديث مالك ملف/مجلد، استخدم الأمر التالي:
az dls fs access set-owner --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --group 80a3ed5f-959e-4696-ba3c-d3c8b2db6766 --owner 6361e05d-c381-4275-a932-5535806bb323لتحديث أذونات ملف/مجلد، استخدم الأمر التالي:
az dls fs access set-permission --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --permission 777للحصول على قوائم التحكم في الوصول لمسار معين، استخدم الأمر التالي:
az dls fs access show --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csvيجب أن يبدو الإخراج مشابهًا لما يلي:
{ "entries": [ "user::rwx", "group::rwx", "other::---" ], "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20", "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20", "permission": "770", "stickyBit": false }لتعيين إدخال لقائمة التحكم في الوصول (ACL)، استخدم الأمر التالي:
az dls fs access set-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323:-w-لإزالة إدخال لقائمة التحكم في الوصول، استخدم الأمر التالي:
az dls fs access remove-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323لإزالة قائمة تحكم الوصول الافتراضية بالكامل، استخدم الأمر التالي:
az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder --default-aclلإزالة قائمة تحكم الوصول غير الافتراضية بالكامل، استخدم الأمر التالي:
az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder
حذف حساب Data Lake Storage Gen1
استخدم الأمر التالي لحذف حساب Data Lake Storage Gen1.
az dls account delete --account mydatalakestoragegen1
عند المطالبة، أدخل Y لحذف الحساب.