إعدادات تكوين AzCopy v10 ("تخزين Azure")
AzCopy هو أداة سطر الأوامر التي يمكنك استخدامها لنسخ كائنات ثنائية كبيرة الحجم أو ملفات إلى أو من حساب تخزين. تحتوي هذه المقالة على قائمة بمتغيرات البيئة التي يمكنك استخدامها لتكوين AzCopy v10.
ملاحظة
إذا كنت تبحث عن محتوى لمساعدتك في بدء استخدام AzCopy، فراجع بدء استخدام AzCopy.
متغيرات بيئة AzCopy v10
يصف الجدول التالي كل متغيّر بيئة ويوفر ارتباطات إلى محتوى يمكن أن يساعدك في استخدام المتغير.
| متغير البيئة | الوصف |
|---|---|
| AWS_ACCESS_KEY_ID | مفتاح الوصول إلى "خدمات ويب Amazon". يوفر مفتاحًا للتخويل باستخدام "خدمات ويب Amazon".نسخ البيانات من Amazon S3 إلى "تخزين Azure" باستخدام AzCopy |
| AWS_SECRET_ACCESS_KEY | مفتاح الوصول السري لـ "خدمات ويب Amazon" يوفر مفتاحًا سريًا للتخويل باستخدام "خدمات ويب Amazon". نسخ البيانات من Amazon S3 إلى "تخزين Azure" باستخدام AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | نقطة نهاية Microsoft Azure Active Directory للاستخدام. يُستخدم هذا المتغيّر فقط لتسجيل الدخول التلقائي، يرجى استخدام علامة سطر الأوامر بدلا من ذلك عند استدعاء أمر تسجيل الدخول. |
| AZCOPY_AUTO_LOGIN_TYPE | عيّن هذا المتغيّر إلى DEVICE أو MSI أو SPN. يوفر هذا المتغيّر القدرة على التخويل دون استخدام الأمر azcopy login. هذه الآلية مفيدة في الحالات التي لا يحتوي فيها نظام التشغيل على متجر سري مثل سلسلة مفاتيح Linux. راجع تخويل بدون مخزن بيانات سرية. |
| AZCOPY_BUFFER_GB | حدد الحد الأقصى لمقدار ذاكرة النظام التي تريد أن يستخدمها AzCopy عند تنزيل الملفات وتحميلها. التعبير عن هذه القيمة بالغيغابايت (GB). راجع عملية تحسين استخدام الذاكرة |
| AZCOPY_CACHE_PROXY_LOOKUP | بشكل افتراضي، سيقوم AzCopy على Windows بتخزين عمليات البحث عن الخادم الوكيل مؤقتًا على مستوى اسم المضيف (دون أخذ مسار عنوان URL في الاعتبار). عيّنها إلى أي قيمة أخرى غير "صحيح" لتعطيل ذاكرة التخزين المؤقت. |
| AZCOPY_CONCURRENCY_VALUE | يحدد الطلبات المتزامنة التي يمكن أن تحدث. يمكنك استخدام هذا المتغيّر لزيادة معدل النقل. إذا كان الكمبيوتر يحتوي على عدد أقل من 5 وحدات معالجة مركزية، إذن ستُعيّن قيمة هذا المتغير إلى 32. وإلا، القيمة الافتراضية تساوي 16 مضروباً في عدد CPUs. الحد الأقصى للقيمة الافتراضية لهذا المتغير هو 3000، ولكن يمكنك تعيين هذه القيمة يدويًا إلى قيمة أعلى أو أقل. راجع عملية زيادة التزامن |
| AZCOPY_CONCURRENT_FILES | يتجاوز العدد (التقريبي) للملفات قيد التقدم في أي وقت من خلال التحكم في عدد الملفات التي نبدأ عمليات النقل لها في وقت واحد. |
| AZCOPY_CONCURRENT_SCAN | يتحكم في درجة التوازي (القصوى) المُستخدمة أثناء الفحص. يؤثر فقط على العدادات المتوازية، والتي تتضمن ملفات Azure/وكائنات ثنائية كبيرة الحجم من Azure وأنظمة الملفات المحلية. |
| AZCOPY_CONTENT_TYPE_MAP | يتجاوز تعيين أو أكثر من تعيينات نوع MIME الافتراضية التي يحددها نظام التشغيل. عيّن هذا المتغيّر إلى مسار ملف JSON الذي يحدد أي تعيين. فيما يلي محتويات مثال لملف JSON: { "MIMETypeMapping": { ".323": "text/h323"، ".aaf": "application/octet-stream"، ".aca": "application/octet-stream"، ".accdb": "application/msaccess"، } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | يتجاوز إصدار واجهة برمجة تطبيقات الخدمة بحيث يمكن لـ AzCopy استيعاب البيئات المخصصة مثل Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | ينطبق فقط عندما تكون كائنات ثنائية كبيرة الحجم من Azure هي المصدر. يعد الفحص المتزامن أسرع ولكنه يستخدم واجهة برمجة تطبيقات الترتيب الهرمي، ما قد يؤدي إلى المزيد من IOs / التكلفة. حدد "صحيح" للتضحية بالأداء ولكن مع توفير التكلفة. |
| AZCOPY_JOB_PLAN_LOCATION | يتجاوز مكان تخزين ملفات خطة المهمة (المُستخدمة لتتبع التقدم واستئنافه) لتجنب ملء قرص. |
| AZCOPY_LOG_LOCATION | يتجاوز مكان تخزين ملفات السجل لتجنب ملء قرص. |
| AZCOPY_MSI_CLIENT_ID | معرّف العميل الخاص بهوية مُدارة يُعينها المستخدم. تُستخدم عند تعيين AZCOPY_AUTO_LOGIN_TYPE إلى MSI. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_MSI_OBJECT_ID | معرّف العنصر الخاص بهوية مُدارة يُعينها المستخدم. تُستخدم عند تعيين AZCOPY_AUTO_LOGIN_TYPE إلى MSI. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_MSI_RESOURCE_STRING | معرّف المورد خاص بهوية مُدارة يُعينها المستخدم. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_PACE_PAGE_BLOBS | هل يجب ضبط معدل النقل لكائنات ثنائية كبيرة الحجم للصفحات تلقائيًا لمطابقة حدود الخدمة؟ الافتراضي صحيح. اضبط على "خطأ" لتعطيلها |
| AZCOPY_PARALLEL_STAT_FILES | يتسبب في قيام AzCopy بالبحث عن خصائص الملف على "مؤشرات الترابط" المتوازية عند فحص نظام الملفات المحلي. تُرسم جميع مؤشرات الترابط من التجمع الذي يحدده AZCOPY_CONCURRENT_SCAN. قد يؤدي تعيين هذا إلى "صحيح" إلى تحسين أداء الفحص على Linux. غير مطلوب أو مُوصى به في Windows. |
| AZCOPY_SHOW_PERF_STATES | إذا تم تعيينه إلى أي شيء، فسيتضمن الإخراج الذي يظهر على الشاشة عددًا من الأجزاء حسب الولاية |
| AZCOPY_SPA_APPLICATION_ID | معرّف التطبيق الخاص بتسجيل تطبيق كيان الخدمة. تُستخدم عند تعيين AZCOPY_AUTO_LOGIN_TYPE إلى SPN. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_SPA_CERT_PASSWORD | كلمة مرور الشهادة. تُستخدم عند تعيين AZCOPY_AUTO_LOGIN_TYPE إلى SPN. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_SPA_CERT_PATH | المسار المطلق أو المسار النسبي إلى ملف شهادة. تُستخدم عند تعيين AZCOPY_AUTO_LOGIN_TYPE إلى SPN. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_SPA_CLIENT_SECRET | سر العميل. تُستخدم عند تعيين AZCOPY_AUTO_LOGIN_TYPE إلى SPN. راجع تخويل بدون مخزن بيانات سرية |
| AZCOPY_TENANT_ID | معرّف مستأجر Microsoft Azure Active Directory لاستخدامه لتسجيل الدخول التفاعلي لجهاز OAuth. يُستخدم هذا المتغيّر فقط لتسجيل الدخول التلقائي، يرجى استخدام علامة سطر الأوامر بدلا من ذلك عند استدعاء أمر تسجيل الدخول. |
| AZCOPY_TUNE_TO_CPU | عيّنها إلى "خطأ" لمنع AzCopy من أخذ استخدام وحدة المعالجة المركزية في الاعتبار عند الضبط التلقائي لمستوى التزامن (على سبيل المثال، في الأمر "benchmark"). |
| AZCOPY_USER_AGENT_PREFIX | أضف بادئة إلى عامل مستخدم AzCopy الافتراضي، والذي يُستخدم لأغراض بيانات تتبع الاستخدام. تُدرج مسافة تلقائيًا. |
| GOOGLE_APPLICATION_CREDENTIALS | المسار المطلق إلى ملف مفتاح حساب الخدمة يوفر مفتاحًا للتخويل باستخدام "تخزين Google على السحابة". نسخ البيانات من "تخزين Google على السحابة" إلى "تخزين Azure" باستخدام AzCopy (إصدار أولي) |
| HTTPS_PROXY | تكوين إعدادات الوكيل لـ AzCopy. عيّن هذا المتغيّر إلى عنوان IP الوكيل ورقم منفذ الوكيل. على سبيل المثال، xx.xxx.xx.xxx:xx. إذا شغلت AzCopy على Windows، فسيكتشف AzCopy تلقائيًا إعدادات الوكيل، لذلك لن تضطر إلى استخدام هذا الإعداد في Windows. إذا اخترت استخدام هذا الإعداد في Windows، فسيتجاوز الكشف التلقائي. راجع تكوين إعدادات الوكيل |
تكوين إعدادات الوكيل
لتكوين إعدادات الوكيل لـ AzCopy، عيّن متغير البيئة HTTPS_PROXY. إذا شغلت AzCopy على Windows، فسيكتشف AzCopy تلقائيًا إعدادات الوكيل، لذلك لن تضطر إلى استخدام هذا الإعداد في Windows. إذا اخترت استخدام هذا الإعداد في Windows، فسيتجاوز الكشف التلقائي.
| نظام التشغيل | الأمر |
|---|---|
| Windows | في موجه الأوامر استخدم: set HTTPS_PROXY=<proxy IP>:<proxy port>في PowerShell استخدم: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
حاليًا، لا يدعم AzCopy الوكلاء الذين يحتاجون إلى مصادقة باستخدام NTLM أو Kerberos.
تجاوز الوكيل
إذا كنت تشغل AzCopy على Windows، وتريد إخباره بعدم استخدام أي وكيل على الإطلاق (بدلًا من الكشف التلقائي عن الإعدادات)، فاستخدم هذه الأوامر. باستخدام هذه الإعدادات، لن يبحث AzCopy عن أي وكيل أو يحاول استخدامه.
| نظام التشغيل | البيئة | الأوامر |
|---|---|---|
| Windows | موجه الأوامر (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
في أنظمة التشغيل الأخرى، ما عليك سوى ترك متغير HTTPS_PROXY غير محدد إذا كنت ترغب في عدم استخدام أي وكيل.