Ustawienia konfiguracji narzędzia AzCopy w wersji 10 (Azure Storage)
AzCopy to narzędzie wiersza polecenia, przy użyciu którego można kopiować obiekty blob lub pliki do lub z konta magazynu. Ten artykuł zawiera listę zmiennych środowiskowych, których można użyć do skonfigurowania narzędzia AzCopy w wersji 10.
Uwaga
Jeśli szukasz zawartości ułatwiającej rozpoczęcie pracy z narzędziem AzCopy, zobacz Wprowadzenie do narzędzia AzCopy.
Zmienne środowiskowe narzędzia AzCopy w wersji 10
W poniższej tabeli opisano każdą zmienną środowiskową i podano linki do zawartości, która może pomóc w użyciu zmiennej.
| Zmienna środowiskowa | opis |
|---|---|
| AWS_ACCESS_KEY_ID | Klucz dostępu usług Amazon Web Services. Udostępnia klucz do autoryzowania za pomocą usług Amazon Web Services.Kopiowanie danych z usługi Amazon S3 do usługi Azure Storage przy użyciu narzędzia AzCopy |
| AWS_SECRET_ACCESS_KEY | Klucz dostępu tajnego usługi Amazon Web Services udostępnia klucz tajny do autoryzacji za pomocą usług Amazon Web Services. Kopiowanie danych z usługi Amazon S3 do usługi Azure Storage przy użyciu narzędzia AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Punkt końcowy firmy Microsoft Entra do użycia. Ta zmienna jest używana tylko do automatycznego logowania. Zamiast tego użyj flagi wiersza polecenia podczas wywoływania polecenia logowania. |
| AZCOPY_AUTO_LOGIN_TYPE | Ustaw tę zmienną na DEVICE, , MSI, SPNAZCLIi PSCRED. Ta zmienna umożliwia autoryzowanie bez użycia azcopy login polecenia . Zobacz Autoryzowanie dostępu do obiektów blob za pomocą narzędzia AzCopy i identyfikatora Entra firmy Microsoft. |
| AZCOPY_BUFFER_GB | Określ maksymalną ilość pamięci systemowej, która ma być używana przez narzędzie AzCopy podczas pobierania i przekazywania plików. Wyrażaj tę wartość w gigabajtach (GB). Zobacz Optymalizowanie użycia pamięci |
| AZCOPY_CACHE_PROXY_LOOKUP | Domyślnie narzędzie AzCopy w systemie Windows buforuje wyszukiwania serwerów proxy na poziomie nazwy hosta (nie biorąc pod uwagę ścieżki adresu URL). Ustaw dowolną inną wartość niż "true", aby wyłączyć pamięć podręczną. |
| AZCOPY_CONCURRENCY_VALUE | Określa liczbę współbieżnych żądań, które mogą wystąpić. Tej zmiennej można użyć do zwiększenia przepływności. Jeśli komputer ma mniej niż 5 procesorów CPU, wartość tej zmiennej jest ustawiona na 32wartość . W przeciwnym razie wartość domyślna jest równa 16-krotności liczby procesorów CPU. Maksymalna wartość domyślna tej zmiennej to 3000, ale można ręcznie ustawić tę wartość wyższą lub niższą. Zobacz Zwiększanie współbieżności |
| AZCOPY_CONCURRENT_FILES | Zastępuje (przybliżoną) liczbę plików, które są w toku w dowolnym momencie, kontrolując liczbę plików, dla których jednocześnie inicjujemy transfery. |
| AZCOPY_CONCURRENT_SCAN | Określa stopień równoległości (maksymalny) używany podczas skanowania. Dotyczy tylko równoległych modułów wyliczających, które obejmują usługi Azure Files/Blobs i lokalne systemy plików. |
| AZCOPY_CONTENT_TYPE_MAP | Zastępuje co najmniej jedno domyślne mapowanie typu MIME zdefiniowane przez system operacyjny. Ustaw tę zmienną na ścieżkę pliku JSON, który definiuje dowolne mapowanie. Oto zawartość przykładowego pliku JSON: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Zastępuje wersję interfejsu API usługi, aby narzędzie AzCopy mogło pomieścić środowiska niestandardowe, takie jak Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Dotyczy tylko wtedy, gdy obiekty blob platformy Azure są źródłem. Skanowanie współbieżne jest szybsze, ale korzysta z interfejsu API listy hierarchicznej, co może spowodować zwiększenie liczby operacji we/wy/koszt. Określ wartość "true", aby poświęcić wydajność, ale zaoszczędzić na kosztach. |
| AZCOPY_DISABLE_SYSLOG | Wyłącza rejestrowanie w dzienniku systemowym lub rejestratorze zdarzeń systemu Windows. Domyślnie narzędzie AzCopy wysyła dzienniki do tych kanałów. Tę zmienną można ustawić na wartość true, jeśli chcesz zmniejszyć szum w dzienniku systemowym lub dzienniku zdarzeń systemu Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Konfiguruje narzędzie AzCopy do pobierania do ścieżki tymczasowej przed rzeczywistym pobraniem. Dozwolone wartości są prawdziwe lub fałszywe |
| AZCOPY_JOB_PLAN_LOCATION | Zastępuje pliki planu zadania (używane do śledzenia postępu i wznawiania), aby uniknąć zapełniania dysku. |
| AZCOPY_LOG_LOCATION | Zastępuje miejsce przechowywania plików dziennika, aby uniknąć zapełniania dysku. |
| AZCOPY_MSI_CLIENT_ID | Identyfikator klienta tożsamości zarządzanej przypisanej przez użytkownika. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość MSI. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_MSI_OBJECT_ID | Identyfikator obiektu tożsamości zarządzanej przypisanej przez użytkownika. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość MSI. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_MSI_RESOURCE_STRING | Identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_PACE_PAGE_BLOBS | Czy przepływność stronicowych obiektów blob powinna być automatycznie dopasowywana do limitów usługi? Ustawieniem domyślnym jest true. Ustaw wartość "false", aby wyłączyć |
| AZCOPY_PARALLEL_STAT_FILES | Powoduje, że narzędzie AzCopy wyszukuje właściwości pliku na równoległych "wątkach" podczas skanowania lokalnego systemu plików. Wątki są pobierane z puli zdefiniowanej przez AZCOPY_CONCURRENT_SCAN. Ustawienie wartości true może zwiększyć wydajność skanowania w systemie Linux. Nie jest to wymagane lub zalecane w systemie Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Ustaw liczbę minut, przez które narzędzie AzCopy powinno spróbować przekazać pliki dla każdego żądania przed upływem limitu czasu narzędzia AzCopy. |
| AZCOPY_SHOW_PERF_STATES | W przypadku ustawienia na dowolne dane wyjściowe na ekranie będą zawierać liczby fragmentów według stanu |
| AZCOPY_SPA_APPLICATION_ID | Identyfikator aplikacji rejestracji aplikacji jednostki usługi. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_SPA_CERT_PASSWORD | Hasło certyfikatu. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_SPA_CERT_PATH | Względna lub w pełni kwalifikowana ścieżka do pliku certyfikatu. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_SPA_CLIENT_SECRET | Wpis tajny klienta. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych |
| AZCOPY_TENANT_ID | Identyfikator dzierżawy firmy Microsoft Entra do użycia na potrzeby logowania interakcyjnego urządzenia OAuth. Ta zmienna jest używana tylko do automatycznego logowania. Zamiast tego użyj flagi wiersza polecenia podczas wywoływania polecenia logowania. |
| AZCOPY_TUNE_TO_CPU | Ustaw wartość false, aby zapobiec używaniu procesora CPU przez narzędzie AzCopy podczas automatycznego dostrajania poziomu współbieżności (na przykład w poleceniu testu porównawczego). |
| AZCOPY_USER_AGENT_PREFIX | Dodaj prefiks do domyślnego agenta użytkownika narzędzia AzCopy, który jest używany do celów telemetrycznych. Spacja jest automatycznie wstawiana. |
| CPK_ENCRYPTION_KEY | Wartość klucza szyfrowania AES-256 zakodowana w formacie Base64. Ta zmienna jest wymagana zarówno dla żądań odczytu, jak i zapisu w przypadku używania kluczy dostarczonych przez klienta do szyfrowania i odszyfrowywania danych w operacjach magazynu obiektów blob. Klucze podane przez klienta można użyć, ustawiając flagę --cpk-by-value=true . |
| CPK_ENCRYPTION_KEY_SHA256 | Algorytm SHA256 zakodowany w formacie Base64 klucza szyfrowania. Ta zmienna jest wymagana zarówno dla żądań odczytu, jak i zapisu w przypadku używania kluczy dostarczonych przez klienta do szyfrowania i odszyfrowywania danych w operacjach magazynu obiektów blob. Klucze podane przez klienta można użyć, ustawiając flagę --cpk-by-value=true . |
| GOOGLE_APPLICATION_CREDENTIALS | Ścieżka bezwzględna do pliku klucza konta usługi Udostępnia klucz autoryzacji w usłudze Google Cloud Storage. Kopiowanie danych z usługi Google Cloud Storage do usługi Azure Storage przy użyciu narzędzia AzCopy (wersja zapoznawcza) |
| GOOGLE_CLOUD_PROJECT | Identyfikator projektu wymagany dla przechodzenia na poziomie usług w usłudze Google Cloud Storage. |
| HTTPS_PROXY | Konfiguruje ustawienia serwera proxy dla narzędzia AzCopy. Ustaw tę zmienną na adres IP serwera proxy i numer portu serwera proxy. Na przykład xx.xxx.xx.xxx:xx. Jeśli uruchomisz narzędzie AzCopy w systemie Windows, narzędzie AzCopy automatycznie wykryje ustawienia serwera proxy, dlatego w systemie Windows nie trzeba używać tego ustawienia. Jeśli zdecydujesz się użyć tego ustawienia w systemie Windows, przesłoni ono automatyczne wykrywanie. Zobacz Konfigurowanie ustawień serwera proxy |
Konfigurowanie ustawień serwera proxy
Aby skonfigurować ustawienia serwera proxy dla narzędzia AzCopy, ustaw zmienną HTTPS_PROXY środowiskową. Jeśli uruchomisz narzędzie AzCopy w systemie Windows, narzędzie AzCopy automatycznie wykryje ustawienia serwera proxy, dlatego w systemie Windows nie trzeba używać tego ustawienia. Jeśli zdecydujesz się użyć tego ustawienia w systemie Windows, przesłoni ono automatyczne wykrywanie.
| System operacyjny | Polecenie |
|---|---|
| Windows | W wierszu polecenia użyj polecenia: set HTTPS_PROXY=<proxy IP>:<proxy port>W programie PowerShell użyj: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
obecnie narzędzie AzCopy nie obsługuje serwerów proxy, które wymagają uwierzytelniania przy użyciu protokołu NTLM lub Kerberos.
Pomijanie serwera proxy
Jeśli używasz narzędzia AzCopy w systemie Windows i chcesz poinformować go, aby w ogóle nie używał żadnego serwera proxy (zamiast automatycznego wykrywania ustawień), użyj tych poleceń. Za pomocą tych ustawień narzędzie AzCopy nie wyszuka ani nie spróbuje użyć żadnego serwera proxy.
| System operacyjny | Środowisko | Polecenia |
|---|---|---|
| Windows | Wiersz polecenia (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
W innych systemach operacyjnych po prostu pozostaw zmienną HTTPS_PROXY niezastawioną, jeśli nie chcesz używać serwera proxy.