بدء استخدام Azure Data Lake Storage Gen1 باستخدام Azure CLI
ملاحظة
تم الآن إيقاف Azure Data Lake Storage Gen1. انظر إعلان التقاعد هنا. لم يعد من الممكن الوصول إلى الموارد Data Lake Storage Gen1. إذا كنت بحاجة إلى مساعدة خاصة، فالرجاء الاتصال بنا.
تعرف على كيفية استخدام Azure CLI لإنشاء حساب Azure Data Lake Storage Gen1 وتنفيذ العمليات الأساسية مثل إنشاء المجلدات وتحميل ملفات البيانات وتنزيلها وحذف حسابك وما إلى ذلك. لمزيد من المعلومات حول 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>
إنشاء حساب Azure Data Lake Storage Gen1
إنشاء مجموعة موارد جديدة. في الأمر التالي، قم بتوفير قيم المعلمات التي تريد استخدامها. إذا كان اسم الموقع يحتوي على مسافات، فضعه في علامات الاقتباس. على سبيل المثال "شرق الولايات المتحدة 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.
تحميل البيانات إلى حساب 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-
لإزالة إدخال ل ACL، استخدم الأمر التالي:
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 لحذف الحساب.