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 feltöltési teljesítménytesztet egy megadott 2 MiB-os blokkmérettel, és ellenőrizze a fájlok hosszát az átvitel után.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
Futtasson egy teljesítménytesztet, amely 500 fájlt tölt fel. Minden fájl mérete 500 MiB, a naplószint pedig csak a hibák megjelenítésére van beállítva.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
Futtasson egy teljesítménytesztet, amely 100 fájlt tölt fel. Minden fájl mérete 2 GiB. Ez alkalmas gyors hálózaton történő teljesítménymérésre (például: 10 Gb/s).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
A következő példa ugyanaz, mint a fenti, de 50 000 fájllal. Minden fájl mérete 8 MiB. Ez a példa az egyes fájlok MD5-kivonatait is ugyanúgy számítja ki, mint ahogyan az --put-md5 jelző az azcopy copy parancsban kiszámítja az MD5-öt. 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
Futtasson egy teljesítménytesztet, amely 1000 fájlt tölt fel, és mappákat hoz létre az adatok felosztásához. Minden fájl mérete 100 KiB.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5
Futtasson egy teljesítménytesztet, amely letölti a meglévő fájlokat egy célból.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Futtasson le egy letöltési teljesítménytesztet az alapértelmezett paraméterekkel, és korlátozza az átviteli sebességet 500 Mb/s-nál.
azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500
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.
Lásd még
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: