azcopy bench
Uruchamia test porównawczy wydajności, przekazując lub pobierając dane testowe do lub z określonego miejsca docelowego. W przypadku przekazywania dane testowe są generowane automatycznie.
Polecenie testu porównawczego uruchamia ten sam proces co "copy", z tą różnicą, że:
Zamiast wymagać zarówno parametrów źródłowych, jak i docelowych, test porównawczy przyjmuje tylko jeden. Jest to kontener obiektów blob, udział usługi Azure Files lub system plików usługi Azure Data Lake Storage, z którego chcesz przekazać plik lub go pobrać.
W parametrze "mode" opisano, czy narzędzie AzCopy powinno testować przekazywanie do danych docelowych lub pobierać je z danego obiektu docelowego. Prawidłowe wartości ar'e 'Upload' i 'Download'. Wartość domyślna to "Upload".
W przypadku testów porównawczych przekazywania ładunek jest opisywany przez parametry wiersza polecenia, które kontrolują, ile plików jest generowanych automatycznie i jak duże. Proces generowania odbywa się całkowicie w pamięci. Dysk nie jest używany.
W przypadku pobierania ładunek składa się z plików, które już istnieją w źródle. (Zobacz przykład poniżej, jak wygenerować pliki testowe w razie potrzeby).
Obsługiwane są tylko kilka opcjonalnych parametrów dostępnych dla polecenia kopiowania.
Dodatkowa diagnostyka jest mierzona i zgłaszana.
W przypadku przekazywania domyślne zachowanie polega na usunięciu przesłanych danych na końcu przebiegu testu. W przypadku pobierania dane nigdy nie są zapisywane lokalnie.
Tryb porównawczy automatycznie dostraja się do liczby równoległych połączeń TCP, które zapewniają maksymalną przepływność. Na końcu zostanie wyświetlona ta liczba. Aby zapobiec automatycznemu dostrajaniu, ustaw zmienną środowiskową COPY_CONCURRENCY_VALUE na określoną liczbę połączeń.
Obsługiwane są wszystkie typowe typy uwierzytelniania. Jednak najwygodniejsze podejście do przekazywania testów porównawczych polega zazwyczaj na utworzeniu pustego kontenera z tokenem SAS i użyciu uwierzytelniania SAS. (Tryb pobierania wymaga obecności zestawu danych testowych w kontenerze docelowym).
azcopy bench [destination] [flags]
Przykłady
Uruchom test porównawczy przekazywania z domyślnymi parametrami (odpowiednie dla sieci porównawczych do 1 Gb/s).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"
Uruchom test porównawczy przekazywania o określonym rozmiarze bloku 2 MiB i sprawdź długość plików po przeniesieniu.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --block-size-mb 2 --check-length
Uruchom test porównawczy, który przekazuje 500 plików. Każdy plik ma rozmiar 500 MiB, a poziom dziennika jest ustawiony na wyświetlanie tylko błędów.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 500 --size-per-file 500M --log-level ERROR
Uruchom test porównawczy, który przekazuje 100 plików. Każdy plik ma rozmiar 2 GiB. Jest to odpowiednie do testów porównawczych w szybkiej sieci (na przykład: 10 Gb/s).
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Następny przykład jest taki sam jak powyżej, ale z 50 000 plików. Każdy plik o rozmiarze 8 MiB. W tym przykładzie obliczane są również skróty MD5 każdego pliku podobne do sposobu, w jaki flaga --put-md5 oblicza md5 w poleceniu azcopy copy. Celem --put-md5 podczas testowania porównawczego jest sprawdzenie, czy obliczenia MD5 wpływają na przepływność dla wybranej liczby i rozmiaru pliku.
azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5
Uruchom test porównawczy, który przekazuje 1000 plików i tworzy foldery w celu podzielenia danych. Każdy plik ma rozmiar 100 KiB.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 1000 --size-per-file 100K --number-of-folders 5
Uruchom test porównawczy, który pobiera istniejące pliki z miejsca docelowego.
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
Uruchom test porównawczy pobierania z domyślnymi parametrami i ograniczyć szybkość transferu na poziomie 500 Mb/s.
azcopy bench --mode=Download "https://[account].blob.core.windows.net/[container]?<SAS>" --cap-mbps 500
Uruchom przekazywanie, które nie powoduje usunięcia przeniesionych plików. Te pliki mogą następnie służyć jako ładunek testu pobierania.
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false
Opcje
--blob-type string definiuje typ obiektu blob w miejscu docelowym. Służy do zezwalania na testowanie porównawcze różnych typów obiektów blob. Identyczne z tym samym nazwanym parametrem w poleceniu kopiowania (domyślne "Wykryj")
--block-size-mb float Użyj tego rozmiaru bloku (określonego w programie MiB). Wartość domyślna jest obliczana automatycznie na podstawie rozmiaru pliku. Dozwolone są ułamki dziesiętne — na przykład 0,25. Identyczny z tym samym nazwanym parametrem w poleceniu copy
--check-length Sprawdź długość pliku w miejscu docelowym po przeniesieniu. Jeśli między źródłem a miejscem docelowym występuje niezgodność, transfer zostanie oznaczony jako niepowodzenie. (wartość domyślna true)
--delete-test-data Jeśli to prawda, dane porównawcze zostaną usunięte na końcu przebiegu testu porównawczego. Ustaw wartość false, jeśli chcesz zachować dane w miejscu docelowym — na przykład, aby używać ich do testów ręcznych poza trybem testu porównawczego (wartość domyślna true)
--file-count (uint) liczba automatycznie generowanych plików danych do użycia (wartość domyślna 100)
-h, --help pomoc dla ławki
--log-level (ciąg) zdefiniuj szczegółowość dziennika dla pliku dziennika, dostępne poziomy: INFO(wszystkie żądania/odpowiedzi), WARNING (wolne odpowiedzi), ERROR (tylko żądania, które zakończyły się niepowodzeniem) i NONE (brak dzienników wyjściowych). (domyślne "INFO")
--mode (ciąg) Określa, czy narzędzie Azcopy powinno testować przekazywanie lub pobieranie z tego obiektu docelowego. Prawidłowe wartości to "upload" i "download". Opcja domyślna to "upload". (domyślne "przekazywanie")
--number-of-folders (uint) Jeśli rozmiar przekracza 0, utwórz foldery, aby podzielić dane.
--put-blob-size-mb Użyj tego rozmiaru (określonego w programie MiB) jako progu, aby określić, czy przekazać obiekt blob jako pojedyncze żądanie PUT podczas przekazywania do usługi Azure Storage. Wartość domyślna jest obliczana automatycznie na podstawie rozmiaru pliku. Ułamki dziesiętne są dozwolone (na przykład: 0,25).
--put-md5 Utwórz skrót MD5 każdego pliku i zapisz skrót jako właściwość Content-MD5 docelowego obiektu blob/pliku. (Domyślnie skrót NIE jest tworzony). Identyczny z tym samym nazwanym parametrem w poleceniu copy
--size-per-file (ciąg) Rozmiar każdego automatycznie generowanego pliku danych. Musi być liczbą natychmiast po K, M lub G. Np. 12k lub 200G (domyślnie "250M")
Opcje dziedziczone z poleceń nadrzędnych
--cap-mbps (zmiennoprzecinkowy) Zwiększa szybkość transferu w megabitach na sekundę. Przepływność chwil po chwili może się nieznacznie różnić od limitu. Jeśli ta opcja jest ustawiona na zero lub zostanie pominięta, przepływność nie jest ograniczona.
--output-type (ciąg) Format danych wyjściowych polecenia. Dostępne opcje to: tekst, json. Wartość domyślna to "text". (domyślny "tekst")
--trusted-microsoft-suffixes (ciąg) Określa dodatkowe sufiksy domeny, w których mogą być wysyłane tokeny logowania entra firmy Microsoft. Wartość domyślna to '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Wszystkie wymienione tutaj są dodawane do wartości domyślnej. W celu zapewnienia bezpieczeństwa należy umieścić tutaj tylko domeny platformy Microsoft Azure. Oddziel wiele wpisów średnikami.