مشاركة عبر

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

  • مقالة

يمكنك نسخ الكائنات الثنائية كبيرة الحجم والدلائل والحاويات بين حسابات التخزين باستخدام الأداة المساعدة لسطر الأوامر AzCopy v10.

للاطلاع على أمثلة لأنواع أخرى من المهام مثل تحميل الملفات وتنزيل الكائنات الثنائية كبيرة الحجم والمزامنة مع تخزين Blob، راجع الارتباطات المعروضة في قسم الخطوات التالية من هذه المقالة.

يستخدم AzCopy واجهات برمجة التطبيقات من خادم إلى خادم، لذلك يتم نسخ البيانات مباشرة بين خوادم التخزين.

الشروع في العمل

راجع مقالة بدء استخدام AzCopy لتنزيل AzCopy والتعرف على الطرق التي يمكنك من خلالها توفير بيانات اعتماد التخويل لخدمة التخزين.

إشعار

تفترض الأمثلة الواردة في هذه المقالة أنك قدمت بيانات اعتماد التخويل باستخدام معرف Microsoft Entra وأن هوية Microsoft Entra لديها تعيينات الأدوار المناسبة لكل من حسابات المصدر والوجهة.

بدلا من ذلك، يمكنك إلحاق رمز SAS المميز إما بعنوان URL المصدر أو الوجهة في كل أمر AzCopy. على سبيل المثال: azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>'.

المبادئ التوجيهيه

قم بتطبيق الإرشادات التالية على أوامر AzCopy.

  • إذا كنت تستخدم تخويل Microsoft Entra لكل من المصدر والوجهة، فيجب أن ينتمي كلا الحسابين إلى نفس مستأجر Microsoft Entra.

  • يجب أن يكون لدى عميلك حق الوصول إلى الشبكة إلى كل من حسابات التخزين المصدر والوجهة. لمعرفة كيفية تكوين إعدادات الشبكة لكل حساب تخزين، راجع تكوين جدران حماية تخزين Azure والشبكات الظاهرية.

  • إذا قمت بالنسخ إلى حساب تخزين كتلة كائن ثنائي كبير الحجم متميز، فقم بحذف طبقة الوصول لنقطة من عملية النسخ عن طريق تعيين s2s-preserve-access-tier إلى false (على سبيل المثال: --s2s-preserve-access-tier=false). لا تدعم حسابات التخزين Premium حظر كائن ثنائي كبير الحجم طبقات الوصول.

  • يمكنك زيادة معدل نقل عمليات النسخ عن طريق تعيين قيمة متغير البيئة AZCOPY_CONCURRENCY_VALUE. لمعرفة المزيد، راجع زيادة التزامن.

  • إذا كانت الكائنات الثنائية كبيرة الحجم المصدر تحتوي على علامات فهرس، وتريد الاحتفاظ بهذه العلامات، فسيتعين عليك إعادة تطبيقها على الكائنات الثنائية كبيرة الحجم الوجهة. للحصول على معلومات حول كيفية تعيين علامات الفهرس، راجع القسم نسخ الكائنات الثنائية كبيرة الحجم إلى حساب تخزين آخر باستخدام علامات الفهرس من هذه المقالة.

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

انسخ كائن ثنائي كبير الحجم إلى حساب تخزين آخر باستخدام أمر نسخ azcopy.

تلميح

يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

إعراب

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>'

مثال

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

مثال (نقاط نهاية Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'

تكون عملية النسخ متزامنة، لذلك عند عودة الأمر، يشير ذلك إلى أنه تم نسخ جميع الملفات.

نسخ دليل

انسخ دليل إلى حساب تخزين آخر باستخدام أمر نسخ azcopy.

تلميح

يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

إعراب

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

مثال

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

مثال (نقاط نهاية Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive

عملية النسخ متزامنة. تم نسخ كافة الملفات عند إرجاع الأمر.

نسخ حاوية

انسخ حاوية إلى حساب تخزين آخر باستخدام أمر نسخ azcopy.

تلميح

يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

إعراب

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

مثال

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

مثال (نقاط نهاية Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive

عملية النسخ متزامنة. تم نسخ كافة الملفات عند إرجاع الأمر.

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

انسخ كافة الحاويات والدلائل والكائنات الثنائية كبيرة الحجم إلى حساب تخزين آخر باستخدام الأمر azcopy copy.

تلميح

يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

إعراب

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/' --recursive

مثال

azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive

مثال (نقاط نهاية Data Lake Storage)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/' 'https://mydestinationaccount.dfs.core.windows.net' --recursive

تكون عملية النسخ متزامنة، لذلك عند عودة الأمر، يشير ذلك إلى أنه تم نسخ جميع الملفات.

نسخ الكائنات الثنائية كبيرة الحجم وإضافة علامات فهرس

انسخ الكائنات الثنائية كبيرة الحجم إلى حساب تخزين آخر وأضف علامات فهرس الكائنات الثنائية كبيرة الحجم إلى الكائن الثنائي كبير الحجم الهدف.

إذا كنت تستخدم تخويل Microsoft Entra، فيجب تعيين دور مالك بيانات كائن ثنائي كبير الحجم للتخزين، أو يجب منحه الإذن Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write لعملية موفر موارد Azure عبر دور Azure مخصص. إذا كنت تستخدم رمزًا مميزًا لتوقيع الوصول المشترك (SAS)، فيجب أن يوفر هذا الرمز المميز الوصول إلى علامات الكائن ثنائي الحجم عبر t إذن SAS.

لإضافة علامات، استخدم الخيار --blob-tags جنبًا إلى جنب مع زوج قيم مفتاح-قيمة مشفر لعنوان URL.

على سبيل المثال، لإضافة المفتاح my tag وقيمة my tag value، يمكنك إضافة --blob-tags='my%20tag=my%20tag%20value' إلى معلمة الوجهة.

افصل بين علامات الفهرس المتعددة باستخدام علامة العطف (&). على سبيل المثال، إذا كنت تريد إضافة مفتاح my second tag وقيمة my second tag value، فإن سلسلة الخيار الكاملة ستكون --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'.

توضح الأمثلة التالية كيفية استخدام الخيار--blob-tags.

تلميح

تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

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


azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

مثال على الدليل

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

مثال على الحاوية

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

مثال على الحساب

azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

عملية النسخ متزامنة. تم نسخ كافة الملفات عند إرجاع الأمر.

إشعار

إذا قمت بتحديد دليل أو حاوية أو حساب للمصدر، فستحتوي كل النقط الكبيرة التي يتم نسخها إلى الوجهة على نفس العلامات التي تحددها في الأمر.

نسخ مع أعلام اختيارية

يمكنك تعديل عملية النسخ باستخدام الأعلام الاختيارية. إليك بعض الأمثلة.

السيناريو العلامة
انسخ الكائنات الثنائية كبيرة الحجم ككتلة أو صفحة أو إلحاق الكائنات الثنائية كبيرة الحجم. --blob-type=[BlockBlob|PageBlob|AppendBlob]
انسخ إلى طبقة وصول محددة (مثل طبقة الأرشيف). - block-blob-tier = [لا شيء | ساخن | رائع | أرشيف]
فك ضغط الملفات تلقائيًا. --decompress=[gzip|deflate]

للحصول على قائمة كاملة، راجع الخيارات .

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

يمكنك العثور على مزيد من الأمثلة في هذه المقالات:

راجع هذه المقالات لتكوين الإعدادات وتحسين الأداء واستكشاف المشكلات وإصلاحها: