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 Gen2, 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, który przekazuje 100 plików, każdy 2 GiB o rozmiarze: (odpowiedni do testowania porównawczego w szybkiej sieci, np. 10 Gb/s):"
azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G
Tak samo jak powyżej, ale należy użyć 50 000 plików, każdy 8 MiB rozmiar i obliczyć skróty MD5 (w taki sam sposób, jak flaga --put-md5 wykonuje to w poleceniu kopiowania). 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
Uruchamianie testu porównawczego, który pobiera istniejące pliki z miejsca docelowego
azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"
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.