إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تُعد Azure CLI عبارة عن تجربة سطر أوامر Azure الخاصة بإدارة موارد Azure. يمكنك استخدامه في المستعرض الخاص بك مع Azure Cloud Shell. ويمكنك أيضاً تثبيته على الأجهزة التي تعمل بنظام التشغيل macOS أو Linux أو Windows وتشغيله من سطر الأوامر. في هذا التشغيل السريع، تتعلم كيفية استخدام Azure CLI لتحميل البيانات وتنزيلها من وإلى تخزين Azure Blob.
المتطلبات الأساسية
للوصول إلى Azure Storage، ستحتاج إلى اشتراك Azure. إذا لم يكن لديك اشتراك بالفعل، فأنشئ حسابًا مجانيًا قبل أن تبدأ.
يتم الوصول إلى Azure Storage من خلال حساب تخزين. لهذا التشغيل السريع، قم بإنشاء حساب تخزين باستخدام مدخل Microsoft Azure أو Azure PowerShell أو Azure CLI. للحصول على مساعدة في إنشاء حساب تخزين، راجع إنشاء حساب تخزين.
إعداد البيئة الخاصة بك لـ Azure CLI
استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع بدء استخدام Azure Cloud Shell.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات تسجيل الدخول الأخرى، راجع المصادقة على Azure باستخدام Azure CLI.
عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات حول الملحقات، راجع استخدام الملحقات وإدارتها باستخدام Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
- تتطلب هذه المقالة الإصدار 2.0.46 أو أحدث من Azure CLI. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.
تخويل الوصول إلى تخزين Blob
يمكنك تخويل الوصول إلى تخزين Blob من Azure CLI إما باستخدام بيانات اعتماد Microsoft Entra أو باستخدام مفتاح الوصول إلى حساب التخزين. يوصى باستخدام بيانات اعتماد Microsoft Entra. توضح هذه المقالة كيفية تخويل عمليات تخزين الكائن الثنائي كبير الحجم باستخدام معرف Microsoft Entra.
تدعم أوامر Azure CLI لعمليات البيانات مقابل تخزين Blob المعلمة --auth-mode ، والتي تمكنك من تحديد كيفية تخويل عملية معينة. قم بتعيين المعلمة --auth-mode إلى login للتفويض باستخدام بيانات اعتماد Microsoft Entra. لمزيد من المعلومات، راجع تخويل الوصول إلى بيانات الكائن الثنائي كبير الحجم أو قائمة الانتظار باستخدام Azure CLI.
تدعم عمليات بيانات تخزين Blob فقط المعلمة --auth-mode . تستخدم عمليات الإدارة، مثل إنشاء مجموعة موارد أو حساب تخزين، بيانات اعتماد Microsoft Entra تلقائيا للتخويل.
للبدء، قم بتسجيل الدخول إلى حساب Azure الخاص بك باستخدام az login.
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 الخاص بك لتخويل العملية لإنشاء الحاوية. قبل إنشاء الحاوية، قم بتعيين دور مساهم بيانات كائن ثنائي كبير الحجم للتخزين لنفسك. حتى إذا كنت مالك الحساب، فأنت بحاجة إلى أذونات صريحة لإجراء عمليات البيانات مقابل حساب التخزين. لمزيد من المعلومات حول تعيين أدوار 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
عند فتح الملف، اضغط على إدراج. اكتب 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 الخاصة عبر بروتوكولات http وhttps.
لتحميل ملفات متعددة في نفس الوقت، يمكنك استخدام الأمر az storage blob upload-bat .
إدراج الكائنات الثنائية كبيرة الحجم في حاوية
قم بإدراج الكائنات الثنائية كبيرة الحجم في الحاوية باستخدام الأمر 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 وملفات Azure. لمزيد من المعلومات حول AzCopy v10، أحدث إصدار من AzCopy، راجع بدء استخدام AzCopy. للتعرف على استخدام AzCopy v10 مع تخزين Blob، راجع نقل البيانات باستخدام تخزين AzCopy وBlob.
يستخدم المثال التالي 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. لمعرفة المزيد حول العمل مع تخزين Blob باستخدام Azure CLI، حدد خيارا أدناه.