Share via

نقل البيانات باستخدام AzCopy v8.1 على Windows

  • مقالة

AzCopy هي أداة مساعدة لسطر الأوامر مصممة لنسخ البيانات من/إلى تخزين Microsoft Azure Blob وFile وTable، باستخدام أوامر بسيطة مصممة لتحقيق الأداء الأمثل. يمكنك نسخ البيانات بين نظام الملفات وحساب التخزين، أو بين حسابات التخزين.

هام

توضح هذه المقالة إصدارا قديما من AzCopy. لتثبيت أحدث إصدار من AzCopy، راجع AzCopy v10.

إذا اخترت تثبيت الإصدار الأقدم من AzCopy (AzCopy v8.1)، فهناك إصدارات متعددة يمكنك تنزيلها. يوفر AzCopy على Windows خيارات سطر الأوامر بنمط Windows. يستهدف AzCopy على Linux أنظمة Linux الأساسية التي تقدم خيارات سطر الأوامر بنمط POSIX. تتناول هذه المقالة AzCopy على Windows.

تنزيل AzCopy (الإصدار 8.1) وتثبيته على Windows

قم بتنزيل AzCopy (v8.1) على Windows.

AzCopy على ملاحظات الإصدار Windows 8.1

  • لم تعد خدمة الجدول مدعومة في أحدث إصدار. إذا كنت تستخدم ميزة تصدير الجدول، فنزل إصدار AzCopy 7.3.
  • تم إنشاؤه باستخدام .NET Core 2.1، ويتم الآن حزم جميع تبعيات .NET Core في التثبيت.
  • تمت إضافة دعم مصادقة OAuth. استخدم azcopy login لتسجيل الدخول باستخدام Azure Active Directory.

Azcopy مع دعم الجدول (الإصدار 7.3)

قم بتنزيل AzCopy 7.3 مع دعم الجدول.

خطوة ما بعد التثبيت

بعد تثبيت AzCopy على Windows باستخدام المثبت، افتح نافذة أوامر وانتقل إلى دليل تثبيت AzCopy على جهاز الكمبيوتر الخاص بك - حيث AzCopy.exe يوجد الملف التنفيذي. إذا رغبت في ذلك، يمكنك إضافة موقع تثبيت AzCopy إلى مسار النظام الخاص بك. بشكل افتراضي، يتم تثبيت AzCopy على %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy أو %ProgramFiles%\Microsoft SDKs\Azure\AzCopy.

كتابة أول أمر AzCopy

بناء الجملة الأساسي لأوامر AzCopy هي:

AzCopy /Source:<source> /Dest:<destination> [Options]

توضح الأمثلة التالية مجموعة متنوعة من السيناريوهات لنسخ البيانات من وإلى Microsoft Azure Blobs والملفات والجداول. راجع قسم معلمات AzCopy للحصول على شرح مفصل للمعلمات المستخدمة في كل عينة.

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

لنلق نظرة على عدة طرق لتنزيل الكائنات الثنائية كبيرة الحجم باستخدام AzCopy.

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

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

لاحظ أنه إذا لم يكن المجلد C:\myfolder موجودا، يقوم AzCopy بإنشائه وتنزيله abc.txt في المجلد الجديد.

تنزيل كائن ثنائي كبير الحجم واحد من المنطقة الثانوية

AzCopy /Source:https://myaccount-secondary.blob.core.windows.net/mynewcontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

لاحظ أنه يجب تمكين التخزين المتكرر جغرافيا للوصول إلى القراءة للوصول إلى المنطقة الثانوية.

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

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /S

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

abc.txt
abc1.txt
abc2.txt
vd1\a.txt
vd1\abcd.txt

بعد عملية التنزيل، يتضمن الدليل C:\myfolder الملفات التالية:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\vd1\a.txt
C:\myfolder\vd1\abcd.txt

إذا لم تحدد الخيار /S، فلن يتم تنزيل أي كائنات ثنائية كبيرة الحجم.

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

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:a /S

افترض أن الكائنات الثنائية كبيرة الحجم التالية موجودة في الحاوية المحددة. يتم تنزيل جميع الكائنات الثنائية كبيرة الحجم التي تبدأ بالبادئة a :

abc.txt
abc1.txt
abc2.txt
xyz.txt
vd1\a.txt
vd1\abcd.txt

بعد عملية التنزيل، يتضمن المجلد C:\myfolder الملفات التالية:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

تنطبق البادئة على الدليل الظاهري، الذي يشكل الجزء الأول من اسم الكائن الثنائي كبير الحجم. في المثال الموضح أعلاه، لا يتطابق الدليل الظاهري مع البادئة المحددة، لذلك لا يتم تنزيله. بالإضافة إلى ذلك، إذا لم يتم تحديد الخيار /S ، لا يقوم AzCopy بتنزيل أي كائنات ثنائية كبيرة الحجم.

تعيين آخر وقت تم تعديله للملفات المصدرة ليكون نفس الكائنات الثنائية كبيرة الحجم المصدر

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT

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

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XN

إذا كنت تريد استبعاد الكائنات الثنائية كبيرة الحجم التي يكون آخر وقت تعديل لها هو نفسه أو أقدم من الملف الوجهة /XO ، فأضف الخيار :

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XO

تحميل الكائنات الثنائية كبيرة الحجم إلى موقع تخزين الكائنات الثنائية كبيرة الحجم

لنلق نظرة على عدة طرق لتحميل الكائنات الثنائية كبيرة الحجم باستخدام AzCopy.

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

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:"abc.txt"

إذا كانت حاوية الوجهة المحددة غير موجودة، يقوم AzCopy بإنشائها، وتحميل الملف فيها.

تحميل كائن ثنائي كبير الحجم واحد إلى دليل ظاهري

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer/vd /DestKey:key /Pattern:abc.txt

إذا لم يكن الدليل الظاهري المحدد موجودا، يقوم AzCopy بتحميل الملف لتضمين الدليل الظاهري في اسمه (على سبيل المثال، vd/abc.txt في المثال أعلاه).

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

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /S

يؤدي تحديد الخيار /S إلى تحميل محتويات الدليل المحدد إلى تخزين Blob بشكل متكرر، ما يعني أنه يتم تحميل جميع المجلدات الفرعية وملفاتها أيضا. على سبيل المثال، افترض أن الملفات التالية موجودة في المجلد C:\myfolder:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

بعد عملية التحميل، تتضمن الحاوية الملفات التالية:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

إذا لم تحدد الخيار /S، فلن يتم تحميل AzCopy بشكل متكرر. بعد عملية التحميل، تتضمن الحاوية الملفات التالية:

abc.txt
abc1.txt
abc2.txt

تحميل الكائنات الثنائية كبيرة الحجم المطابقة لنمط معين

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:a* /S

افترض أن الملفات التالية موجودة في المجلد C:\myfolder:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\xyz.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

بعد عملية التحميل، تتضمن الحاوية الملفات التالية:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

إذا لم تحدد الخيار /S، يقوم AzCopy فقط بتحميل الكائنات الثنائية كبيرة الحجم التي لا توجد في دليل ظاهري:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

تحديد نوع محتوى MIME للكائن الثنائي كبير الحجم الوجهة

بشكل افتراضي، يقوم AzCopy بتعيين نوع محتوى الكائن الثنائي كبير الحجم الوجهة إلى application/octet-stream. بدءا من الإصدار 3.1.0، يمكنك تحديد نوع المحتوى بشكل صريح عبر الخيار /SetContentType:[content-type]. يعين بناء الجملة هذا نوع المحتوى لجميع الكائنات الثنائية كبيرة الحجم في عملية التحميل.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType:video/mp4

إذا قمت بتحديد /SetContentType بدون قيمة، يقوم AzCopy بتعيين كل نوع محتوى كائن ثنائي كبير الحجم أو ملف وفقا لملحق الملف الخاص به.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType

نسخ الكائنات الثنائية كبيرة الحجم في تخزين Blob

لنلق نظرة على عدة طرق لنسخ الكائنات الثنائية كبيرة الحجم من موقع إلى آخر باستخدام AzCopy.

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

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceKey:key /DestKey:key /Pattern:abc.txt

عند نسخ كائن ثنائي كبير الحجم داخل حساب تخزين، يتم تنفيذ عملية نسخ من جانب الخادم .

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

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

عند نسخ كائن ثنائي كبير الحجم عبر حسابات التخزين، يتم تنفيذ عملية نسخ من جانب الخادم .

نسخ كائن ثنائي كبير الحجم واحد من المنطقة الثانوية إلى المنطقة الأساسية

AzCopy /Source:https://myaccount1-secondary.blob.core.windows.net/mynewcontainer1 /Dest:https://myaccount2.blob.core.windows.net/mynewcontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

لاحظ أنه يجب تمكين التخزين المتكرر جغرافيا للوصول إلى القراءة للوصول إلى التخزين الثانوي.

نسخ كائن ثنائي كبير الحجم واحد ولقطاته من حساب تخزين إلى آخر

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt /Snapshot

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

abc.txt
abc (2013-02-25 080757).txt
abc (2014-02-21 150331).txt

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

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 
/Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /S

يؤدي تحديد الخيار /S إلى تحميل محتويات الحاوية المحددة بشكل متكرر. راجع تحميل جميع الكائنات الثنائية كبيرة الحجم في مجلد للحصول على مزيد من المعلومات ومثال.

نسخ الكائنات الثنائية كبيرة الحجم بشكل متزامن من حساب تخزين إلى آخر

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

/SyncCopy يضمن الخيار أن عملية النسخ تحصل على سرعة متسقة. يقوم AzCopy بإجراء النسخة المتزامنة عن طريق تنزيل الكائنات الثنائية كبيرة الحجم للنسخ من المصدر المحدد إلى الذاكرة المحلية، ثم تحميلها إلى وجهة تخزين Blob.

AzCopy /Source:https://myaccount1.blob.core.windows.net/myContainer/ /Dest:https://myaccount2.blob.core.windows.net/myContainer/ /SourceKey:key1 /DestKey:key2 /Pattern:ab /SyncCopy

/SyncCopy قد تولد تكلفة خروج إضافية مقارنة بالنسخة غير المتزامنة، والنهج الموصى به هو استخدام هذا الخيار في جهاز Azure الظاهري الموجود في نفس منطقة حساب التخزين المصدر لتجنب تكلفة الخروج.

تنزيل الملفات من تخزين الملفات

لنلق نظرة على عدة طرق لتنزيل الملفات باستخدام AzCopy.

تنزيل ملف واحد

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/myfolder1/ /Dest:C:\myfolder /SourceKey:key /Pattern:abc.txt

إذا كان المصدر المحدد عبارة عن مشاركة ملف Azure، فيجب عليك إما تحديد اسم الملف الدقيق، (على سبيل المثالabc.txt) لتنزيل ملف واحد، أو تحديد خيار /S لتنزيل جميع الملفات في المشاركة بشكل متكرر. تؤدي محاولة تحديد نمط ملف وخيار /S معا إلى حدوث خطأ.

تنزيل جميع الملفات في دليل

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/ /Dest:C:\myfolder /SourceKey:key /S

لاحظ أنه لم يتم تنزيل المجلدات الفارغة.

تحميل الملفات إلى مشاركة ملف Azure

لنلق نظرة على عدة طرق لتحميل الملفات باستخدام AzCopy.

تحميل ملف واحد

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:abc.txt

تحميل كافة الملفات في مجلد

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /S

لاحظ أنه لا يتم تحميل المجلدات الفارغة.

تحميل الملفات المطابقة لنمط معين

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:ab* /S

نسخ الملفات في تخزين الملفات

لنلق نظرة على عدة طرق لنسخ الملفات في مشاركة ملف Azure باستخدام AzCopy.

نسخ من مشاركة ملف إلى آخر

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S

عند نسخ ملف عبر مشاركات الملفات، يتم تنفيذ عملية نسخ من جانب الخادم .

نسخ من مشاركة ملف Azure إلى تخزين Blob

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare/ /Dest:https://myaccount2.blob.core.windows.net/mycontainer/ /SourceKey:key1 /DestKey:key2 /S

عند نسخ ملف من مشاركة ملف إلى كائن ثنائي كبير الحجم، يتم تنفيذ عملية نسخ من جانب الخادم .

نسخ كائن ثنائي كبير الحجم من تخزين Blob إلى مشاركة ملف Azure

AzCopy /Source:https://myaccount1.blob.core.windows.net/mycontainer/ /Dest:https://myaccount2.file.core.windows.net/myfileshare/ /SourceKey:key1 /DestKey:key2 /S

عند نسخ ملف من كائن ثنائي كبير الحجم إلى مشاركة ملف، يتم تنفيذ عملية نسخ من جانب الخادم .

نسخ الملفات بشكل متزامن

يمكنك تحديد /SyncCopy خيار نسخ البيانات من File Storage إلى File Storage، ومن File Storage إلى Blob Storage ومن Blob Storage إلى File Storage بشكل متزامن، يقوم AzCopy بذلك عن طريق تنزيل البيانات المصدر إلى الذاكرة المحلية وتحميلها مرة أخرى إلى الوجهة. تنطبق تكلفة الخروج القياسية.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S /SyncCopy

عند النسخ من تخزين الملف إلى تخزين Blob، يكون نوع الكائن الثنائي كبير الحجم الافتراضي هو كائن ثنائي كبير الحجم للكتلة؛ يمكن للمستخدم تحديد خيار /BlobType:page تغيير نوع الكائن الثنائي كبير الحجم الوجهة.

لاحظ أن /SyncCopy قد يولد تكاليف خروج إضافية مقارنة بالنسخة غير المتزامنة. النهج الموصى به هو استخدام هذا الخيار في جهاز Azure الظاهري الموجود في نفس المنطقة مثل حساب التخزين المصدر لتجنب تكلفة الخروج.

تصدير البيانات من تخزين الجدول

دعونا نلقي نظرة على تصدير البيانات من تخزين Azure Table باستخدام AzCopy.

تصدير جدول

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key

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

<account name>_<table name>_<timestamp>.manifest

يمكن للمستخدم أيضا تحديد خيار /Manifest:<manifest file name> تعيين اسم ملف البيان.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /Manifest:abc.manifest

تقسيم تصدير من تخزين الجدول إلى ملفات متعددة

AzCopy /Source:https://myaccount.table.core.windows.net/mytable/ /Dest:C:\myfolder /SourceKey:key /S /SplitSize:100

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

فهرس نطاق مفتاح القسم هو 0 إذا لم يحدد المستخدم الخيار /PKRS.

على سبيل المثال، افترض أن AzCopy ينشئ ملفي بيانات بعد أن يحدد المستخدم الخيار /SplitSize. قد تكون أسماء ملفات البيانات الناتجة:

myaccount_mytable_20140903T051850.8128447Z_0_0_C3040FE8.json
myaccount_mytable_20140903T051850.8128447Z_0_1_0AB9AC20.json

لاحظ أن الحد الأدنى للقيمة الممكنة للخيار /SplitSize هو 32 ميغابايت. إذا كانت الوجهة المحددة هي تخزين Blob، يقوم AzCopy بتقسيم ملف البيانات بمجرد أن تصل أحجامه إلى حد حجم الكائن الثنائي كبير الحجم (200 غيغابايت)، بغض النظر عما إذا كان المستخدم قد حدد الخيار /SplitSize أم لا.

تصدير جدول إلى تنسيق ملف بيانات JSON أو CSV

بشكل افتراضي، يقوم AzCopy بتصدير الجداول إلى ملفات بيانات JSON. يمكنك تحديد خيار /PayloadFormat:JSON|CSV تصدير الجداول ك JSON أو CSV.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PayloadFormat:CSV

عند تحديد تنسيق حمولة CSV، يقوم AzCopy أيضا بإنشاء ملف مخطط مع ملحق .schema.csv ملف لكل ملف بيانات.

تصدير كيانات الجدول بشكل متزامن

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PKRS:"aa#bb"

يبدأ AzCopy العمليات المتزامنة لتصدير الكيانات عندما يحدد المستخدم الخيار /PKRS. تصدر كل عملية نطاق مفتاح قسم واحد.

لاحظ أن عدد العمليات المتزامنة يتم التحكم فيه أيضا بواسطة الخيار /NC. يستخدم AzCopy عدد المعالجات الأساسية كقيمة افتراضية /NC عند نسخ كيانات الجدول، حتى إذا /NC لم يتم تحديدها. عندما يحدد المستخدم الخيار /PKRS، يستخدم AzCopy أصغر القيمتين - نطاقات مفاتيح القسم مقابل العمليات المتزامنة المحددة ضمنيا أو صريحا - لتحديد عدد العمليات المتزامنة التي يجب بدء تشغيلها. لمزيد من التفاصيل، اكتب AzCopy /?:NC في سطر الأوامر.

تصدير جدول إلى تخزين Blob

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:https://myaccount.blob.core.windows.net/mycontainer/ /SourceKey:key1 /Destkey:key2

ينشئ AzCopy ملف بيانات JSON في حاوية الكائن الثنائي كبير الحجم مع اصطلاح التسمية التالي:

<account name>_<table name>_<timestamp>_<volume index>_<CRC>.json

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

لاحظ أنه عند تصدير الجداول إلى الكائنات الثنائية كبيرة الحجم، يقوم AzCopy بتنزيل كيانات الجدول إلى ملفات البيانات المؤقتة المحلية ثم يقوم بتحميل هذه الكيانات إلى الكائن الثنائي كبير الحجم. يتم وضع ملفات البيانات المؤقتة هذه في مجلد ملف دفتر اليومية مع المسار الافتراضي "%LocalAppData%\Microsoft\Azure\AzCopy"، يمكنك تحديد الخيار /Z:[journal-file-folder] لتغيير موقع مجلد ملف دفتر اليومية وبالتالي تغيير موقع ملفات البيانات المؤقتة. يتم تحديد حجم ملفات البيانات المؤقتة حسب حجم كيانات الجدول والحجم الذي حددته باستخدام الخيار /SplitSize، على الرغم من حذف ملف البيانات المؤقت في القرص المحلي على الفور بمجرد تحميله إلى الكائن الثنائي كبير الحجم، يرجى التأكد من أن لديك مساحة كافية على القرص المحلي لتخزين ملفات البيانات المؤقتة هذه قبل حذفها.

استيراد البيانات إلى تخزين الجدول

دعونا نلقي نظرة على استيراد البيانات إلى تخزين جدول Azure باستخدام AzCopy.

استيراد جدول

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.core.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace

يشير الخيار /EntityOperation إلى كيفية إدراج كيانات في الجدول. القيم الممكنة هي:

  • InsertOrSkip: يتخطى كيانا موجودا أو يدرج كيانا جديدا إذا لم يكن موجودا في الجدول.
  • InsertOrMerge: يدمج كيانا موجودا أو يدرج كيانا جديدا إذا لم يكن موجودا في الجدول.
  • InsertOrReplace: يستبدل كيانا موجودا أو يدرج كيانا جديدا إذا لم يكن موجودا في الجدول.

لاحظ أنه لا يمكنك تحديد خيار /PKRS في سيناريو الاستيراد. على عكس سيناريو التصدير، حيث يجب تحديد خيار /PKRS لبدء العمليات المتزامنة، يبدأ AzCopy العمليات المتزامنة بشكل افتراضي عند استيراد جدول. العدد الافتراضي للعمليات المتزامنة التي بدأت يساوي عدد المعالجات الأساسية؛ ومع ذلك، يمكنك تحديد عدد مختلف من المتزامنة مع الخيار /NC. لمزيد من التفاصيل، اكتب AzCopy /?:NC في سطر الأوامر.

لاحظ أن AzCopy يدعم الاستيراد فقط ل JSON، وليس CSV. لا يدعم AzCopy عمليات استيراد الجدول من JSON التي أنشأها المستخدم وملفات البيان. يجب أن يأتي كلا الملفين من تصدير جدول AzCopy. لتجنب الأخطاء، يرجى عدم تعديل ملف JSON أو البيان الذي تم تصديره.

استيراد الكيانات إلى جدول من تخزين Blob

افترض أن حاوية Blob تحتوي على ما يلي: ملف JSON يمثل جدول Azure وملف البيان المصاحب له.

myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json

يمكنك تشغيل الأمر التالي لاستيراد الكيانات إلى جدول باستخدام ملف البيان في حاوية الكائن الثنائي كبير الحجم هذه:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:https://myaccount.table.core.windows.net/mytable /SourceKey:key1 /DestKey:key2 /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:"InsertOrReplace"

ميزات AzCopy الأخرى

دعونا نلقي نظرة على بعض ميزات AzCopy الأخرى.

نسخ البيانات غير الموجودة في الوجهة فقط

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

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /XO /XN

/Source:C:\myfolder /Dest:http://myaccount.file.core.windows.net/myfileshare /DestKey:<destkey> /S /XO /XN

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:http://myaccount.blob.core.windows.net/mycontainer1 /SourceKey:<sourcekey> /DestKey:<destkey> /S /XO /XN

لاحظ أن هذا غير معتمد عندما يكون المصدر أو الوجهة جدولا.

استخدام ملف استجابة لتحديد معلمات سطر الأوامر

AzCopy /@:"C:\responsefiles\copyoperation.txt"

يمكنك تضمين أي معلمات سطر أوامر AzCopy في ملف استجابة. يعالج AzCopy المعلمات في الملف كما لو كانت محددة في سطر الأوامر، وإجراء استبدال مباشر بمحتويات الملف.

افترض ملف استجابة يسمى copyoperation.txt، يحتوي على الأسطر التالية. يمكن تحديد كل معلمة AzCopy على سطر واحد

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

أو على أسطر منفصلة:

/Source:http://myaccount.blob.core.windows.net/mycontainer
/Dest:C:\myfolder
/SourceKey:<sourcekey>
/S
/Y

يفشل AzCopy إذا قمت بتقسيم المعلمة عبر سطرين، كما هو موضح هنا للمعلمة /sourcekey :

http://myaccount.blob.core.windows.net/mycontainer
 C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y

استخدام ملفات استجابة متعددة لتحديد معلمات سطر الأوامر

افترض ملف استجابة يسمى source.txt يحدد حاوية مصدر:

/Source:http://myaccount.blob.core.windows.net/mycontainer

وملف استجابة يسمى dest.txt يحدد مجلد وجهة في نظام الملفات:

/Dest:C:\myfolder

وملف استجابة يسمى options.txt يحدد خيارات AzCopy:

/S /Y

لاستدعاء AzCopy مع ملفات الاستجابة هذه، وكلها موجودة في دليل C:\responsefiles، استخدم هذا الأمر:

AzCopy /@:"C:\responsefiles\source.txt" /@:"C:\responsefiles\dest.txt" /SourceKey:<sourcekey> /@:"C:\responsefiles\options.txt"

يعالج AzCopy هذا الأمر تماما كما لو قمت بإدراج جميع المعلمات الفردية في سطر الأوامر:

AzCopy /Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

تحديد توقيع وصول مشترك (SAS)

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceSAS:SAS1 /DestSAS:SAS2 /Pattern:abc.txt

يمكنك أيضا تحديد SAS على URI للحاوية:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1/?SourceSASToken /Dest:C:\myfolder /S

مجلد ملف دفتر اليومية

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

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

إذا كنت تريد استخدام الموقع الافتراضي لملف دفتر اليومية:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z

إذا حذفت خيار /Z، أو حددت خيارا /Z بدون مسار المجلد، كما هو موضح أعلاه، يقوم AzCopy بإنشاء ملف دفتر اليومية في الموقع الافتراضي، وهو %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy. إذا كان ملف دفتر اليومية موجودا بالفعل، فسيستأنف AzCopy العملية استنادا إلى ملف دفتر اليومية.

إذا كنت تريد تحديد موقع مخصص لملف دفتر اليومية:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z:C:\journalfolder\

ينشئ هذا المثال ملف دفتر اليومية إذا لم يكن موجودا بالفعل. إذا كان موجودا، فسيستأنف AzCopy العملية استنادا إلى ملف دفتر اليومية.

إذا كنت ترغب في استئناف عملية AzCopy:

AzCopy /Z:C:\journalfolder\

يستأنف هذا المثال العملية الأخيرة، والتي ربما فشلت في إكمالها.

إنشاء ملف سجل

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V

إذا قمت بتحديد خيار /V دون توفير مسار ملف إلى السجل المطول، فسينشئ AzCopy ملف السجل في الموقع الافتراضي، وهو %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy.

وإلا، يمكنك إنشاء ملف سجل في موقع مخصص:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V:C:\myfolder\azcopy1.log

لاحظ أنه إذا حددت مسارا نسبيا بعد الخيار /V، مثل /V:test/azcopy1.log، فسيتم إنشاء السجل المطول في دليل العمل الحالي داخل مجلد فرعي يسمى test.

تحديد عدد العمليات المتزامنة للبدء

يحدد الخيار /NC عدد عمليات النسخ المتزامنة. بشكل افتراضي، يبدأ AzCopy عددا معينا من العمليات المتزامنة لزيادة معدل نقل البيانات. بالنسبة لعمليات الجدول، يكون عدد العمليات المتزامنة مساويا لعدد المعالجات لديك. بالنسبة لعمليات Blob وFily، فإن عدد العمليات المتزامنة يساوي 8 أضعاف عدد المعالجات لديك. إذا كنت تقوم بتشغيل AzCopy عبر شبكة ذات نطاق ترددي منخفض، يمكنك تحديد رقم أقل ل /NC لتجنب الفشل الناجم عن منافسة الموارد.

تشغيل AzCopy مقابل Azure Storage Emulator

يمكنك تشغيل AzCopy مقابل محاكي تخزين Azure للكائنات الثنائية كبيرة الحجم:

AzCopy /Source:https://127.0.0.1:10000/myaccount/mycontainer/ /Dest:C:\myfolder /SourceKey:key /SourceType:Blob /S

يمكنك أيضا تشغيله للجداول:

AzCopy /Source:https://127.0.0.1:10002/myaccount/mytable/ /Dest:C:\myfolder /SourceKey:key /SourceType:Table

تحديد نوع المحتوى لكائن ثنائي كبير الحجم تلقائيا

يحدد AzCopy نوع محتوى كائن ثنائي كبير الحجم استنادا إلى ملف JSON الذي يخزن نوع المحتوى لتعيين ملحق الملف. يسمى ملف JSON هذا AzCopyConfig.json، وهو موجود في دليل AzCopy. إذا كان لديك نوع ملف غير موجود في القائمة، يمكنك إلحاق التعيين بملف JSON:

{
  "MIMETypeMapping": {
    ".myext": "text/mycustomtype",
    .
    .
  }
}

معلمات AzCopy

يتم وصف معلمات AzCopy أدناه. يمكنك أيضا كتابة أحد الأوامر التالية من سطر الأوامر للمساعدة في استخدام AzCopy:

  • للحصول على تعليمات مفصلة حول سطر الأوامر ل AzCopy: AzCopy /?
  • للحصول على تعليمات مفصلة حول أي معلمة AzCopy: AzCopy /?:SourceKey
  • للحصول على أمثلة سطر الأوامر: AzCopy /?:Sample

/Source:"source"

يحدد البيانات المصدر التي سيتم النسخ منها. يمكن أن يكون المصدر دليلا لنظام الملفات أو حاوية كائن ثنائي كبير الحجم أو دليل ظاهري لكائن ثنائي كبير الحجم أو مشاركة ملف تخزين أو دليل ملف تخزين أو جدول Azure.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/Dest:"الوجهة"

يحدد الوجهة المراد النسخ إليها. يمكن أن تكون الوجهة دليلا لنظام الملفات أو حاوية كائن ثنائي كبير الحجم أو دليل ظاهري لكائن ثنائي كبير الحجم أو مشاركة ملف تخزين أو دليل ملف تخزين أو جدول Azure.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/Pattern:"file-pattern"

يحدد نمط ملف يشير إلى الملفات المراد نسخها. يتم تحديد سلوك المعلمة /Pattern من خلال موقع البيانات المصدر ووجود خيار الوضع المتكرر. يتم تحديد الوضع المتكرر عبر الخيار /S.

إذا كان المصدر المحدد دليلا في نظام الملفات، فإن أحرف البدل القياسية سارية المفعول، ويتم مطابقة نمط الملف المقدم مقابل الملفات داخل الدليل. إذا تم تحديد الخيار /S، فإن AzCopy يطابق أيضا النمط المحدد مقابل جميع الملفات في أي مجلدات فرعية أسفل الدليل.

إذا كان المصدر المحدد عبارة عن حاوية كائن ثنائي كبير الحجم أو دليل ظاهري، فلن يتم تطبيق أحرف البدل. إذا تم تحديد الخيار /S، فإن AzCopy يفسر نمط الملف المحدد كبادئة كائن ثنائي كبير الحجم. إذا لم يتم تحديد الخيار /S، فإن AzCopy يطابق نمط الملف مع أسماء الكائنات الثنائية كبيرة الحجم الدقيقة.

إذا كان المصدر المحدد عبارة عن مشاركة ملف Azure، فيجب عليك إما تحديد اسم الملف الدقيق، (على سبيل المثال، abc.txt) لنسخ ملف واحد، أو تحديد الخيار /S لنسخ جميع الملفات في المشاركة بشكل متكرر. تؤدي محاولة تحديد نمط ملف وخيار /S معا إلى حدوث خطأ.

يستخدم AzCopy المطابقة الحساسة لحالة الأحرف عندما يكون /Source عبارة عن حاوية كائن ثنائي كبير الحجم أو دليل ظاهري لكائن ثنائي كبير الحجم، ويستخدم المطابقة غير الحساسة لحالة الأحرف في جميع الحالات الأخرى.

نمط الملف الافتراضي المستخدم عند عدم تحديد نمط ملف هو . لموقع نظام الملفات أو بادئة فارغة لموقع تخزين Azure. تحديد أنماط ملفات متعددة غير مدعوم.

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/DestKey:"storage-key"

يحدد مفتاح حساب التخزين للمورد الوجهة.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/DestSAS:"sas-token"

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

إذا كان المورد الوجهة عبارة عن حاوية كائن ثنائي كبير الحجم أو مشاركة ملف أو جدول، يمكنك إما تحديد هذا الخيار متبوعا بالرمز المميز SAS، أو يمكنك تحديد SAS كجزء من حاوية الكائن الثنائي كبير الحجم الوجهة أو مشاركة الملف أو عنوان URI للجدول، دون هذا الخيار.

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

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/SourceKey:"storage-key"

يحدد مفتاح حساب التخزين للمورد المصدر.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/SourceSAS:"sas-token"

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

إذا كان المورد المصدر عبارة عن حاوية كائن ثنائي كبير الحجم، ولم يتم توفير مفتاح أو SAS، تتم قراءة حاوية الكائن الثنائي كبير الحجم عبر وصول مجهول.

إذا كان المصدر عبارة عن مشاركة ملف أو جدول، فيجب توفير مفتاح أو SAS.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/S

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

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/BlobType:"block" | "page" | "إلحاق"

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

ينطبق على: النقط

/CheckMD5

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

لاحظ أن Azure Storage لا يضمن تحديث تجزئة MD5 المخزنة للكائن الثنائي كبير الحجم أو الملف. تقع على عاتق العميل مسؤولية تحديث MD5 كلما تم تعديل الكائن الثنائي كبير الحجم أو الملف. في حالة صور القرص (الأقراص المدارة أو غير المدارة)، لا تقوم أجهزة Azure الظاهرية بتحديث قيمة MD5 مع تغيير محتويات القرص، ومن ثم سيطرح /CheckMD5 خطأ عند تنزيل صور القرص.

يقوم AzCopy v8 دائما بتعيين الخاصية Content-MD5 لكائن ثنائي كبير الحجم Azure أو ملف بعد تحميله إلى الخدمة.

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/لقطه

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

تتم إعادة تسمية لقطات الكائن الثنائي كبير الحجم المنقولة بهذا التنسيق: blob-name (snapshot-time).extension

بشكل افتراضي، لا يتم نسخ اللقطات.

ينطبق على: النقط

/V:[verbose-log-file]

إخراج رسائل الحالة المطولة في ملف سجل.

بشكل افتراضي، يسمى ملف السجل المطول AzCopyVerbose.log في %LocalAppData%\Microsoft\Azure\AzCopy. إذا قمت بتحديد موقع ملف موجود لهذا الخيار، يتم إلحاق السجل المطول بهذا الملف.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/Z:[journal-file-folder]

تحديد مجلد ملف دفتر يومية لاستئناف عملية.

يدعم AzCopy دائما الاستئناف إذا تمت مقاطعة عملية.

إذا لم يتم تحديد هذا الخيار، أو تم تحديده بدون مسار مجلد، فسينشئ AzCopy ملف دفتر اليومية في الموقع الافتراضي، وهو ٪LocalAppData٪\Microsoft\Azure\AzCopy.

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

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

يتم حذف ملف دفتر اليومية عند الانتهاء بنجاح من العملية.

لاحظ أن استئناف عملية من ملف دفتر يومية تم إنشاؤه بواسطة إصدار سابق من AzCopy غير مدعوم.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/@:"parameter-file"

يحدد ملفا يحتوي على معلمات. يعالج AzCopy المعلمات في الملف تماما كما لو تم تحديدها على سطر الأوامر.

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

يمكن أن تتضمن ملفات الاستجابة أسطر تعليقات تبدأ برمز #.

يمكنك تحديد ملفات استجابة متعددة. ومع ذلك، لاحظ أن AzCopy لا يدعم ملفات الاستجابة المتداخلة.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/Y

يمنع جميع مطالبات تأكيد AzCopy. يسمح هذا الخيار أيضا باستخدام رموز SAS المميزة للكتابة فقط لسيناريوهات تحميل البيانات، عندما لا يتم تحديد /XO و/XN.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/L

يحدد عملية إدخال بيانات فقط؛ لا يتم نسخ أي بيانات.

يفسر AzCopy استخدام هذا الخيار كمحاكاة لتشغيل سطر الأوامر دون هذا الخيار /L ويحسب عدد الكائنات التي يتم نسخها، يمكنك تحديد الخيار /V في نفس الوقت للتحقق من العناصر التي يتم نسخها في السجل المطول.

يتم تحديد سلوك هذا الخيار أيضا من خلال موقع البيانات المصدر ووجود خيار الوضع المتكرر /S وخيار نمط الملف /Pattern.

يتطلب AzCopy إذن LIST و READ لموقع المصدر هذا عند استخدام هذا الخيار.

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/MT

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

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/XN

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

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/Xo

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

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/A

تحميل الملفات التي تحتوي على مجموعة سمات الأرشيف فقط.

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/IA:[RASHCNETOI]

تحميل الملفات التي تحتوي على أي من السمات المحددة فقط.

تتضمن السمات المتوفرة ما يلي:

  • R = ملفات للقراءة فقط
  • A = ملفات جاهزة للأرشفة
  • S = ملفات النظام
  • H = ملفات مخفية
  • C = ملفات مضغوطة
  • N = الملفات العادية
  • E = الملفات المشفرة
  • T = الملفات المؤقتة
  • O = ملفات غير متصلة
  • I = الملفات غير المفهرسة

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/XA:[RASHCNETOI]

استبعاد الملفات التي تحتوي على أي من السمات المحددة.

تتضمن السمات المتوفرة ما يلي:

  • R = ملفات للقراءة فقط
  • A = ملفات جاهزة للأرشفة
  • S = ملفات النظام
  • H = ملفات مخفية
  • C = ملفات مضغوطة
  • N = الملفات العادية
  • E = الملفات المشفرة
  • T = الملفات المؤقتة
  • O = ملفات غير متصلة
  • I = الملفات غير المفهرسة

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/Delimiter:"المحدد"

يشير إلى حرف المحدد المستخدم لتحديد الدلائل الظاهرية في اسم كائن ثنائي كبير الحجم.

بشكل افتراضي، يستخدم AzCopy / كحرف محدد. ومع ذلك، يدعم AzCopy استخدام أي حرف شائع (مثل @أو #أو ٪) كمحدد. إذا كنت بحاجة إلى تضمين أحد هذه الأحرف الخاصة في سطر الأوامر، فقم بإحاطة اسم الملف بعلامات اقتباس مزدوجة.

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

ينطبق على: النقط

/NC:"عدد العمليات المتزامنة"

يحدد عدد العمليات المتزامنة.

يبدأ AzCopy بشكل افتراضي عددا معينا من العمليات المتزامنة لزيادة معدل نقل البيانات. لاحظ أن عددا كبيرا من العمليات المتزامنة في بيئة عرض النطاق الترددي المنخفض قد تطغى على اتصال الشبكة وتمنع العمليات من الإكمال الكامل. تقييد العمليات المتزامنة استنادا إلى النطاق الترددي الفعلي المتاح للشبكة.

الحد الأعلى للعمليات المتزامنة هو 512.

ينطبق على: الكائنات الثنائية كبيرة الحجم والملفات والجداول

/SourceType:"Blob" | "جدول"

يحدد أن source المورد هو كائن ثنائي كبير الحجم متوفر في بيئة التطوير المحلية، يعمل في محاكي التخزين.

ينطبق على: الكائنات الثنائية كبيرة الحجم والجداول

/DestType:"Blob" | "جدول"

يحدد أن destination المورد هو كائن ثنائي كبير الحجم متوفر في بيئة التطوير المحلية، يعمل في محاكي التخزين.

ينطبق على: الكائنات الثنائية كبيرة الحجم والجداول

/PKRS:"key1#key2#key3#..."

تقسيم نطاق مفتاح القسم لتمكين تصدير بيانات الجدول بالتوازي، ما يزيد من سرعة عملية التصدير.

إذا لم يتم تحديد هذا الخيار، فإن AzCopy يستخدم مؤشر ترابط واحد لتصدير كيانات الجدول. على سبيل المثال، إذا حدد المستخدم /PKRS:"aa#bb"، فسيبدأ AzCopy ثلاث عمليات متزامنة.

تصدر كل عملية أحد نطاقات مفاتيح الأقسام الثلاثة، كما هو موضح أدناه:

[مفتاح القسم الأول، aa)

[aa, bb)

[bb، مفتاح القسم الأخير]

ينطبق على: الجداول

/SplitSize:"file-size"

يحدد حجم تقسيم الملف المصدر بالميغابايت، والحد الأدنى المسموح به هو 32.

إذا لم يتم تحديد هذا الخيار، يقوم AzCopy بتصدير بيانات الجدول إلى ملف واحد.

إذا تم تصدير بيانات الجدول إلى كائن ثنائي كبير الحجم، ووصل حجم الملف المصدر إلى حد 200 غيغابايت لحجم الكائن الثنائي كبير الحجم، فإن AzCopy يقسم الملف الذي تم تصديره، حتى إذا لم يتم تحديد هذا الخيار.

ينطبق على: الجداول

/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"

يحدد سلوك استيراد بيانات الجدول.

  • InsertOrSkip - يتخطى كيانا موجودا أو يدرج كيانا جديدا إذا لم يكن موجودا في الجدول.
  • InsertOrMerge - يدمج كيانا موجودا أو يدرج كيانا جديدا إذا لم يكن موجودا في الجدول.
  • InsertOrReplace - يستبدل كيانا موجودا أو يدرج كيانا جديدا إذا لم يكن موجودا في الجدول.

ينطبق على: الجداول

/Manifest:"manifest-file"

يحدد ملف البيان لعملية تصدير الجدول واستيراده.

هذا الخيار اختياري أثناء عملية التصدير، ينشئ AzCopy ملف بيان باسم محدد مسبقا إذا لم يتم تحديد هذا الخيار.

هذا الخيار مطلوب أثناء عملية الاستيراد لتحديد موقع ملفات البيانات.

ينطبق على: الجداول

/SyncCopy

يشير إلى ما إذا كنت تريد نسخ الكائنات الثنائية كبيرة الحجم أو الملفات بشكل متزامن بين نقطتي نهاية Azure Storage.

يستخدم AzCopy بشكل افتراضي نسخة غير متزامنة من جانب الخادم. حدد هذا الخيار لإجراء نسخة متزامنة، والتي تقوم بتنزيل الكائنات الثنائية كبيرة الحجم أو الملفات إلى الذاكرة المحلية ثم تحميلها إلى Azure Storage.

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

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/SetContentType:"content-type"

يحدد نوع محتوى MIME للكائنات الثنائية كبيرة الحجم الوجهة أو الملفات.

يقوم AzCopy بتعيين نوع المحتوى لكائن ثنائي كبير الحجم أو ملف إلى application/octet-stream بشكل افتراضي. يمكنك تعيين نوع المحتوى لكافة الكائنات الثنائية كبيرة الحجم أو الملفات عن طريق تحديد قيمة لهذا الخيار بشكل صريح.

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

ينطبق على: الكائنات الثنائية كبيرة الحجم، الملفات

/PayloadFormat:"JSON" | "CSV"

يحدد تنسيق ملف البيانات المصدر للجدول.

إذا لم يتم تحديد هذا الخيار، يقوم AzCopy بشكل افتراضي بتصدير ملف بيانات الجدول بتنسيق JSON.

ينطبق على: الجداول

المشاكل المعروفة وأفضل الممارسات

دعونا نلقي نظرة على بعض المشكلات المعروفة وأفضل الممارسات.

الحد من عمليات الكتابة المتزامنة أثناء نسخ البيانات

عند نسخ الكائنات الثنائية كبيرة الحجم أو الملفات باستخدام AzCopy، ضع في اعتبارك أن تطبيقا آخر قد يقوم بتعديل البيانات أثناء نسخها. إذا كان ذلك ممكنا، فتأكد من عدم تعديل البيانات التي تقوم بنسخها أثناء عملية النسخ. على سبيل المثال، عند نسخ VHD مقترن بجهاز ظاهري Azure، تأكد من عدم كتابة أي تطبيقات أخرى حاليا إلى VHD. طريقة جيدة للقيام بذلك هي عن طريق تأجير المورد المراد نسخه. بدلا من ذلك، يمكنك إنشاء لقطة من VHD أولا ثم نسخ اللقطة.

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

تمكين خوارزميات MD5 المتوافقة مع FIPS ل AzCopy عند "استخدام خوارزميات متوافقة مع FIPS للتشفير والتجزئة والتوقيع."

يستخدم AzCopy بشكل افتراضي تنفيذ .NET MD5 لحساب MD5 عند نسخ الكائنات، ولكن هناك بعض متطلبات الأمان التي تحتاج إلى AzCopy لتمكين إعداد MD5 المتوافق مع FIPS.

يمكنك إنشاء ملف AzCopy.exe.config app.config مع خاصية AzureStorageUseV1MD5 ووضعه جانبا مع AzCopy.exe.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="AzureStorageUseV1MD5" value="false"/>
  </appSettings>
</configuration>

للخاصية "AzureStorageUseV1MD5":

  • True - القيمة الافتراضية، يستخدم AzCopy تنفيذ .NET MD5.
  • False – يستخدم AzCopy خوارزمية MD5 المتوافقة مع FIPS.

يتم تعطيل الخوارزميات المتوافقة مع FIPS بشكل افتراضي على Windows. يمكنك تغيير إعداد النهج هذا على جهازك. في نافذة Run (Windows+R)، اكتب secpol.msc لفتح نافذة نهج الأمان المحلي . في نافذة Security Settings ، انتقل إلى Security Settings>Local Policies>Security Options. حدد موقع تشفير النظام: استخدم الخوارزميات المتوافقة مع FIPS لنهج التشفير والتجزئة والتوقيع . انقر نقرا مزدوجا فوق النهج لمشاهدة القيمة المعروضة في عمود إعداد الأمان .

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

لمزيد من المعلومات حول Azure Storage وAzCopy، راجع الموارد التالية:

وثائق Azure Storage:

منشورات مدونة Azure Storage: