إعدادات تكوين 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 Entra لاستخدامها. يُستخدم هذا المتغيّر فقط لتسجيل الدخول التلقائي، يرجى استخدام علامة سطر الأوامر بدلا من ذلك عند استدعاء أمر تسجيل الدخول. |
| AZCOPY_AUTO_LOGIN_TYPE | قم بتعيين هذا المتغير إلى DEVICEوSPNMSIAZCLI.PSCRED يوفر هذا المتغيّر القدرة على التخويل دون استخدام الأمر azcopy login. راجع تخويل الوصول إلى الكائنات الثنائية كبيرة الحجم باستخدام AzCopy ومعرف Microsoft Entra. |
| 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_DISABLE_SYSLOG | تعطيل التسجيل في Syslog أو مسجل أحداث Windows. بشكل افتراضي، يرسل AzCopy سجلات إلى هذه القنوات. يمكنك تعيين هذا المتغير إلى true إذا كنت تريد تقليل الضوضاء في Syslog أو سجل أحداث Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | تكوين AzCopy للتنزيل إلى مسار مؤقت قبل التنزيل الفعلي. القيم المسموح بها صحيحة أو خاطئة |
| 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_REQUEST_TRY_TIMEOUT | تعيين عدد الدقائق التي يجب أن يحاول AzCopy تحميل الملفات لكل طلب قبل مهلة AzCopy. |
| 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 Entra لاستخدامه لتسجيل الدخول التفاعلي لجهاز OAuth. يُستخدم هذا المتغيّر فقط لتسجيل الدخول التلقائي، يرجى استخدام علامة سطر الأوامر بدلا من ذلك عند استدعاء أمر تسجيل الدخول. |
| AZCOPY_TUNE_TO_CPU | عيّنها إلى "خطأ" لمنع AzCopy من أخذ استخدام وحدة المعالجة المركزية في الاعتبار عند الضبط التلقائي لمستوى التزامن (على سبيل المثال، في الأمر "benchmark"). |
| AZCOPY_USER_AGENT_PREFIX | أضف بادئة إلى عامل مستخدم AzCopy الافتراضي، والذي يُستخدم لأغراض بيانات تتبع الاستخدام. تُدرج مسافة تلقائيًا. |
| CPK_ENCRYPTION_KEY | قيمة مفتاح تشفير AES-256 مشفر من Base64. هذا المتغير مطلوب لكل من طلبات القراءة والكتابة عند استخدام "المفاتيح المقدمة من العميل" لتشفير البيانات وفك تشفيرها في عمليات تخزين Blob. يمكنك استخدام "المفاتيح المقدمة من العميل" عن طريق تعيين العلامة --cpk-by-value=true . |
| CPK_ENCRYPTION_KEY_SHA256 | SHA256 المشفرة Base64 لمفتاح التشفير. هذا المتغير مطلوب لكل من طلبات القراءة والكتابة عند استخدام "المفاتيح المقدمة من العميل" لتشفير البيانات وفك تشفيرها في عمليات تخزين Blob. يمكنك استخدام "المفاتيح المقدمة من العميل" عن طريق تعيين العلامة --cpk-by-value=true . |
| GOOGLE_APPLICATION_CREDENTIALS | المسار المطلق إلى ملف مفتاح حساب الخدمة يوفر مفتاحًا للتخويل باستخدام "تخزين Google على السحابة". نسخ البيانات من "تخزين Google على السحابة" إلى "تخزين Azure" باستخدام AzCopy (إصدار أولي) |
| GOOGLE_CLOUD_PROJECT | معرف المشروع مطلوب لاجتياز مستوى الخدمة في Google Cloud Storage. |
| 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> |
| ماك | export HTTPS_PROXY=<proxy IP>:<proxy port> |
حاليًا، لا يدعم AzCopy الوكلاء الذين يحتاجون إلى مصادقة باستخدام NTLM أو Kerberos.
تجاوز الوكيل
إذا كنت تشغل AzCopy على Windows، وتريد إخباره بعدم استخدام أي وكيل على الإطلاق (بدلًا من الكشف التلقائي عن الإعدادات)، فاستخدم هذه الأوامر. باستخدام هذه الإعدادات، لن يبحث AzCopy عن أي وكيل أو يحاول استخدامه.
| نظام التشغيل | البيئة | الأوامر |
|---|---|---|
| Windows | موجه الأوامر (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | بوويرشيل | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
في أنظمة التشغيل الأخرى، ما عليك سوى ترك متغير HTTPS_PROXY غير محدد إذا كنت ترغب في عدم استخدام أي وكيل.