مشاركة عبر

التشغيل السريع: إنشاء كائنات ثنائية كبيرة الحجم وتنزيلها وسردها باستخدام Azure CLI

  • مقالة

تُعد Azure CLI عبارة عن تجربة سطر أوامر Azure الخاصة بإدارة موارد Azure. يمكنك استخدامه في المستعرض الخاص بك مع Azure Cloud Shell. ويمكنك أيضاً تثبيته على الأجهزة التي تعمل بنظام التشغيل macOS أو Linux أو Windows وتشغيله من سطر الأوامر. وفي دليل التشغيل السريع هذا، ستتعلم استخدام Azure CLI لتحميل البيانات وتنزيلها من Azure Blob storage وإليها.

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

للوصول إلى Azure Storage، يلزم الحصول على أحد اشتراكات Azure. إذا لم يكن لديك اشتراك بالفعل، فأنشئ حسابًا مجانيًا قبل أن تبدأ.

يتم الوصول إلى Azure Storage من خلال حساب تخزين. بالنسبة للتشغيل السريع هذا، أنشئ حساب تخزين باستخدام مدخل Azure أو Azure PowerShell أو Azure CLI. للمساعدة في إنشاء حساب تخزين، راجع إنشاء حساب تخزين.

إعداد البيئة الخاصة بك لـ Azure CLI

  • تتطلب هذه المقالة الإصدار 2.0.46، أو إصداراً أحدث من Azure CLI. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.

السماح بالوصول إلى Blob storage

يمكنك تخويل الوصول إلى تخزين Blob من Azure CLI إما باستخدام بيانات اعتماد Microsoft Entra أو باستخدام مفتاح الوصول إلى حساب التخزين. يوصى باستخدام بيانات اعتماد Microsoft Entra. توضح هذه المقالة كيفية تخويل عمليات تخزين Blob باستخدام معرف Microsoft Entra.

تعمل أوامر Azure CLI لعمليات البيانات مقابل Blob storage على دعم المعلمة --auth-mode، والتي تمكنك من تحديد طريقة تخويل إحدى العمليات المعينة. قم بتعيين المعلمة --auth-mode إلى login للتخويل باستخدام بيانات اعتماد Microsoft Entra. للحصول على مزيد من المعلومات، راجع تخويل الوصول إلى بيانات قائمة الانتظار أو الكائنات الثنائية كبيرة الحجم باستخدام Azure CLI.

لا تدعم عمليات بيانات تخزين Blob سوى المعلمة --auth-mode فقط. تستخدم عمليات الإدارة، مثل إنشاء مجموعة موارد أو حساب تخزين، بيانات اعتماد Microsoft Entra تلقائيا للتخويل.

للبدء، سجل الدخول إلى حساب Azure الخاص بك باستخدام تسجيل الدخول إلى az.

az login

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

أنشئ إحدى مجموعات موارد Azure باستخدام الأمر "az group create". وتُعد مجموعة الموارد عبارة عن حاوية منطقية يتم فيها توزيع موارد Azure وإدارتها.

تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az group create \
    --name <resource-group> \
    --location <location>

إنشاء حساب تخزين

إنشاء حساب تخزين للأغراض العامة مع الأمر az storage account create. يمكن استخدام حساب التخزين للأغراض العامة لكافة الخدمات الأربع: البيانات غير المنظمة، والملفات، والجداول، وقوائم الانتظار.

تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az storage account create \
    --name <storage-account> \
    --resource-group <resource-group> \
    --location <location> \
    --sku Standard_ZRS \
    --encryption-services blob

إنشاء حاوية

دائمًا ما تُحمّل الكائنات الثنائية كبيرة الحجم في إحدى الحاويات. ويمكنك تنظيم مجموعات من الكائنات الثنائية كبيرة الحجم في حاويات بطريقة مشابهة للطريقة التي تُنظم بها ملفاتك على الكمبيوتر في المجلدات. أنشئ حاوية لتخزين البيانات غير المنظمة كبيرة الحجم باستخدام الأمر az storage container create.

يستخدم المثال التالي حساب Microsoft Entra الخاص بك لتخويل العملية لإنشاء الحاوية. وقبل إنشاء الحاوية، عيّن نفسك في دور "Storage Blob Data Contributor". وحتى إذا كنت مالك الحساب، فأنت بحاجة إلى أذونات صريحة لتنفيذ عمليات البيانات على حساب التخزين. لمزيد من المعلومات حول تعيين أدوار Azure، راجع تعيين دور Azure للوصول إلى بيانات الكائن الثنائي كبير الحجم.

تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az ad signed-in-user show --query id -o tsv | az role assignment create \
    --role "Storage Blob Data Contributor" \
    --assignee @- \
    --scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>"

az storage container create \
    --account-name <storage-account> \
    --name <container> \
    --auth-mode login

هام

قد تستغرق تعيينات الأدوار في Azure بضع دقائق.

يمكنك أيضاً استخدام مفتاح حساب التخزين لتخويل العملية لإنشاء الحاوية. لمزيد من المعلومات حول تخويل عمليات البيانات باستخدام Azure CLI، راجع تخويل الوصول إلى بيانات قائمة الانتظار أو الكائنات الثنائية كبيرة الحجم باستخدام Azure CLI.

تحميل الكائن الثنائي كبير الحجم

يدعم مخزن البيانات الثنائية كبيرة الحجم، والبيانات الثنائية كبيرة الحجم الملحقة، وبيانات الصفحة الثنائية كبيرة الحجم. توضح الأمثلة الموجودة في دليل التشغيل السريع هذا كيفية العمل مع الكائنات الثنائية كبيرة الحجم الخاصة بالكتل.

لذا في البداية، أنشئ ملفاً لتحميله إلى كائن ثنائي كبير الحجم خاص بالكتل. وإذا كنت تستخدم Azure Cloud Shell، فاستخدم الأمر التالي لإنشاء الملف:

vi helloworld

عند فتح الملف، اضغط على "insert". اكتب Hello world، ثم اضغط على Esc. بعد ذلك، اكتب :x، ثم اضغط على Enter.

في هذا المثال، يمكنك تحميل كائن ثنائي كبير الحجم إلى الحاوية التي أنشأتها في الخطوة الأخيرة باستخدام الأمر "az storage blob upload". وليس من الضروري تحديد مسار ملف نظرًا لإنشاء الملف في الدليل الجذر. تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file myFile.txt \
    --auth-mode login

تؤدي هذه العملية إلى إنشاء الكائن الثنائي كبير الحجم إذا لم يكن موجوداً بالفعل، أو استبداله إذا كان موجوداً. حمّل العديد من الملفات حسبما تريد قبل المتابعة.

عند تحميل كائن ثنائي كبير الحجم باستخدام Azure CLI، فإنه يصدر استدعاءات REST API المعنية عبر بروتوكولات http وhttps.

لتحميل ملفات متعددة في الوقت نفسه، يمكنك استخدام الأمر az storage blob upload-batch.

سرد الكائنات الثنائية كبيرة الحجم في حاوية

اسرد الكائنات الثنائية كبيرة الحجم في حاوية باستخدام الأمر az storage blob list. تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az storage blob list \
    --account-name <storage-account> \
    --container-name <container> \
    --output table \
    --auth-mode login

تنزيل كائن ثنائي كبير الحجم

استخدم الأمر az storage blob download لتنزيل الكائن الثنائي كبير الحجم الذي حملته في وقت سابق. تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az storage blob download \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file <~/destination/path/for/file> \
    --auth-mode login

نقل البيانات باستخدام AzCopy

توفر الأداة المساعدة لسطر أوامر AzCopy إمكانية نقل للبيانات قابلة للبرمجة وعلى درجة عالية من الأداء لخدمة Azure Storage. ويمكنك استخدام AzCopy لنقل البيانات من Blob storage وAzure Files وإليها. للحصول على المزيد من المعلومات حول AzCopy الإصدار 10، والإصدار الأحدث من AzCopy، اطلع على البدء باستخدام AzCopy. ولمعرفة المزيد حول استخدام AzCopy الإصدار 10 مع Blob storage، راجع نقل البيانات باستخدام AzCopy وBlob storage.

يستخدم المثال التالي AzCopy لتحميل ملف محلي إلى أحد الكائنات الثنائية كبيرة الحجم. تذكر استبدال قيم العينة بقيمك الخاصة:

azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'

تنظيف الموارد

إذا كنت تريد حذف الموارد التي أنشأتها كجزء من هذا التشغيل السريع، بما في ذلك حساب التخزين، فاحذف مجموعة الموارد باستخدام الأمر az group delete. تذكر استبدال قيم العناصر النائبة بين أقواس الزاوية بالقيم الخاصة بك:

az group delete \
    --name <resource-group> \
    --no-wait

الخطوات التالية

في بدء التشغيل السريع هذا، تعلمتَ كيفية نقل الملفات بين نظام القرص المحلي وإحدى الحاويات في Azure Blob storage. لمعرفة المزيد عن العمل مع تخزين Blob باستخدام Azure CLI، حدد أحد الخيارات أدناه.

إدارة الكائنات الثنائية كبيرة الحجم للكتل باستخدام Azure CLI

عينات Azure CLI الخاصة بـ Blob storage