إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يمكنك استخدام الأداة المساعدة لسطر الأوامر AzCopy v10 لنسخ الكائنات الثنائية كبيرة الحجم والدلائل والحاويات بين حسابات التخزين.
للحصول على أمثلة لأنواع أخرى من المهام، مثل تحميل الملفات وتنزيل الكائنات الثنائية كبيرة الحجم والمزامنة مع تخزين الكائن الثنائي كبير الحجم، راجع الارتباطات الموجودة في قسم الخطوات التالية في هذه المقالة.
يستخدم 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، فقم بتعيين دور مالك بيانات Storage Blob إلى كيان الأمان الخاص بك، أو امنحه إذنا لعملية 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] |
للحصول على قائمة كاملة، راجع الخيارات .
تحديد أنواع المصدر والوجهة
يستخدم AzCopy المعلمة --from-to لتحديد أنواع موارد المصدر والوجهة بشكل صريح عندما يفشل الاكتشاف التلقائي، كما هو الحال في سيناريوهات الأنابيب أو المحاكيات. تساعد هذه المعلمة AzCopy على فهم سياق النقل والتحسين وفقا لذلك.
| من إلى قيمة | الوصف |
|---|---|
BlobBlob |
النسخ بين موقعين لتخزين Azure Blob |
BlobBlobFS |
نسخ من Azure Blob Storage إلى Azure Data Lake Gen2 (BlobFS) |
BlobFSBlob |
نسخ من Azure Data Lake Gen2 (BlobFS) إلى Azure Blob Storage |
BlobFSBlobFS |
النسخ بين موقعين Azure Data Lake Gen2 (BlobFS) |
BlobFSFile |
نسخ من Azure Data Lake Gen2 (BlobFS) إلى Azure File Storage |
BlobFile |
نسخ من Azure Blob Storage إلى Azure File Storage |
FileBlob |
نسخ من Azure File Storage إلى Azure Blob Storage |
FileBlobFS |
نسخ من Azure File Storage إلى Azure Data Lake Gen2 (BlobFS) |
الخطوات التالية
يمكنك العثور على مزيد من الأمثلة في هذه المقالات:
- أمثلة: تحميل
- أمثلة: تنزيل
- أمثلة: مزامنة
- أمثلة: مستودعات Amazon S3
- أمثلة: Google Cloud Storage
- أمثلة: ملفات Azure
راجع هذه المقالات لتكوين الإعدادات وتحسين الأداء واستكشاف المشكلات وإصلاحها: