إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
بمقدورك تحميل الملفات والدلائل إلى تخزين Blob باستخدام الأداة المساعدة لسطر الأوامر AzCopy v10.
لمعرفة أمثلة لأنواع أخرى من المهام مثل تنزيل النقط أو المزامنة مع تخزين Blob أو نسخ النقاط بين الحسابات، راجع الارتباطات المعروضة في قسم الخطوات التالية من هذه المقالة.
الشروع في العمل
راجع مقالة بدء استخدام AzCopy لتنزيل AzCopy والتعرف على الطرق التي يمكنك من خلالها توفير بيانات اعتماد التخويل لخدمة التخزين.
إشعار
تفترض الأمثلة الواردة في هذه المقالة أنك توفر بيانات اعتماد التخويل باستخدام معرف Microsoft Entra.
إذا كنت ترغب في استخدام رمز SAS المميز لتخويل الوصول إلى بيانات الكائن الثنائي كبير الحجم، فقم بإلحاق هذا الرمز المميز بعنوان URL للمورد في كل أمر AzCopy. على سبيل المثال: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.
إنشاء حاوية
استخدم الأمر azcopy make لإنشاء حاوية.
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). إذا كنت تستخدم Windows Command Shell (cmd.exe) ، فقم بإرفاق وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلا من علامات الاقتباس الفردية ("').
إعراب
azcopy make 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>'
مثال
azcopy make 'https://mystorageaccount.blob.core.windows.net/mycontainer'
مثال (نقطة نهاية Data Lake Storage)
azcopy make 'https://mystorageaccount.dfs.core.windows.net/mycontainer'
للحصول على مستندات مرجعية مفصلة، انظر نسخة.
تحميل ملف
قم بتحميل ملف باستخدام الأمر azcopy copy .
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (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'
مثال (نقطة نهاية Data Lake Storage)
azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'
يمكنك أيضًا تحميل ملف باستخدام رمز البدل (*) في أي مكان في مسار الملف أو اسم الملف. على سبيل المثال: 'C:\myDirectory\*.txt' أو C:\my*\*.txt.
تحميل دليل
حمّل دليل باستخدام الأمر azcopy copy .
ينسخ هذا المثال دليلًا (وجميع الملفات الموجودة في هذا الدليل) إلى حاوية تخزين البيانات الثنائية الكبيرة (blob). والنتيجة هي دليل في الحاوية بنفس الاسم.
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (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
مثال (نقطة نهاية Data Lake Storage)
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
مثال (نقطة نهاية Data Lake Storage)
azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' --recursive
إذا قمت بتحديد اسم دليل غير موجود في الحاوية، فسيقوم AzCopy بإنشاء دليل جديد بهذا الاسم.
تحميل محتويات الدليل
حمّل محتويات دليل باستخدام الأمر azcopy copy . استخدم رمز حرف البدل (*) لتحميل المحتويات بدون نسخ الدليل المحتوي نفسه.
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (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'
مثال (نقطة نهاية Data Lake Storage)
azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory'
قم بإلحاق علامة --recursive لتحميل الملفات في كافة الدلائل الفرعية.
تحميل ملفات محددة
يمكنك تحميل ملفات معينة باستخدام أسماء ملفات كاملة، أو أسماء جزئية بأحرف البدل (*)، أو باستخدام التواريخ والأوقات.
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').
تحديد عدة أسماء ملفات كاملة
استخدم أمر نسخ azcopy مع الخيار --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'
مثال (نقطة نهاية Data Lake Storage)
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 مع الخيار --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*'
مثال (نقطة نهاية Data Lake Storage)
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'
مثال (نقطة نهاية Data Lake Storage)
azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' --include-after '2020-08-19T15:04:00Z'
للحصول على مرجع مفصل، راجع نسخة من المستندات المرجعية.
تحميل بعلامات الفهرس
يمكنك تحميل ملف وإضافة علامات فهرس كائن ثنائي كبير الحجم إلى الكائن الثنائي كبير الحجم الهدف.
إذا كنت تستخدم تخويل Microsoft Entra، فقم بتعيين دور مالك بيانات Storage Blob إلى كيان الأمان الخاص بك، أو امنحه إذنا لعملية 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.
تلميح
تتضمن هذه الأمثلة وسيطات المسار بعلامات اقتباس مفردة (""). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (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. | --blob-type=[BlockBlob|PageBlob|AppendBlob] |
| حمّل إلى طبقة وصول محددة (مثل طبقة الأرشيف). | - block-blob-tier = [لا شيء | ساخن | رائع | أرشيف] |
للحصول على قائمة كاملة، راجع الخيارات .
تحديد أنواع المصدر والوجهة
يستخدم AzCopy المعلمة --from-to لتحديد أنواع موارد المصدر والوجهة بشكل صريح عند فشل الاكتشاف التلقائي - كما هو الحال في سيناريوهات الأنابيب أو المحاكيات. تساعد هذه المعلمة AzCopy على فهم سياق النقل والتحسين وفقا لذلك.
| من إلى قيمة | الوصف |
|---|---|
LocalBlob |
التحميل من نظام الملفات المحلي إلى Azure Blob Storage |
LocalBlobFS |
التحميل من نظام الملفات المحلي إلى Azure Data Lake Gen2 (BlobFS) |
PipeBlob |
دفق البيانات من أنبوب إلى Azure Blob Storage |
PipeFile |
دفق البيانات من أنبوب إلى Azure File Storage |
الخطوات التالية
يمكنك العثور على مزيد من الأمثلة في هذه المقالات:
- أمثلة: تنزيل
- أمثلة: النسخ بين الحسابات
- أمثلة: مزامنة
- أمثلة: مستودعات Amazon S3
- أمثلة: Google Cloud Storage
- أمثلة: ملفات Azure
راجع هذه المقالات لتكوين الإعدادات وتحسين الأداء واستكشاف المشكلات وإصلاحها: