azcopy bench
Teljesítménymutatót futtat úgy, hogy feltölti vagy letölti a tesztadatokat egy megadott célhelyre vagy onnan. Feltöltések esetén a rendszer automatikusan létrehozza a tesztadatokat.
A benchmark parancs ugyanazt a folyamatot futtatja, mint a "copy", kivéve a következőket:
A forrás- és célparaméterek megkövetelése helyett a teljesítményteszt csak egyet vesz igénybe. Ez a blobtároló, az Azure Files Share vagy az Azure Data Lake Storage Gen2 fájlrendszer, amelyet fel szeretne tölteni vagy onnan le szeretne tölteni.
A "mode" paraméter azt írja le, hogy az AzCopynak tesztelnie kell-e a feltöltéseket, vagy le kell-e töltenie az adott célról. Érvényes értékek ar'e "Upload" és "Download". Az alapértelmezett érték a "Feltöltés".
A feltöltési teljesítménytesztek esetében a hasznos adatokat parancssori paraméterek írják le, amelyek szabályozzák, hogy hány fájl jön létre automatikusan, és mekkoraak. A létrehozási folyamat teljes egészében a memóriában történik. A rendszer nem használja a lemezt.
Letöltések esetén a hasznos adatok a forrásban már létező fájlokból állnak. (Lásd az alábbi példát arról, hogyan hozhat létre tesztfájlokat, ha szükséges).
A másolási parancshoz elérhető választható paraméterek közül csak néhány támogatott.
A rendszer további diagnosztikákat mér és jelent.
Feltöltések esetén az alapértelmezett viselkedés az átvitt adatok törlése a tesztfuttatás végén. Letöltések esetén az adatokat a rendszer soha nem menti helyben.
A teljesítményteszt mód automatikusan beállítja magát a maximális átviteli sebességet eredményező párhuzamos TCP-kapcsolatok számához. Ez a szám a végén jelenik meg. Az automatikus hangolás megakadályozása érdekében állítsa a COPY_CONCURRENCY_VALUE környezeti változót adott számú kapcsolatra.
Minden szokásos hitelesítési típus támogatott. A feltöltés teljesítményértékelésének legkényelmesebb módszere azonban általában egy üres tároló LÉTREHOZÁSA SAS-jogkivonattal és SAS-hitelesítés használata. (A letöltési módhoz tesztadatoknak kell szerepelnie a céltárolóban.)
azcopy bench [destination] [flags]
Példák
Futtasson egy feltöltési teljesítménytesztet alapértelmezett paraméterekkel (akár 1 Gb/s-os hálózatok teljesítményértékeléséhez is alkalmas):
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Futtasson egy teljesítménytesztet, amely 100 fájlt tölt fel, mindegyik 2 GiB méretű: (gyors hálózaton történő teljesítménymérésre alkalmas, például 10 Gb/s):"
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Ugyanaz, mint fent, de használjon 50 000 fájlt, mindegyik 8 MiB méretű, és kiszámítja az MD5 kivonatokat (ugyanúgy, ahogyan a --put-md5 jelző ezt a másolási parancsban teszi). A --put-md5 célja a teljesítménymérés során annak tesztelése, hogy az MD5-számítás befolyásolja-e a kiválasztott fájlszám és -méret átviteli sebességét:
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Benchmark-teszt futtatása, amely letölti a meglévő fájlokat egy célból
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Olyan feltöltés futtatása, amely nem törli az átvitt fájlokat. (Ezek a fájlok ezután hasznos adatként szolgálhatnak egy letöltési teszthez)
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Beállítások
--blob-type string A célhelyen található blob típusát határozza meg. A különböző blobtípusok teljesítményértékelésének engedélyezésére szolgál. Megegyezik a másolási parancs azonos nevű paraméterével (alapértelmezett "Észlelés")
--block-size-mb float Használja ezt a blokkméretet (a MiB-ben megadva). A rendszer automatikusan kiszámítja az alapértelmezett értéket a fájlméret alapján. A tizedes törtek megengedettek – például 0,25. Azonos a másolási parancs azonos nevű paraméterével
--check-length Ellenőrizze egy fájl hosszát a célhelyen az átvitel után. Ha eltérés van a forrás és a cél között, a rendszer sikertelenként jelöli meg az átvitelt. (alapértelmezett igaz)
--delete-test-data Ha igaz, a teljesítményteszt adatai a teljesítményteszt futtatása végén törlődnek. Állítsa hamisra, ha a célhelyen szeretné tartani az adatokat – például a teljesítményteszt-módban kívüli manuális tesztekhez (alapértelmezett igaz)
--file-count (uint) a használni kívánt automatikusan létrehozott adatfájlok száma (alapértelmezett 100)
-h, --help segítség a padhoz
--log-level (sztring) határozza meg a naplófájl részletességét, a rendelkezésre álló szinteket: INFO (minden kérés/válasz), WARNING(lassú válaszok), ERROR (csak sikertelen kérések) és NONE (nincs kimeneti napló). (alapértelmezett "INFO")
--mode (sztring) Meghatározza, hogy az Azcopy tesztelje-e a feltöltéseket vagy a letöltéseket ebből a célból. Az érvényes értékek a "feltöltés" és a "letöltés". Az alapértelmezett beállítás a "feltöltés". (alapértelmezett "feltöltés")
--number-of-folders (uint) Ha 0-nál nagyobb, hozzon létre mappákat az adatok felosztásához.
--put-blob-size-mb Használja ezt a méretet (a MiB-ben megadva) küszöbértékként annak meghatározásához, hogy egy blobot egyetlen PUT-kérésként kell-e feltölteni az Azure Storage-ba való feltöltéskor. A rendszer automatikusan kiszámítja az alapértelmezett értéket a fájlméret alapján. Tizedes törtek megengedettek (például: 0,25).
--put-md5 Hozzon létre egy MD5 kivonatot az egyes fájlokról, és mentse a kivonatot a cél blob/fájl Content-MD5 tulajdonságaként. (Alapértelmezés szerint a kivonat NEM jön létre.) Azonos a másolási parancs azonos nevű paraméterével
--size-per-file (sztring) Az automatikusan létrehozott adatfájlok mérete. K, M vagy G után azonnal számnak kell lennie. Pl. 12k vagy 200G (alapértelmezett "250M")
A szülőparancsoktól örökölt beállítások
--cap-mbps (lebegőpontos) Az átviteli sebesség leértékelődése megabit/másodpercben. A pillanatonkénti átviteli sebesség kissé eltérhet a korláttól. Ha ez a beállítás nullára van állítva, vagy nincs megadva, az átviteli sebesség nincs leképezve.
--output-type (sztring) A parancs kimenetének formátuma. A lehetőségek közé tartozik: szöveg, json. Az alapértelmezett érték a "szöveg". (alapértelmezett "szöveg")
--trusted-microsoft-suffixes (sztring) További tartományi utótagokat ad meg, ahol a Microsoft Entra bejelentkezési jogkivonatok elküldhetők. Az alapértelmezett érték a ".core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net". Az itt felsoroltak az alapértelmezett értékhez lesznek hozzáadva. A biztonság érdekében csak Microsoft Azure-tartományokat helyezzen ide. Több bejegyzés elkülönítése pontosvesszővel.