azcopy sync

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

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

الملخص

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

الأزواج المدعومة هي:

  • Local <-> Azure Blob (يمكن استخدام مصادقة SAS أو OAuth)
  • Azure Blob <-> Azure Blob (يجب أن يتضمن المصدر SAS أو يمكن الوصول إليه بشكل عام، يمكن استخدام مصادقة SAS أو OAuth للوجهة)
  • Azure File <-> Azure File (يجب أن يتضمن المصدر SAS أو يمكن الوصول إليه بشكل عام، يجب استخدام مصادقة SAS للوجهة)
  • Local <-> Azure File
  • Azure Blob <-> Azure File

يختلف أمر المزامنة عن أمر النسخ بعدة طرق:

  1. بشكل افتراضي، تكون العلامة المتكررة صحيحة وتُزامن نسخ جميع الدلائل الفرعية. تنسخ المزامنة ملفات المستوى الأعلى داخل الدليل فقط إذا كانت العلامة المتكررة خاطئة.
  2. عند المزامنة بين الدلائل الافتراضية، أضف شرطة مائلة لاحقة إلى المسار (راجع الأمثلة) إذا كان هناك كائن ثنائي كبير الحجم يحمل نفس اسم أحد الدلائل الظاهرية.
  3. إذا عُينت العلامة --delete-destination إلى true أو prompt، فستحذف المزامنة الملفات والكائنات الثنائية كبيرة الحجم في الوجهة غير الموجودة في المصدر.

متقدم

إذا لم تحدِد امتدادًا للملف فسيكتشف AzCopy تلقائيًا نوع محتوى الملفات عند التحميل من القرص المحلي استنادًا إلى امتداد الملف أو المحتوى (إذا لم يُحدد أي امتداد).

جدول البحث المُضمن صغير، ولكن على يونكس، يُعززه ملف (ملفات) mime.types الخاص بالنظام المحلي إذا كان متوفرًا تحت اسم أو أكثر من هذه الأسماء:

  • /etc/mime.types
  • /etc/apache2/mime.types
  • /etc/apache/mime.types

في Windows، تُستخرج أنواع MIME من السجل.

azcopy sync <source> <destination> [flags]

أمثلة

مزامنة ملف واحد:

azcopy sync "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

كما هو موضح أعلاه، ولكن احسب أيضًا تجزئة MD5 لمحتوى الملف، ثم احفظ تجزئة MD5 هذه كخاصية Content-MD5 الخاصة بكائن ثنائي كبير الحجم.

azcopy sync "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5

مزامنة دليل بأكمله بما في ذلك دلائله الفرعية (لاحظ أن التكرار يكون افتراضيًا):

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]"

أو

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --put-md5

مزامنة الملفات الموجودة داخل الدليل فقط ولكن ليس الدلائل الفرعية أو الملفات الموجودة داخل الدلائل الفرعية:

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false

مزامنة مجموعة فرعية من الملفات في دليل (على سبيل المثال: ملفات jpg و pdf فقط، أو إذا كان اسم الملف exactName):

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --include-pattern="*.jpg;*.pdf;exactName"

مزامنة دليل بأكمله ولكن استبعاد ملفات معينة من النطاق (على سبيل المثال: كل ملف يبدأ بـ foo أو ينتهي بـ bar):

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --exclude-pattern="foo*;*bar"

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

azcopy sync "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

مزامنة دليل ظاهري:

azcopy sync "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]?[SAS]" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=true

مزامنة دليل ظاهري له نفس اسم كائن ثنائي كبير الحجم (إضافة شرطة مائلة لاحقة إلى المسار للتوضيح):

azcopy sync "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]/?[SAS]" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]/" --recursive=true

مزامنة دليل ملف Azure:

azcopy sync "https://[account].file.core.windows.net/[share]/[path/to/dir]?[SAS]" "https://[account].file.core.windows.net/[share]/[path/to/dir]?[SAS]" --recursive=true

ملاحظة

إذا تم استخدام علامات التضمين/الاستبعاد معًا، فلن يُنظر إلا في الملفات المُطابقة لأنماط التضمين، ولكن سيتم دائمًا تجاهل الملفات التي تطابق أنماط الاستبعاد.

الخيارات

تعويم --block-size-mb استخدم حجم الكتلة هذا (المحدد في MiB) عند التحميل إلى "تخزين Azure" أو التنزيل من "تخزين Azure". يُحسب الافتراضي تلقائيًا بناء على حجم الملف. يُسمح بالكسور العشرية (على سبيل المثال: 0.25).

سلسلة --check-md5 تحدد مدى دقة التحقق من صحة تجزئات MD5 عند التنزيل. لا يتوفر هذا الخيار إلا عند التنزيل. تشمل القيم المتاحة NoCheck، LogOnly، FailIfDifferent، FailIfDifferentOrMissing. (افتراضي FailIfDifferent). (افتراضي FailIfDifferent)

سلسلة --cpk-by-name قدّم العميل مفتاحًا بالاسم يسمح للعملاء تقديم طلبات مقابل Azure Blob Storage بخيار لتوفير مفتاح تشفير على أساس كل طلب. سيُحضر اسم المفتاح المُقدم من Azure Key Vault وسيُستخدم لتشفير البيانات

--cpk-by-value قدّم العميل مفتاحًا بالاسم يسمح للعملاء تقديم طلبات مقابل Azure Blob Storage بخيار لتوفير مفتاح تشفير على أساس كل طلب. سيُحضر المفتاح المُقدم والتجزئة الخاصة به من متغيرات البيئة

سلسلة --delete-destination تحدد ما إذا كان يجب حذف ملفات إضافية من الوجهة غير موجودة في المصدر. يمكن التعيين إلى true أو false أو prompt. إذا عُيّن على prompt، فسيُسأل المستخدم قبل جدولة حذف الملفات والكائنات الثنائية كبيرة الحجم. (افتراضي false). (افتراضي false)

--dry-run يطبع مسار الملفات التي سينسخها أمر المزامنة أو يُزيلها. لا تنسخ هذه العلامة الملفات الفعلية أو تُزيلها.

سلسلة --exclude-attributes (Windows فقط) تستبعد الملفات التي تتطابق سماتها مع قائمة السمات. على سبيل المثال:A;S;R

سلسلة --exclude-path تستبعد هذه المسارات عند مقارنة المصدر بالوجهة. لا يدعم هذا الخيار أحرف البدل (*). يتحقق من بادئة المسار النسبي (على سبيل المثال: myFolder;myFolder/subDirName/file.pdf).

سلسلة --exclude-pattern تستبعد الملفات حيث يتطابق الاسم مع قائمة الأنماط. على سبيل المثال:*.jpg;*.pdf;exactName

سلسلة --exclude-regex تستبعد المسار النسبي للملفات التي تتطابق مع التعبيرات العادية. افصل التعبيرات العادية بـ ';'.

--help مساعدة للمزامنة.

سلسلة --include-attributes (Windows فقط) تتضمن فقط الملفات التي تتطابق سماتها مع قائمة السمات. على سبيل المثال:A;S;R

سلسلة --include-pattern تتضمن فقط الملفات حيث يتطابق الاسم مع قائمة الأنماط. على سبيل المثال:*.jpg;*.pdf;exactName

سلسلة --include-regex تتضمن فقط المسار النسبي للملفات التي تتماشى مع التعبيرات العادية. افصل التعبيرات العادية بـ ';'.

سلسلة --log-level تُحدد الإسهاب في السجل لملف السجل، والمستويات المتاحة: INFO(جميع الطلبات والاستجابات)، وWARNING(الاستجابات البطيئة)، وERROR(الطلبات الفاشلة فقط)، وNONE(لا توجد سجلات الإخراج). (افتراضي INFO).

--mirror-mode يُعطل المقارنة المستندة إلى وقت آخر تعديل واستبدال الملفات والكائنات الثنائية كبيرة الحجم المتعارضة في الوجهة إذا عُينت هذه العلامة إلى true. الافتراضي هو false.

--preserve-smb-info صحيح بشكل افتراضي. يحافظ على معلومات خصائص SMB (آخر وقت للكتابة ووقت الإنشاء وحجم السمات بالبايت) بين الموارد المتوافقة مع SMB (Windows وملفات Azure). تنطبق هذه العلامة على كل من الملفات والمجلدات، ما لم يُحدد عامل تصفية للملفات فقط (على سبيل المثال، تضمين نمط). المعلومات المنقولة للمجلدات هي نفسها الخاصة بالملفات، باستثناء "آخر وقت للكتابة" الذي لم يُحفظ للمجلدات.

--preserve-permissions خطأ بشكل افتراضي. يحافظ على قوائم التحكم في الوصول بين الموارد المتوافقة (Windows وملفات Azure، أو Data Lake Storage Gen 2 إلى Data Lake Storage Gen 2). بالنسبة للحسابات التي تحتوي على مساحة اسم هرمية، ستحتاج إلى رمز SAS أو OAuth المميز للحاوية مع أذونات "تعديل الملكية" "وتعديل الأذونات". بالنسبة للتنزيلات، ستحتاج أيضًا إلى علامة --backup لاستعادة الأذونات حيث لن يكون المالك الجديد هو المستخدم الذي يُشغل AzCopy. تنطبق هذه العلامة على كل من الملفات والمجلدات، ما لم يُحدد عامل تصفية للملفات فقط (على سبيل المثال، تضمين نمط).

--put-md5 يُنشئ تجزئة MD5 لكل ملف، ويحفظ التجزئة كخاصية Content-MD5 للكائن الثنائي كبير الحجم أو الملف الوجهة. (لا تُنشأ التجزئة بشكل افتراضي.) متوفرة فقط عند التحميل.

--recursiveTrue بشكل افتراضي، يبحث في الدلائل الفرعية بشكل متكرر عند المزامنة بين الدلائل. (افتراضي True).

--s2s-preserve-access-tier يحتفظ بطبقة الوصول أثناء نسخ خدمة إلى خدمة. ارجع إلى طبقات الوصول الفعّالة والفرعية والمؤرشفة لبيانات كائن ثنائي كبير الحجم للتأكد من أن حساب تخزين الوجهة يدعم تعيين طبقة الوصول. في الحالات التي يكون فيها تعيين طبقة الوصول غير مدعوم، يرجى استخدام --s2s-preserve-access-tier=false لتجاوز نسخ طبقة الوصول. (افتراضي true).

--s2s-preserve-blob-tags يحتفظ بعلامات الفهرس أثناء مزامنة خدمة إلى خدمة من وحدة تخزين كائن ثنائي كبير الحجم إلى أخرى.

الخيارات الموروثة من الأوامر الأصل

الخيار الوصف
--cap-mbps uint32 يحدد الحد الأقصى لمعدل النقل بالميجابت في الثانية. قد يختلف معدل النقل لحظة بلحظة قليلًا عن الحد الأقصى. إذا عُيّن هذا الخيار إلى صفر أو إذا حُذف، فلن يُحدد الحد الأقصى لمعدل النقل.
سلسلة --output-type تنسيق إخراج الأمر. تشمل الخيارات: نص، json. القيمة الافتراضية هي "نص".
سلسلة --trusted-microsoft-suffixes يحدد لواحق المجال الإضافية حيث يمكن إرسال الرموز المميزة لتسجيل الدخول إلى Microsoft Azure Active Directory. الافتراضي هو '.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net'. يُضاف أي شئ مُدرج هنا إلى الإعداد الافتراضي. للأمان، يجب وضع مجالات Microsoft Azure هنا فقط. افصل إدخالات متعددة بالفواصل المنقوطة.

راجع أيضًا