azcopy bench
Menjalankan tolok ukur performa dengan mengunggah atau mengunduh data pengujian ke atau dari tujuan tertentu. Untuk pengunggahan, data pengujian dihasilkan secara otomatis.
Perintah tolok ukur menjalankan proses yang sama dengan 'salin', kecuali:
Alih-alih membutuhkan kedua parameter sumber dan tujuan, tolok ukur hanya membutuhkan salah satunya. Ini adalah kontainer blob, Azure Files Share, atau sistem file Azure Data Lake Storage Gen2 yang ingin Anda unggah atau unduh.
Parameter 'mode' menjelaskan apakah AzCopy harus menguji unggahan atau unduhan dari target tertentu. Nilai yang valid adalah 'unggah' dan 'unduh'. Nilai defaultnya adalah 'Upload'.
Untuk pengunggahan tolok ukur, payload dijelaskan oleh parameter baris perintah, yang mengontrol berapa banyak file yang dihasilkan secara otomatis dan seberapa signifikan file tersebut. Proses penghasilan berlangsung sepenuhnya dalam memori. Disk tidak digunakan.
Untuk unduhan, payload terdiri dari file mana pun yang sudah ada di sumbernya. (Lihat contoh di bawah ini tentang cara menghasilkan file pengujian bila diperlukan).
Hanya beberapa parameter opsional yang tersedia untuk perintah salin yang didukung.
Diagnostik tambahan diukur dan dilaporkan.
Untuk unggahan, perilaku defaultnya adalah menghapus data yang ditransfer di akhir uji coba. Untuk pengunduhan, data tidak pernah disimpan secara lokal.
Mode tolok ukur akan secara otomatis menyetel dirinya sendiri ke sejumlah koneksi TCP paralel yang memberikan throughput maksimum. Mode tolok ukur akan menampilkan angka tersebut di akhir. Untuk mencegah penyetelan otomatis, set variabel lingkungan variabel AZCOPY_CONCURRENCY_VALUE ke sejumlah koneksi tertentu.
Semua tipe autentikasi umum didukung. Namun, pendekatan yang paling tepat untuk pengunggahan proses tolok ukur biasanya adalah dengan membuat kontainer kosong dengan token SAS dan menggunakan autentikasi SAS. (Mode unduhan memerlukan sekumpulan data pengujian agar tersedia dalam kontainer target.)
azcopy bench [destination] [flags]
Contoh
eksekusi pengunggahan tolok ukur dengan parameter default (cocok untuk tolok ukur jaringan hingga 1 Gbps):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
jalankan pengujian tolok ukur yang mengunggah 100 file, masing-masing berukuran 2 GiB: (cocok untuk tolok ukur jaringan cepat, misalnya, 10 Gbps):'
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
sama seperti diatas, tetapi gunakan 50.000 file, masing-masing berukuran 8 MiB dan komputasi hash md5(dengan cara --put-md5 yang sama seperti yang dilakukan bendera dalam perintah salin). Tujuan saat tolok ukur 5 adalah untuk menguji apakah komputasi MD5 memengaruhi throughput untuk jumlah dan ukuran file yang dipilih:
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Jalankan pengujian tolok ukur yang mengunduh file yang ada dari target
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
jalankan unggahan yang tidak menghapus file yang ditransfer. (File-file ini nantinya dapat berfungsi sebagai payload untuk pengujian unduhan)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Opsi
--blob-type string Menentukan jenis tujuan blob. Digunakan untuk memungkinkan proses tolok ukur berbagai jenis blob. Identik dengan parameter bernama sama dalam perintah salin (default "deteksi")
--block-size-mb float Gunakan ukuran blok ini (ditentukan dalam MiB). Defaultnya secara otomatis dihitung berdasarkan ukuran file. Pecahan desimal diizinkan - misalnya, 0,25. Identik dengan perintah bernama sama dalam perintah salin
--check-length Periksa panjang file di tujuan setelah transfer. Jika ada ketidakcocokan antara sumber dan tujuan, maka transfer ditandai sebagai gagal. (default true)
--delete-test-data Jika true, data tolok ukur akan dihapus di akhir eksekusi tolok ukur. set ke false jika Anda ingin menyimpan data penyedia tujuan - misalnya, untuk menggunakannya dalam pengujian manual di luar mode tolok ukur (default true)
--file-count Jumlah file data untuk digunakan yang dihasilkan secara otomatis (default 100)
-h, --help Bantuan untuk bench
--log-level (rangkaian) Menentukan verbositas untuk file log, level yang tersedia: INFO(semua permintaan/respons), WARNING(respons lambat), ERROR(hanya permintaan gagal), dan NONE(tidak ada log output). (default "INFO")
--mode (rangkaian) Menentukan apakah Azcopy harus menguji pengunggahan atau pengunduhan dari target ini. Nilai yang valid adalah 'upload' dan 'download'. Opsi defaultnya adalah 'upload'. ( default "upload" )
--number-of-folders (uint) Jika lebih besar dari 0, buat folder untuk membagi data.
--put-blob-size-mb Gunakan ukuran ini (ditentukan dalam MiB) sebagai ambang batas untuk menentukan apakah akan mengunggah blob sebagai satu permintaan PUT saat mengunggah ke Azure Storage. Nilai defaultnya secara otomatis dihitung berdasarkan ukuran file. Pecahan desimal diperbolehkan (misalnya: 0,25).
--put-md5 Buat hash MD5 dari setiap file, dan simpan hash sebagai properti Content-MD5 dari blob/file tujuan. (Secara default digest TIDAK dibuat.) Identik dengan parameter bernama sama dalam perintah salin
--size-per-file (file data) Ukuran setiap file data yang dihasilkan secara otomatis. Haruslah angka yang diikuti oleh K, M, atau G. Misalnya 12k atau 200G (default "250M")
Opsi yang diwarisi dari perintah induk
--cap-mbps (float) Menutup tingkat transfer, dalam megabit per detik. Throughput moment-by-moment mungkin sedikit berbeda dibandingkan tutup. Jika opsi ini diatur ke nol, atau dihilangkan, throughput tidak dibatasi.
--output-type (String) Format output perintah. Pilihannya meliputi: text, json. Nilai default-nya adalah ‘teks’. (default "teks")
--trusted-microsoft-suffixes (String) Menentukan akhiran domain tambahan tempat token masuk Microsoft Entra dapat dikirim. Defaultnya adalah '.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net'. Setiap yang tercantum di sini ditambahkan ke default. Untuk keamanan, Anda sebaiknya hanya menempatkan domain Microsoft Azure di sini. Pisahkan beberapa entri dengan titik koma.