azcopy ortamı
Test verilerini belirtilen hedefe yükleyerek veya bu hedeften indirerek performans karşılaştırması çalıştırır. Karşıya yüklemeler için test verileri otomatik olarak oluşturulur.
Benchmark komutu şu durumlar dışında 'copy' ile aynı işlemi çalıştırır:
Karşılaştırma, hem kaynak hem de hedef parametreleri gerektirmek yerine yalnızca bir tane alır. Bu, karşıya yüklemek veya indirmek istediğiniz blob kapsayıcısı, Azure Dosyalar Paylaşımı veya Azure Data Lake Storage 2. Nesil dosya sistemidir.
'mode' parametresi, AzCopy'nin belirli bir hedefe yüklemeleri mi yoksa belirli bir hedeften indirilenleri mi test etmesi gerektiğini açıklar. Geçerli ar'e 'Upload' ve 'Download' değerleri. Varsayılan değer 'Karşıya Yükle'dir.
Karşıya yükleme karşılaştırmaları için yük, otomatik olarak oluşturulan dosya sayısını ve bunların ne kadar büyük olduğunu denetleyen komut satırı parametreleriyle açıklanır. Oluşturma işlemi tamamen bellekte gerçekleşir. Disk kullanılmaz.
İndirmeler için yük, kaynakta zaten var olan dosyalardan oluşur. (Gerekirse test dosyalarının nasıl oluşturulacağı hakkında aşağıdaki örne bakın).
Kopyalama komutu için kullanılabilen isteğe bağlı parametrelerden yalnızca birkaçı desteklenir.
Ek tanılamalar ölçülür ve rapor edilir.
Karşıya yüklemeler için varsayılan davranış, test çalıştırmasının sonunda aktarılan verileri silmektir. İndirmeler için veriler hiçbir zaman yerel olarak kaydedilmez.
Kıyaslama modu otomatik olarak en yüksek aktarım hızını veren paralel TCP bağlantısı sayısına göre ayarlar. Bu sayı sonunda görüntülenir. Otomatik ayarlamayı önlemek için COPY_CONCURRENCY_VALUE ortam değişkenini belirli sayıda bağlantıya ayarlayın.
Tüm normal kimlik doğrulama türleri desteklenir. Ancak karşıya yüklemeyi karşılaştırmak için en uygun yaklaşım genellikle SAS belirtecine sahip boş bir kapsayıcı oluşturmak ve SAS kimlik doğrulaması kullanmaktır. (İndirme modu, hedef kapsayıcıda bir dizi test verisi bulunmasını gerektirir.)
azcopy bench [destination] [flags]
Örnekler
Varsayılan parametrelerle bir karşıya yükleme karşılaştırması çalıştırın (1 Gb/sn'ye kadar olan ağları karşılaştırmak için uygundur).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Belirtilen blok boyutu 2 MiB olan bir karşıya yükleme karşılaştırması çalıştırın ve aktarımdan sonra dosyaların uzunluğunu denetleyin.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
500 dosyayı karşıya yükleyen bir karşılaştırma testi çalıştırın. Her dosyanın boyutu 500 MiB'dir ve günlük düzeyi yalnızca hataları görüntüleyecek şekilde ayarlanır.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
100 dosyayı karşıya yükleyen bir karşılaştırma testi çalıştırın. Her dosyanın boyutu 2 GiB'dir. Bu, hızlı bir ağda karşılaştırma yapmak için uygundur (Örneğin: 10 Gb/sn).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Sonraki örnek yukarıdakiyle aynıdır, ancak 50.000 dosya içerir. Boyutu 8 MiB olan her dosya. Bu örnek ayrıca her dosyanın MD5 karmalarını , --put-md5 bayrağının azcopy copy komutundaki MD5'i hesaplama yöntemine benzer şekilde hesaplar. Karşılaştırma yaparken --put-md5'in amacı, MD5 hesaplamasının seçilen dosya sayısı ve boyutu için aktarım hızını etkileyip etkilemediğini test etmektir.
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
1000 dosyayı karşıya yükleyen ve verileri bölmek için klasörler oluşturan bir karşılaştırma testi çalıştırın. Her dosyanın boyutu 100 KiB'dir.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5
Hedeften mevcut dosyaları indiren bir karşılaştırma testi çalıştırın.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Varsayılan parametrelerle bir indirme karşılaştırması çalıştırın ve aktarım hızını 500 Mb/sn'ye indirin.
azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500
Aktarılan dosyaları silmeyen bir karşıya yükleme çalıştırın. Bu dosyalar daha sonra indirme testi için yük görevi görebilir.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Seçenekler
--blob-type string hedefte blob türünü tanımlar. Farklı blob türlerinin karşılaştırmasına izin vermek için kullanılır. Kopyalama komutundaki aynı adlı parametreyle aynı ("Algıla")
--block-size-mb float Bu blok boyutunu kullanın (MiB'de belirtilir). Varsayılan değer, dosya boyutuna göre otomatik olarak hesaplanır. Ondalık kesirlere izin verilir. Örneğin, 0,25. Copy komutundaki aynı adlı parametreyle aynı
--check-length Aktarımdan sonra hedefte bir dosyanın uzunluğunu denetleyin. Kaynak ve hedef arasında uyuşmazlık varsa aktarım başarısız olarak işaretlenir. (varsayılan true)
--delete-test-data Doğruysa, kıyaslama çalıştırmasının sonunda karşılaştırma verileri silinir. Verileri hedefte tutmak istiyorsanız false olarak ayarlayın; örneğin, karşılaştırma modunun dışındaki el ile testlerde kullanmak için (varsayılan true)
--file-count (uint) kullanılacak otomatik olarak oluşturulan veri dosyası sayısı (varsayılan 100)
-h, --help bench için yardım
--log-level (dize) günlük dosyası için günlük ayrıntı düzeyini, kullanılabilir düzeyleri tanımlar: BİlGİ(tüm istekler/yanıtlar), UYARI(yavaş yanıtlar), HATA(yalnızca başarısız istekler) ve NONE (çıkış günlüğü yok). (varsayılan "BİlGİ")
--mode (dize) Azcopy'nin bu hedeften karşıya yüklemeleri veya indirmeleri test etmesi gerekip gerekmediğini tanımlar. Geçerli değerler 'upload' ve 'download' değerleridir. Varsayılan seçenek "karşıya yükleme" seçeneğidir. (varsayılan "karşıya yükleme")
--number-of-folders (uint) 0'dan büyükse, verileri bölmek için klasörler oluşturun.
--put-blob-size-mbAzure Depolama'a yüklerken blobu tek bir PUT isteği olarak karşıya yükleyip yüklemeyeceğini belirlemek için bu boyutu (MiB'de belirtilen) eşik olarak kullanın. Varsayılan değer, dosya boyutuna göre otomatik olarak hesaplanır. Ondalık kesirlere izin verilir (Örneğin: 0,25).
--put-md5 Her dosyanın MD5 karması oluşturun ve karmayı hedef blobun/dosyanın Content-MD5 özelliği olarak kaydedin. (Varsayılan olarak karma oluşturulmaZ.) Copy komutundaki aynı adlı parametreyle aynı
--size-per-file (dize) Otomatik olarak oluşturulan her veri dosyasının boyutu. Hemen ardından K, M veya G gelen bir sayı olmalıdır. Örneğin, 12k veya 200G (varsayılan "250M")
Üst komutlardan devralınan seçenekler
--cap-mbps (kayan) Aktarım hızını saniye başına megabit cinsinden kaplar. Dakikalar içinde aktarım hızı üst sınırdan biraz farklı olabilir. Bu seçenek sıfır olarak ayarlanırsa veya atlanırsa, aktarım hızı sınırlanır.
--output-type (dize) Komutun çıkışının biçimi. Seçenekler şunlardır: metin, json. Varsayılan değer 'text' değeridir. (varsayılan "metin")
--trusted-microsoft-suffixes (dize) Microsoft Entra oturum açma belirteçlerinin gönderilebileceği ek etki alanı soneklerini belirtir. Varsayılan değer :'.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Burada listelenenler varsayılan değere eklenir. Güvenlik için buraya yalnızca Microsoft Azure etki alanlarını yerleştirmeniz gerekir. Birden çok girdiyi noktalı virgülle ayırın.