يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تنزيل الكائنات الثنائية كبيرة الحجم من Azure Blob Storage باستخدام AzCopy
مقالة
١٨/٠٥/١٤٤٦ هـ
يمكنك تنزيل الكائنات الثنائية كبيرة الحجم والدلائل من وحدة تخزين Blob باستخدام الأداة المساعدة لسطر الأوامر AzCopy v10.
للاطلاع على أمثلة لأنواع أخرى من المهام مثل تحميل الملفات أو المزامنة مع تخزين Blob أو نسخ الكائنات الثنائية كبيرة الحجم بين الحسابات، راجع الارتباطات المعروضة في قسم الخطوات التالية من هذه المقالة.
الشروع في العمل
راجع مقالة بدء استخدام AzCopy لتنزيل AzCopy والتعرف على الطرق التي يمكنك من خلالها توفير بيانات اعتماد التخويل لخدمة التخزين.
ملاحظة
تفترض الأمثلة الواردة في هذه المقالة أنك قدمت بيانات اعتماد التخويل باستخدام معرف Microsoft Entra.
إذا كنت تفضل استخدام رمز SAS المميز لتخويل الوصول إلى بيانات كائن ثنائي كبير الحجم، فإنه يمكنك إلحاق هذا الرمز المميز بعنوان URL للمورد في كل أمر AzCopy. على سبيل المثال: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.
يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').
إعراب
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' '<local-file-path>'
إذا كانت Content-md5 قيمة خاصية الكائن الثنائي الكبير الحجم تحتوي على تجزئة، فإن AzCopy يحسب تجزئة MD5 للبيانات التي تم تنزيلها ويتحقق من أن تجزئة MD5 المخزنة في خاصية Content-md5 للكائن الثنائي الكبير الحجم تتطابق مع التجزئة المحسوبة. إذا لم تتطابق هذه القيم، يفشل التنزيل ما لم تتجاوز هذا السلوك عن طريق إلحاق --check-md5=NoCheck أو --check-md5=LogOnly بأمر النسخ.
يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').
إعراب
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' '<local-directory-path>' --recursive
ينتج عن هذا المثال دليل مسمى C:\myDirectory\myBlobDirectory يحتوي على كافة الكائنات الثنائية كبيرة الحجم التي تم تنزيلها.
تنزيل محتويات الدليل
يمكنك تنزيل محتويات الدليل دون نسخ دليل المحتوي نفسه باستخدام رمز البدل (*).
تلميح
يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').
ملاحظة
حاليا، يتم دعم هذا السيناريو فقط للحسابات التي لا تحتوي على مساحة أسماء هرمية.
قم بإلحاق العلامة --recursive لتنزيل الملفات في جميع الدلائل الفرعية.
تنزيل الكائنات الثنائية كبيرة الحجم محددة
يمكنك تنزيل الكائنات الثنائية كبيرة الحجم محددة باستخدام أسماء ملفات كاملة أو أسماء جزئية بأحرف بدل (*) أو باستخدام التواريخ والأوقات.
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').
تحديد أسماء كائنات ثنائية كبيرة الحجم كاملة متعددة
استخدم أمر نسخ azcopy مع الخيار --include-path. فصل أسماء الكائنات الثنائية كبيرة الحجم الفردية باستخدام فاصلة منقوطة (;).
إعراب
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' '<local-directory-path>' --include-path <semicolon-separated-file-list>
في هذا المثال، تقوم AzCopy بنقل الدليل https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos والملف https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/documents/myFile.txt. قم بتضمين خيار --recursive لنقل جميع الكائنات الثنائية الكبيرة الحجم في الدليل https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos.
يمكنك أيضا استبعاد الكائنات الثنائية كبيرة الحجم باستخدام الخيار --exclude-path. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .
استخدم حرف البدل
استخدم أمر نسخ azcopy مع الخيار --include-pattern. حدد الأسماء الجزئية التي تشمل أحرف البدل. افصل بين الأسماء باستخدام فاصلة منقوطة (;).
إعراب
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' '<local-directory-path>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>
يمكنك أيضا استبعاد الكائنات الثنائية كبيرة الحجم باستخدام الخيار --exclude-pattern. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .
تنطبق الخيارات --include-pattern والخيارات --exclude-pattern فقط على أسماء الكائنات الثنائية كبيرة الحجم وليس على المسار. إذا كنت تريد نسخ كافة الملفات النصية (الكائنات الثنائية كبيرة الحجم) الموجودة في شجرة دليل، فاستخدم الخيار -recursive للحصول على شجرة الدليل بالكامل، ثم استخدم -include-pattern وحدد *.txt للحصول على كافة الملفات النصية.
تنزيل النقاط التي تم تعديلها قبل أو بعد تاريخ ووقت
استخدم أمر azcopy copy مع الخيار --include-before أو --include-after. حدد التاريخ والوقت بتنسيق ISO-8601 (على سبيل المثال: 2020-08-19T15:04:00Z).
تقوم الأمثلة التالية بتنزيل الملفات التي تم تعديلها في التاريخ المحدد أو بعده.
إعراب
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>/*' '<local-directory-path>' --include-after <Date-Time-in-ISO-8601-format>
إذا كنت تستخدم رمزًا مميزًا لـSAS لتفويض الوصول إلى بيانات الكائن الثنائي الكبير الحجم، فقم بإلحاق لقطة DateTime بعد الرمز المميز SAS. على سبيل المثال: 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z'.
تنزيل باستخدام علامات اختيارية
يمكنك تعديل عملية التنزيل باستخدام علامات اختيارية. إليك بعض الأمثلة.
السيناريو
العلامة
فك ضغط الملفات تلقائيًا.
--decompress
حدد مدى التفصيل الذي تريد أن تكون عليه إدخالات السجل المتعلقة بالنسخ.
--مستوى السجل = [تحذير| خطأ|معلومات| لا شيء]
حدد ما إذا كان سيتم الكتابة فوق الملفات والكائنات الثنائية كبيرة الحجم المتعارضة في الوجهة وكيفية ذلك.
لا يدعم AzCopy تنزيل البيانات من مواقع الويب الثابتة المستضافة في Azure Storage من خلال نقطة النهاية العامة، مثل https://mystorageaccount.z12.web.core.windows.net. بدلا من ذلك، استخدم الحاوية $web في نقطة نهاية الكائن الثنائي كبير الحجم لتنزيل الملفات من موقع الويب الثابت الخاص بك.
AzCopy هي أداة مساعدة لخط الأوامر التي يمكنك استخدامها لنسخ البيانات إلى أو من أو بين حسابات التخزين. تساعدك هذه المقالة في تنزيل AzCopy، والاتصال بحساب التخزين الخاص بك، ثم نقل البيانات.
نقل البيانات باستخدام AzCopy وتخزين الملفات. AzCopy هي أداة سطر أوامر لنسخ الكائنات الثنائية كبيرة الحجم أو الملفات من أو إلى حساب التخزين. استخدم AzCopy مع ملفات Azure.
تعرف على كيفية إنشاء شبكة تسليم المحتوى (CDN) واستخدامها داخل Azure لاستضافة الأصول شائعة الاستخدام، مثل الصور في موقع ويب. تغطي الوحدة Azure CDN وتستخدم Blob Storage كنموذج تخزين أساسي للبيانات الثابتة أو غير القابلة للvolatile.