نقل البيانات باستخدام الإصدار 8.1 من AzCopy على Windows

  • مقالة
  • قراءة خلال 27 دقائق

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

هام

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

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

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

قم بتنزيل AzCopy (الإصدار 8.1) على Windows.

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

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

Azcopy مع دعم الجدول (v7.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

تنطبق البادئة على الدليل الظاهري ، الذي يشكل الجزء الأول من اسم blob. في المثال الموضح أعلاه ، لا يتطابق الدليل الظاهري مع البادئة المحددة ، لذلك لا يتم تنزيله. بالإضافة إلى ذلك ، إذا لم يتم تحديد الخيار /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

Upload النقط إلى تخزين النقطة

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

Upload نقطة واحدة

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

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

Upload نقطة واحدة إلى دليل ظاهري

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

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

Upload جميع النقاط في مجلد

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

Upload النقط مطابقة نمط معين

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 إلى تحميل محتويات الحاوية المحددة بشكل متكرر. راجع Upload جميع النقاط في مجلد لمزيد من المعلومات ومثال.

نسخ النقط بشكل متزامن من حساب تخزين إلى آخر

يقوم 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

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

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

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

Upload ملف واحد

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

Upload كافة الملفات الموجودة في مجلد

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

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

Upload الملفات التي تطابق نمطا معينا

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 خيار نسخ البيانات من تخزين الملفات إلى تخزين الملفات ، ومن تخزين الملفات إلى تخزين النقطة ، ومن تخزين النقطة إلى تخزين الملفات بشكل متزامن ، يقوم 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 ، يكون نوع blob الافتراضي هو كتلة blob ؛ يمكن للمستخدم تحديد خيار /BlobType:page تغيير نوع النقطة الوجهة.

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

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

دعونا نلقي نظرة على تصدير البيانات من تخزين 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 في حاوية blob مع اصطلاح التسمية التالي:

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

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

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

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

دعونا نلقي نظرة على استيراد البيانات إلى تخزين Azure Table باستخدام 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 و File ، فإن عدد العمليات المتزامنة يساوي 8 أضعاف عدد المعالجات لديك. إذا كنت تقوم بتشغيل AzCopy عبر شبكة ذات نطاق ترددي منخفض، فيمكنك تحديد رقم أقل ل /NC لتجنب الفشل الناجم عن منافسة الموارد.

تشغيل AzCopy مقابل محاكي تخزين Azure

يمكنك تشغيل 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

/المصدر:"المصدر"

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

ينطبق على: النقط، الملفات، الجداول

/Dest:"الوجهة"

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

ينطبق على: النقط، الملفات، الجداول

/نمط:"نمط الملف"

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

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

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

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

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

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

ينطبق على: النقط, الملفات

/DestKey:"مفتاح التخزين"

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

ينطبق على: النقط، الملفات، الجداول

/DestSAS:"sas-token"

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

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

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

ينطبق على: النقط، الملفات، الجداول

/SourceKey:"مفتاح التخزين"

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

ينطبق على: النقط، الملفات، الجداول

/SourceSAS:"sas-token"

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

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

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

ينطبق على: النقط، الملفات، الجداول

/S

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

ينطبق على: النقط, الملفات

/BlobType: | "كتلة" | "الصفحة" "إلحاق"

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

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

/تشيك إم دي5

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

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

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

ينطبق على: النقط, الملفات

/لقطة

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

تتم إعادة تسمية لقطات blob المنقولة بهذا التنسيق: اسم blob (وقت اللقطة).extension.

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

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

/V:[ملف سجل مطول]

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

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

ينطبق على: النقط، الملفات، الجداول

/Z:[دفتر اليومية-ملف-مجلد]

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

يدعم AzCopy دائما استئناف التشغيل في حالة مقاطعة عملية.

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

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

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

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

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

ينطبق على: النقط، الملفات، الجداول

/@:"ملف المعلمة"

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

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

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

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

ينطبق على: النقط، الملفات، الجداول

/Y

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

ينطبق على: النقط، الملفات، الجداول

/L

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

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

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

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

ينطبق على: النقط, الملفات

/MT

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

ينطبق على: النقط, الملفات

/XN

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

ينطبق على: النقط, الملفات

/XO

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

ينطبق على: النقط, الملفات

/أ

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

ينطبق على: النقط, الملفات

/IA:[راشنيتوي]

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

تتضمن السمات المتاحة ما يلي:

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

ينطبق على: النقط, الملفات

/XA:[راشنيتوي]

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

تتضمن السمات المتاحة ما يلي:

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

ينطبق على: النقط, الملفات

/محدد:"محدد"

يشير إلى حرف المحدد المستخدم لتحديد الدلائل الظاهرية في اسم نقطة.

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

ينطبق هذا الخيار فقط على تنزيل النقط.

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

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

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

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

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

ينطبق على: النقط، الملفات، الجداول

/SourceType:| "بلوب" "الجدول"

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

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

/DestType:| "بلوب" "الجدول"

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

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

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

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

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

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

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

[أأ ب ب)

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

ينطبق على: المناضد

/SplitSize:"حجم الملف"

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

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

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

ينطبق على: المناضد

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

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

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

ينطبق على: المناضد

/البيان:"ملف البيان"

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

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

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

ينطبق على: المناضد

/SyncCopy

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

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

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

ينطبق على: النقط, الملفات

/SetContentType:"نوع المحتوى"

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

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

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

ينطبق على: النقط, الملفات

/تنسيق الحمولة: | "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.
  • خطأ - يستخدم AzCopy خوارزمية MD5 متوافقة مع FIPS.

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

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

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

وثائق تخزين Azure:

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