تحميل الملفات إلى تخزين Azure Blob باستخدام AzCopy

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

بمقدورك تحميل الملفات والدلائل إلى تخزين Blob باستخدام الأداة المساعدة لسطر الأوامر AzCopy v10.

لمعرفة أمثلة لأنواع أخرى من المهام مثل تنزيل النقط أو المزامنة مع تخزين Blob أو نسخ النقاط بين الحسابات، راجع الارتباطات المعروضة في قسم الخطوات التالية من هذه المقالة.

الشروع في العمل

راجع مقالة بدء استخدام AzCopy لتنزيل AzCopy والتعرف على الطرق التي يمكنك من خلالها توفير بيانات اعتماد التفويض لخدمة التخزين.

ملاحظة

تفترض الأمثلة الواردة في هذه المقالة أنك قدمت بيانات اعتماد التفويض باستخدام Microsoft Azure Active Directory.

إذا كنت تفضل استخدام رمز SAS المميز للسماح بالوصول إلى بيانات blob، فيمكنك إلحاق هذا الرمز المميز بعنوان URL للمورد في كل أمر AzCopy. على سبيل المثال: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

إنشاء حاوية

يمكنك استخدام الأمر azcopy make لإنشاء حاوية.

تلميح

يشمل هذا المثال وسيطات المسار بعلامات اقتباس مفردة (""). استعمل علامات الاقتباس الفردية في جميع أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

هذا مثال على جدول:

بناء الجملة

azcopy make 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>'

مثال

https://mystorageaccount.blob.core.windows.net/mycontainer

مثال (مساحة الأسماء الهرمية)

https://mystorageaccount.dfs.core.windows.net/mycontainer

للحصول على مستندات مرجعية مفصلة، راجع جعل azcopy .

تحميل ملف

قم بتحميل ملف باستخدام الأمر azcopy copy .

تلميح

يشمل هذا المثال وسيطات المسار بعلامات اقتباس مفردة (""). استعمل علامات الاقتباس الفردية في جميع أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

بناء الجملة

azcopy copy '<local-file-path>' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-name>'

مثال

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'

يمكنك أيضًا تحميل ملف باستخدام رمز حرف بدل (*) في أي مكان في مسار الملف أو اسم الملف. على سبيل المثال: 'C:\myDirectory\*.txt' أو C:\my*\*.txt.

تحميل دليل

حمّل دليل باستخدام الأمر azcopy copy .

ينسخ هذا المثال دليلًا (وجميع الملفات الموجودة في هذا الدليل) إلى حاوية تخزين البيانات الثنائية الكبيرة (blob). ستكون النتيجة هي دليل في الحاوية بنفس الاسم.

تلميح

يشمل هذا المثال وسيطات المسار بعلامات اقتباس مفردة (""). استعمل علامات الاقتباس الفردية في جميع أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

بناء الجملة

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --recursive

للتمكن من النسخ إلى دليل داخل الحاوية، ما عليك سوى تحديد اسم هذا الدليل في سلسلة الأوامر.

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' --recursive

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' --recursive

في حالة تحديد اسم دليل غير موجود في الحاوية، يقوم AzCopy بإنشاء دليل جديد بهذا الاسم.

تحميل محتويات الدليل

حمّل محتويات دليل باستخدام الأمر azcopy copy . استخدم رمز حرف البدل (*) لتحميل المحتويات بدون نسخ الدليل المحتوي نفسه.

تلميح

يشمل هذا المثال وسيطات المسار بعلامات اقتباس مفردة (""). استعمل علامات الاقتباس الفردية في جميع أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

بناء الجملة

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>'

مثال

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory'

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory'

قم بإلحاق علامة --recursive لتحميل الملفات في كافة الدلائل الفرعية.

تحميل ملفات محددة

يمكنك تحميل ملفات معينة باستخدام أسماء ملفات كاملة، أو أسماء جزئية بأحرف البدل (*)، أو باستخدام التواريخ والأوقات.

تلميح

تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استعمل علامات الاقتباس الفردية في جميع أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

تحديد عدة أسماء ملفات كاملة

استخدم الأمر azcopy copy مع الخيار --include-path. افصل أسماء الملفات الفردية عن طريق فاصلة منقوطة (;).

بناء الجملة

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --include-path <semicolon-separated-file-list>

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive'

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive'

في هذا المثال، ينقل AzCopy الدليل C:\myDirectory\photos والملف C:\myDirectory\documents\myFile.txt. قم بتضمين الخيار--recursive لنقل كافة الملفات في الدليل C:\myDirectory\photos.

يمكنك أيضًا استبعاد الملفات باستخدام الخيار --exclude-path. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .

استخدام أحرف البدل

استخدم الأمر azcopy copy مع الخيار--include-pattern. حدد الأسماء الجزئية التي تشمل أحرف البدل. افصل بين الأسماء باستخدام فاصلة منقوطة (;).

بناء الجملة

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'

يمكنك أيضًا استبعاد الملفات باستخدام الخيار--exclude-pattern. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .

ينطبق الخياران --include-pattern و --exclude-pattern فقط على أسماء الملفات وليس على المسار. إذا كنت تريد نسخ جميع الملفات النصية الموجودة في شجرة الدليل، فاستخدم الخيار –recursive للحصول على شجرة الدليل بالكامل، ثم استخدم –include-pattern وحدد *.txt للحصول على جميع الملفات النصية.

تحميل الملفات التي تم تعديلها قبل أو بعد التاريخ والوقت

استخدم الأمر azcopy copy باستخدام الخيار--include-before أو --include-after. حدد التاريخ والوقت بتنسيق ISO-8601 (على سبيل المثال: 2020-08-19T15:04:00Z).

تحمل الأمثلة التالية الملفات التي تم تعديلها في التاريخ المحدد أو بعده.

بناء الجملة

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' --include-after <Date-Time-in-ISO-8601-format>

مثال

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory'  --include-after '2020-08-19T15:04:00Z'

مثال (مساحة الأسماء الهرمية)

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory'   --include-after '2020-08-19T15:04:00Z'

للحصول على مرجع تفصيلي، راجع المستندات المرجعية azcopy copy .

تحميل بعلامات الفهرس

يمكنك تحميل ملف وإضافة علامات فهرس كائن ثنائي الحجم (معاينة) إلى كائن ثنائي كبير الحجم المستهدف.

إذا كنت تستخدم ترخيص Microsoft Azure AD، فيجب أن يتم تعيين دور مالك بيانات تخزين البيانات الثنائية الكبيرة لمدير الأمان أو يجب منحه إذنًا إلى Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write عملية موفر موارد Azure عبر دور Azure المخصص. إذا كنت تستخدم رمزًا مميزًا لتوقيع الوصول المشترك (SAS)، فيجب أن يوفر هذا الرمز المميز الوصول إلى علامات الكائن ثنائي الحجم عبر t إذن SAS.

لإضافة علامات، استخدم الخيار --blob-tags جنبًا إلى جنب مع زوج قيم مفتاح-قيمة مشفر لعنوان URL. على سبيل المثال، لإضافة المفتاح my tag وقيمة my tag value، يمكنك إضافة --blob-tags='my%20tag=my%20tag%20value' إلى معلمة الوجهة.

افصل بين علامات الفهرس المتعددة باستخدام علامة العطف (&). على سبيل المثال، إذا كنت تريد إضافة مفتاح my second tag وقيمة my second tag value، فإن سلسلة الخيار الكاملة ستكون --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'.

توضح الأمثلة التالية كيفية استخدام الخيار--blob-tags.

تلميح

يشمل هذا المثال وسيطات المسار بعلامات اقتباس مفردة (""). استعمل علامات الاقتباس الفردية في جميع أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

تحميل ملف

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

تحميل دليل

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

تحميل محتويات الدليل

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

ملاحظة

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

تحميل مع أعلام اختيارية

بمقدورك تعديل عملية التحميل باستخدام علامات اختيارية. يرد فيما يلي بعض الأمثلة.

السيناريو	وضع علامة
تحميل الملفات على هيئة Append Blobs أو Page Blobs.	- نوع الكائن ثنائي الحجم = [BlockBlob | PageBlob | AppendBlob]
حمّل إلى طبقة وصول محددة (مثل طبقة الأرشيف).	- block-blob-tier = [لا شيء | ساخن | رائع | أرشيف]

للحصول على قائمة كاملة، راجع الخيارات .

الخطوات التالية

ابحث عن المزيد من الأمثلة في هذه المقالات:

• أمثلة: تنزيل
• أمثلة: نسخ بين الحسابات
• أمثلة: مزامنة
• أمثلة: مستودعات Amazon S3
• نماذج: Google Cloud Storage
• أمثلة: Azure Files
• برنامج تعليمي: ترحيل البيانات المحلية إلى التخزين السحابي باستخدام AzCopy

راجع هذه المقالات لتكوين الإعدادات وتحسين الأداء واستكشاف المشكلات وإصلاحها:

• إعدادات تكوين AzCopy
• تحسين أداء of AzCopy
• استكشاف الأخطاء في AzCopy V10 وإصلاحها في Azure Storage باستخدام ملفات السجل