azcopy bench
تشغيل معيار الأداء عن طريق تحميل بيانات الاختبار أو تنزيلها من أو إلى جهة محددة. بالنسبة إلى التحميلات، يتم إنشاء بيانات الاختبار تلقائيًا.
يعمل الأمر القياسي على تشغيل نفس العملية مثل "نسخ" ، باستثناء ما يلي:
بدلًا من طلب كل من معلمات المصدر والوجهة، يستغرق المعيار معيارًا واحدًا فقط. هذه هي حاوية كائن ثنائي كبير الحجم أو Azure Files Share أو نظام الملفات Azure Data Lake Storage Gen2 الذي تريد تحميله أو التنزيل منه.
تصف معلمة "الوضع" ما إذا كان يجب على AzCopy اختبار التحميلات إلى هدف معين أو التنزيلات منه. القيمتان الصالحتان هما 'Upload' و'Download'. القيمة الافتراضية هي تحميل.
بالنسبة لمعايير التحميل، يتم وصف الحمولة من خلال معلمات سطر الأوامر، والتي تتحكم في عدد الملفات التي يتم إنشاؤها تلقائياً ومدى حجمها. تتم عملية التوليد بالكامل في الذاكرة. القرص غير مستخدم.
بالنسبة للتنزيلات، تتكون الحمولة من أي ملفات موجودة بالفعل في المصدر. (انظر المثال أدناه حول كيفية إنشاء ملفات اختبار إذا لزم الأمر).
يتم دعم عدد قليل فقط من المعلمات الاختيارية المتوفرة لأمر النسخ.
يتم قياس تشخيصات إضافية والإبلاغ عنها.
بالنسبة إلى التحميلات، يتمثل السلوك الافتراضي في حذف البيانات المنقولة في نهاية التشغيل التجريبي. بالنسبة للتنزيلات، لا يتم حفظ البيانات محلياً أبداً.
سيقوم الوضع القياسي تلقائيًا بضبط نفسه على عدد اتصالات TCP المتوازية التي توفر أقصى قدر من معدل النقل. سيعرض هذا الرقم في النهاية. لمنع الضبط التلقائي، اضبط متغير البيئة COPY_CONCURRENCY_VALUE على عدد محدد من الاتصالات.
أنواع المصادقة التي يتم دعمها عادة. ومع ذلك، فإن الطريقة الأكثر ملاءمة لقياس تحميل المعايير هي عادة إنشاء حاوية فارغة باستخدام رمز SAS المميز واستخدام مصادقة SAS. (يتطلب وضع التنزيل وجود مجموعة من بيانات الاختبار في الحاوية الهدف.)
azcopy bench [destination] [flags]
الأمثلة
قم بتشغيل معيار تحميل باستخدام المعلمات الافتراضية (مناسبة لقياس أداء الشبكات حتى 1 غيغابايت في الثانية):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
قم بإجراء اختبار معياري يقوم بتحميل 100 ملف، حجم كلٍّ منها 2 غيغابايت: (مناسب لقياس الأداء على شبكة سريعة، على سبيل المثال 10 غيغابايت في الثانية):'
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
كما هو مذكور أعلاه، ولكن استخدم 50000 ملف، كل 8 ميغابايت في الحجم وحساب تجزئات MD5 الخاصة بها (بنفس الطريقة التي يقوم بها علم --put-md5 في أمر النسخ). الغرض من --put-md5 عند قياس الأداء هو اختبار ما إذا كان حساب MD5 يؤثر على معدل نقل عدد الملفات المحددة وحجمها:
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
تشغيل اختبار مرجعي يقوم بتنزيل الملفات الموجودة من هدف
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
قم بتشغيل تحميل لا يحذف الملفات المنقولة. (يمكن أن تكون هذه الملفات بعد ذلك بمثابة حمولة لاختبار التنزيل)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
الخيارات
--blob-type string يحدد نوع blob في الوجهة. تستخدم للسماح بقياس أنواع الكائنات الثنائية كبيرة الحجم المختلفة. مطابقة للمعامل الذي يحمل نفس الاسم في الأمر copy (default "Detect")
--block-size-mb float استخدم حجم الكتلة هذا (المحدد في MiB). يتم حساب الافتراضي تلقائيًا بناء على حجم الملف. يسمح بالكسور العشرية - على سبيل المثال، 0.25. مطابق للمعامل الذي يحمل نفس الاسم في الأمر copy
--check-length تحقق من طول ملف على الوجهة بعد النقل. إذا كان هناك عدم تطابق بين المصدر والوجهة، فسيتم وضع علامة على النقل على أنه فشل. (الافتراضي True)
--delete-test-data إذا كان صحيحا، سيتم حذف البيانات القياسية في نهاية تشغيل المعيار. اضبطها على خطأ إذا كنت تريد الاحتفاظ بالبيانات في الوجهة - على سبيل المثال، لاستخدامها في الاختبارات اليدوية خارج وضع قياس الأداء (default true)
--file-count (uint) عدد ملفات البيانات المُنشأة تلقائياً المراد استخدامها (default 100)
-h، --help help for bench
--log-level (سلسلة) حدد إسهاب السجل لملف السجل، والمستويات المتاحة: INFO (جميع الطلبات / الاستجابات)، وWARNING (الاستجابات البطيئة)، وERROR (الطلبات الفاشلة فقط)، وNONE (لا توجد سجلات إخراج). (الافتراضي "المعلومات")
--mode (سلسلة) تحدد ما إذا كان يجب على Azcopy اختبار التحميلات أو التنزيلات من هذا الهدف. القيم الصالحة هي "تحميل" و"تنزيل". الخيار الافتراضي هو "تحميل". (default "upload")
--number-of-folders (uint) إذا كانت أكبر من 0، فقم بإنشاء مجلدات لتقسيم البيانات.
--put-blob-size-mb استخدم هذا الحجم (المحدد في MiB) كعتبات لتحديد ما إذا كان يجب تحميل كائن ثنائي كبير الحجم كطلب PUT واحد عند التحميل إلى Azure Storage. تُُحسب القيمة الافتراضية تلقائيًا بناءً على حجم الملف. يُسمح بالكسور العشرية (على سبيل المثال: 0.25).
--put-md5 قم بإنشاء تجزئة MD5 لكل ملف، واحفظ التجزئة كخاصية Content-MD5 للكائن الثنائي كبير الحجم/الملف الوجهة. (افتراضياً لا يتم إنشاء التجزئة.) مطابقة للمعامل الذي يحمل نفس الاسم في أمر النسخ
--size-per-file (سلسلة) حجم كل ملف بيانات يتم إنشاؤه تلقائياً. يجب أن يكون رقماً متبوعاً بـ K أو M أو G. على سبيل المثال. 12 كيلو أو 200 جرام (default "250M")
الخيارات الموروثة من الأوامر الأصل
--cap-mbps (عائم) الحد الأقصى لمعدل النقل، بالميغابتات في الثانية. قد تختلف الإنتاجية لحظة بلحظة قليلا عن الحد الأقصى. إذا تم تعيين هذا الخيار على صفر، أو تم حذفه، فلن يتم تحديد معدل النقل لنقظة الارتكاز.
--output-type (سلسلة) تنسيق إخراج الأمر. وتشمل الخيارات: النص، json. القيمة الافتراضية هي 'text'. (افتراضي "نص")
--trusted-microsoft-suffixes (سلسلة) تحديد لاحقات مجال إضافية حيث يمكن إرسال رموز تسجيل الدخول إلى Microsoft Entra. الافتراضي هو '.core.windows.net؛.core.chinacloudapi.cn؛.core.cloudapi.de؛.core.usgovcloudapi.net؛ *.storage.azure.net'. تتم إضافة أي قيمة مدرجة هنا إلى الإعداد الافتراضي. للأمان، يجب وضع مجالات Microsoft Azure هنا فقط. يمكنك فصل الإدخالات المتعددة بفواصل منقوطة.