Aracılığıyla paylaş

AzCopy kullanarak dosyaları Azure Blob depolamaya yükleme

AzCopy v10 komut satırı yardımcı programını kullanarak dosyaları ve dizinleri Blob depolamaya yükleyebilirsiniz.

Blobları indirme, Blob depolama ile eşitleme veya hesaplar arasında blob kopyalama gibi diğer görev türlerine yönelik örnekleri görmek için bu makalenin Sonraki Adımlar bölümünde sunulan bağlantılara bakın.

Kullanmaya başlayın

AzCopy'yi indirmek için AzCopy'yi kullanmaya başlama makalesine bakın ve depolama hizmetine yetkilendirme kimlik bilgilerini nasıl sağlayabileceğinizi öğrenin.

Not

Bu makaledeki örneklerde, Microsoft Entra Id kullanarak yetkilendirme kimlik bilgilerini sağladığınız varsayılır.

Blob verilerine erişimi yetkilendirmek için SAS belirteci kullanmak istiyorsanız, bu belirteci her AzCopy komutundaki kaynak URL'sine ekleyin. Örneğin: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Kapsayıcı oluşturma

Kapsayıcı oluşturmak için azcopy make komutunu kullanın.

İpucu

Bu örnekler yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol parametrelerini tek tırnak ('') yerine çift tırnak ("") içine alın.

Söz dizimi

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

Örnek

azcopy make 'https://mystorageaccount.blob.core.windows.net/mycontainer'

Örnek (Data Lake Storage uç noktası)

azcopy make 'https://mystorageaccount.dfs.core.windows.net/mycontainer'

Ayrıntılı başvuru belgeleri için bkz . azcopy make.

Dosyayı karşıya yükleme

azcopy copy komutunu kullanarak bir dosyayı karşıya yükleyin.

İpucu

Bu örnekler yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol bağımsız değişkenlerini tek tırnak ('') yerine çift tırnak ("") kullanarak belirtin.

Söz dizimi

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

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

Dosya yolunun veya dosya adının herhangi bir yerinde joker karakter simgesi (*) kullanarak da dosyayı karşıya yükleyebilirsiniz. Örneğin: 'C:\myDirectory\*.txt', veya C:\my*\*.txt.

Dizini karşıya yükleme

azcopy copy komutunu kullanarak bir dizini karşıya yükleyin.

Bu örnek, bir dizini (ve bu dizindeki tüm dosyaları) bir blob kapsayıcısına kopyalar. Sonuç olarak, kapsayıcıda aynı ada sahip bir dizin oluşturulur.

İpucu

Bu örnekler yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol parametrelerini çift tırnak ("") içine alın, tek tırnak ('') yerine.

Söz dizimi

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

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

Kapsayıcı içindeki bir dizine kopyalamak için, komut dizenizde bu dizinin adını belirtmeniz gerekir.

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

Kapsayıcıda mevcut olmayan bir dizinin adını belirtirseniz, AzCopy bu ada sahip yeni bir dizin oluşturur.

Dizin içeriğini karşıya yükleme

azcopy copy komutunu kullanarak bir dizinin içeriğini karşıya yükleyin. İçeriği içeren dizinin kendisini kopyalamadan karşıya yüklemek için joker karakter simgesini (*) kullanın.

İpucu

Bu örnekler yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol bağımsız değişkenlerini tek tırnak yerine çift tırnak içinde yazın.

Söz dizimi

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

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

--recursive Tüm alt dizinlerdeki dosyaları karşıya yüklemek için bayrağını ekleyin.

Belirli dosyaları karşıya yükleme

Tam dosya adlarını, joker karakterli kısmi adları (*) veya tarih ve saatleri kullanarak belirli dosyaları karşıya yükleyebilirsiniz.

İpucu

Bu örnekler yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol bağımsız değişkenlerini tek tırnak ('') yerine çift tırnak ("") içine alın.

Birden çok tam dosya adı belirtme

azcopy copy komutunu seçeneğiyle --include-path birlikte kullanın. Tek tek dosya adlarını noktalı virgül (; kullanarak) ayırın.

Söz dizimi

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

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

Bu örnekte AzCopy, dizini ve C:\myDirectory\photos dosyayı aktarırC:\myDirectory\documents\myFile.txt. Dizindeki --recursive tüm dosyaları C:\myDirectory\photos aktarma seçeneğini ekleyin.

Ayrıca seçeneğini kullanarak --exclude-path dosyaları dışlayabilirsiniz. Daha fazla bilgi edinmek için bkz . azcopy copy reference docs.

Joker karakter kullanma

azcopy copy komutunu seçeneğiyle --include-pattern birlikte kullanın. Joker karakterleri içeren kısmi adlar belirtin. Adları noktalı virgül (;) kullanarak ayırın.

Söz dizimi

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>

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

Ayrıca seçeneğini kullanarak --exclude-pattern dosyaları dışlayabilirsiniz. Daha fazla bilgi edinmek için bkz . azcopy copy reference docs.

--include-pattern ve --exclude-pattern seçenekleri yalnızca dosya adlarına uygulanır, yola uygulanmaz. Bir dizin ağacında bulunan tüm metin dosyalarını kopyalamak istiyorsanız, -recursive dizin ağacının tamamını almak için seçeneğini kullanın ve ardından ve öğesini -include-pattern kullanarak *.txt tüm metin dosyalarını alın.

Tarih ve saat öncesinde veya sonrasında değiştirilmiş dosyaları karşıya yükleme

komutunu kullanın. ISO-8601 biçiminde bir tarih ve saat belirtin (örneğin: 2020-08-19T15:04:00Z).

Aşağıdaki örneklerde, belirtilen tarihte veya sonrasında değiştirilen dosyalar karşıya yüklenir.

Söz dizimi

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>

Örnek

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

Örnek (Data Lake Storage uç noktası)

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

Ayrıntılı başvuru için azcopy copy reference belgelerine bakın.

Dizin etiketleriyle karşıya yükleme

Bir dosyayı karşıya yükleyebilir ve hedef bloba blob dizini etiketleri ekleyebilirsiniz.

Microsoft Entra yetkilendirmesini kullanıyorsanız, depolama blobu veri sahibi rolünü güvenlik sorumlunuza atayın Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write veya özel bir Azure rolü aracılığıyla Azure kaynak sağlayıcısı işlemine izin verin. Paylaşılan Erişim İmzası (SAS) belirteci kullanıyorsanız belirtecin SAS izni aracılığıyla blob etiketlerine t erişim sağlaması gerekir.

Etiket eklemek için URL ile kodlanmış anahtar-değer çifti seçeneğini kullanın --blob-tags . Örneğin, anahtarını my tag ve değerini my tag valueeklemek için hedef parametresine ekleyin --blob-tags='my%20tag=my%20tag%20value' .

Birden çok dizin etiketini ampersand (&) işaretiyle ayırın. Örneğin, anahtarını my second tag ve değerini my second tag valueeklemek için tam seçenek dizesi şeklindedir --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'.

Aşağıdaki örneklerde seçeneğin nasıl kullanılacağı gösterilmektedir --blob-tags .

İpucu

Bu örnekler yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol argümanlarını tek tırnak yerine çift tırnak içine alarak belirtin.

Dosyayı karşıya yükleme

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'

Dizini karşıya yükleme

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'

Dizin içeriğini karşıya yükleme

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'

Not

Kaynak için bir dizin belirtirseniz, hedefe kopyaladığınız tüm bloblar komutta belirttiğiniz etiketlere sahiptir.

İsteğe bağlı bayraklarla karşıya yükleme

İsteğe bağlı bayrakları kullanarak karşıya yükleme işleminizi değiştirebilirsiniz. Aşağıda birkaç örnek verilmiştir.

Senaryo Bayrak
Dosyaları Append Ekleme Blobları veya Sayfa Blobları olarak karşıya yükleyin. --blob-type=[BlockBlob|PageBlob|AppendBlob]
Belirli bir erişim katmanına (arşiv katmanı gibi) yükleyin. --block-blob-tier=[Yok|Sık Erişimli|Seyrek Erişimli|Arşiv]

Tam liste için bkz . seçenekler.

Kaynak ve hedef türlerini belirtme

AzCopy, otomatik algılamanın boru senaryoları veya öykünücüler gibi durumlarda başarısız olabileceği durumlarda, kaynak ve hedef kaynak türlerini açıkça tanımlamak için --from-to parametresini kullanır. Bu parametre AzCopy'nin aktarım bağlamını anlamasına ve uygun şekilde iyileştirmesine yardımcı olur.

FromTo Değeri Description
LocalBlob Yerel dosya sisteminden Azure Blob Depolama'ya yükleme
LocalBlobFS Yerel dosya sisteminden Azure Data Lake 2. Nesil'e (BlobFS) yükleme
PipeBlob Bir kanaldan Azure Blob Depolama'ya veri akışı
PipeFile Bir kanaldan Azure Dosya Depolama'ya veri akışı

Sonraki adımlar

Bu makalelerde daha fazla örnek bulabilirsiniz:

Ayarları yapılandırmak, performansı iyileştirmek ve sorunları gidermek için şu makalelere bakın:

  • Last updated on