بدء العمل مع أداة المساعدة AzCopy
AzCopy هو أداة سطر الأوامر التي يمكنك استخدامها لنسخ كائنات ثنائية كبيرة الحجم أو ملفات إلى أو من حساب تخزين. تساعدك هذه المقالة على تنزيل AzCopy والاتصال بحساب التخزين ثم نقل الملفات.
ملاحظة
AzCopy V10 هو الإصدار المدعوم حاليًا من AzCopy.
إذا احتجت إلى استخدام إصدار سابق من AzCopy، فراجع قسم استخدام الإصدار السابق من AzCopy من هذه المقالة.
تنزيل AzCopy
أولًا، قم بتنزيل الملف القابل للتشغيل AzCopy V10 إلى أي دليل على جهاز الكمبيوتر الخاص بك. AzCopy V10 هو مجرد ملف قابل للتشغيل، لذلك لا يوجد شيء لتثبيته.
- Windows 64 بت (zip)
- Windows 32 بت (zip)
- Linux x86-64 (tar)
- macOS (zip)
يتم ضغط هذه الملفات كملف مضغوط (Windows وMac) أو ملف tar (Linux). لتنزيل ملف tar وفك ضغطه على Linux، راجع الوثائق الخاصة بتوزيع Linux.
ملاحظة
إذا كنت ترغب في نسخ البيانات من وإلى خدمة تخزين Azure Table، قم بتثبيت الإصدار 7.3 من AzCopy.
تشغيل AzCopy
للراحة، فكر في إضافة موقع الدليل الخاص بـAzCopy القابل للتنفيذ إلى مسار النظام لسهولة الاستخدام. بهذه الطريقة يمكنك كتابة azcopy من أي دليل على النظام الخاص بك.
إذا اخترت عدم إضافة دليل AzCopy إلى مسارك، فسيتعين عليك تغيير الدلائل إلى موقع AzCopy القابل للتشغيل وكتابة azcopy أو .\azcopy في موجه أوامر Windows PowerShell.
بصفتك مالكًا لحساب Azure Storage، لا يتم تعيين أذونات تلقائيًا لك للوصول إلى البيانات. قبل أن تتمكن من القيام بأي شيء ذي معنى مع AzCopy، تحتاج إلى تحديد كيفية توفير بيانات اعتماد التخويل لخدمة التخزين.
تفويض AzCopy
يمكنك توفير بيانات اعتماد التخويل باستخدام Microsoft Azure Active Directory (AD)، أو باستخدام رمز مميز لتوقيع الوصول المشترك (SAS).
استخدم هذا الجدول كدليل:
| نوع التخزين | أسلوب التفويض المدعوم حاليًا |
|---|---|
| تخزين كائن ثنائي كبير الحجم | Azure AD & SAS |
| مساحة تخزين Blob (مساحة أسماء هرمية) | Azure AD & SAS |
| تخزين الملفات | SAS فقط |
الخيار 1: استخدام Microsoft Azure Active Directory
يتوفر هذا الخيار لتخزين النقط فقط. باستخدام Microsoft Azure Active Directory، يمكنك توفير بيانات الاعتماد مرة واحدة بدلًا من الاضطرار إلى إلحاق رمز SAS مميز بكل أمر.
ملاحظة
في الإصدار الحالي، إذا كنت تخطط لنسخ النقاط بين حسابات التخزين، فسيتعين عليك إلحاق رمز SAS المميز بكل عنوان URL مصدر. يمكنك حذف الرمز المميز SAS فقط من عنوان URL المقصود. على سبيل المثال، راجع نسخ الكائنات الثنائية كبيرة الحجم بين حسابات التخزين.
لتخويل الوصول باستخدام Azure AD، راجع تفويض الوصول إلى الكائنات الثنائية كبيرة الحجم باستخدام AzCopy وMicrosoft Azure Active Directory (Azure AD).
الخيار 2: استخدام رمز SAS المميز
يمكنك إلحاق رمز SAS المميز بكل عنوان URL مصدر أو وجهة يستخدم في أوامر AzCopy.
يقوم أمر المثال هذا بنسخ البيانات بشكل متكرر من دليل محلي إلى حاوية كائن ثنائي كبير الحجم. يتم إلحاق رمز SAS وهمي بنهاية عنوان URL للحاوية.
azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true
لمعرفة المزيد حول رموز SAS المميزة وكيفية الحصول عليها راجع استخدام توقيعات الوصول المشترك (SAS).
ملاحظة
يحدد إعداد النقل الآمن المطلوب لحساب التخزين ما إذا كان الاتصال بحساب تخزين آمنًا باستخدام أمان طبقة النقل (TLS) أم لا. يتم تمكين هذا الإعداد افتراضيًا.
نقل البيانات
بعد تفويض هويتك أو الحصول على رمز SAS، يمكنك البدء في نقل البيانات.
للعثور على أمثلة للأوامر، راجع أي من هذه المقالات.
| الخدمة | مقالة |
|---|---|
| Azure Blob Storage | رفع الملفات إلى تخزين Azure Blob |
| Azure Blob Storage | تنزيل النقط الكائنات الثنائية كبيرة الحجم من تخزين Azure Blob |
| Azure Blob Storage | نسخ الكائنات الثنائية كبيرة الحجم بين حسابات تخزين Azure |
| Azure Blob Storage | مزامنة مع تخزين Azure Blob |
| ملفات Azure | نقل البيانات باستخدام AzCopy وتخزين الملفات |
| Amazon S3 | نسخ البيانات من Amazon S3 إلى تخزين Azure |
| Google Cloud Storage | نسخ البيانات من تخزين سحابة Google إلى تخزين Azure (معاينة) |
| تخزين Azure Stack | نقل البيانات مع تخزين AzCopy وAzure Stack |
الحصول على تعليمات الأوامر
للاطلاع على قائمة الأوامر، اكتب azcopy -h ثم اضغط على مفتاح ENTER.
لمعرفة أمر معين، فقط قم بتضمين اسم الأمر (على سبيل المثال: azcopy list -h ).
قائمة الأوامر
يسرد الجدول التالي كافة أوامر AzCopy v10. يرتبط كل أمر بمقالة مرجعية.
| الأمر | الوصف |
|---|---|
| azcopy bench | تشغيل معيار الأداء عن طريق تحميل بيانات الاختبار أو تنزيلها من أو إلى موقع محدد. |
| azcopy copy | نسخ البيانات المصدر إلى موقع وجهة |
| azcopy doc | إنشاء وثائق للأداة بتنسيق Markdown. |
| azcopy env | إظهار متغيرات البيئة التي يمكنها تكوين سلوك AzCopy. |
| azcopy jobs | اللجان الفرعية المتعلقة بإدارة الوظائف. |
| azcopy jobs clean | إزالة كافة ملفات السجل والخطة لكافة المهام. |
| azcopy jobs list | عرض معلومات حول كافة المهام. |
| azcopy jobs remove | إزالة كافة الملفات المقترنة معرف المهمة المحدد. |
| azcopy jobs resume | استئناف المهمة الحالية باستخدام معرف الوظيفة المحدد. |
| azcopy jobs show | إظهار معلومات تفصيلية عن معرف الوظيفة المحدد. |
| azcopy load | الدلائل الفرعية المتعلقة بنقل البيانات بتنسيقات محددة. |
| azcopy load clfs | نقل البيانات المحلية إلى حاوية وتخزينها بتنسيق نظام الملفات السحابية Avere من Microsoft (CLFS). |
| azcopy list | سرد الكيانات في مورد معين. |
| azcopy login | تسجيل الدخول إلى Microsoft Azure Active Directory للوصول إلى موارد تخزين Azure. |
| azcopy logout | تسجيل خروج المستخدم وإنهاء الوصول إلى موارد تخزين Azure. |
| azcopy make | إنشاء حاوية أو مشاركة ملف. |
| azcopy remove | حذف النقط أو الملفات من حساب تخزين Azure. |
| azcopy sync | نسخ موقع المصدر إلى الموقع الوجهة. |
ملاحظة
لا يملك AzCopy أمر إعادة تسمية الملفات.
الاستخدام في برنامج نصي
الحصول على رابط تنزيل ثابت
بمرور الوقت، سيشير رابط تنزيل AzCopy إلى إصدارات جديدة من AzCopy. إذا قام البرنامج النصي بتنزيل AzCopy، فقد يتوقف البرنامج النصي عن العمل إذا قام إصدار أحدث من AzCopy بتعديل الميزات التي يعتمد عليها البرنامج النصي.
لتجنب هذه المشكلات، احصل على ارتباط ثابت (غير متغير) إلى الإصدار الحالي من AzCopy. بهذه الطريقة، يقوم البرنامج النصي بتنزيل نفس الإصدار الدقيق من AzCopy في كل مرة يتم تشغيله.
للحصول على الرابط، قم بتشغيل هذا الأمر:
| نظام التشغيل | الأمر |
|---|---|
| Linux | curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location |
| Windows | (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location |
ملاحظة
بالنسبة إلى Linux، يقوم --strip-components=1 في الأمر tar بإزالة المجلد الأعلى مستوى الذي يحتوي على اسم الإصدار، وبدلًا من ذلك يقوم باستخراج الثنائي مباشرة إلى المجلد الحالي. يسمح هذا بتحديث البرنامج النصي بإصدار جديد من azcopy خلال تحديث عنوان URL wget فقط.
يظهر عنوان URL في مُخرج هذا الأمر. يمكن للبرنامج النصي الخاص بك بعد ذلك تنزيل AzCopy باستخدام عنوان URL هذا.
| نظام التشغيل | الأمر |
|---|---|
| Linux | wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1 |
| Windows | Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>> |
تفادي الأحرف الخاصة في رموز SAS
في الملفات الدُفعة التي تحتوي على الامتداد .cmd، سيتعين عليك تفادي الأحرف % التي تظهر في رموز SAS. يمكنك القيام بذلك عن طريق إضافة حرف % إضافي بجانب أحرف % الموجودة في سلسلة الرمز المميز SAS.
تشغيل البرامج النصية باستخدام Jenkins
إذا كنت تخطط لاستخدام Jenkins لتشغيل البرامج النصية، فتأكد من وضع الأمر التالي في بداية البرنامج النصي.
/usr/bin/keyctl new_session
الاستخدام في مستكشف تخزين Azure
يستخدم مستكشف التخزين AzCopy لتنفيذ كافة عمليات نقل البيانات الخاصة به. يمكنك استخدام مستكشف التخزين إذا كنت ترغب في الاستفادة من مزايا أداء AzCopy، ولكنك تفضل استخدام واجهة مستخدم رسومية بدلًا من خط الأوامر للتفاعل مع ملفاتك.
يستخدم "مستكشف التخزين" مفتاح حسابك لتنفيذ العمليات، لذلك بعد تسجيل الدخول إلى "مستكشف التخزين"، لن تحتاج إلى توفير بيانات اعتماد تخويل إضافية.
تكوين وتحسين وإصلاح
راجع أيًا من الموارد التالية:
استخدام إصدار سابق
إذا كنت بحاجة إلى استخدام الإصدار السابق من AzCopy، راجع أيًا من الارتباطات التالية:
الخطوات التالية
إذا كانت لديك أسئلة أو مشكلات أو ملاحظات عامة، أرسلها على صفحة GitHub.