Wprowadzenie do narzędzia AzCopy

  • Artykuł

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ł ułatwia pobranie narzędzia AzCopy, nawiązanie połączenia z kontem magazynu, a następnie przeniesienie danych.

Uwaga

Narzędzie AzCopy V10 jest obecnie obsługiwaną wersją narzędzia AzCopy.

Jeśli musisz użyć poprzedniej wersji narzędzia AzCopy, zobacz sekcję Korzystanie z poprzedniej wersji narzędzia AzCopy w tym artykule.

Pobierz narzędzie AzCopy

Najpierw pobierz plik wykonywalny narzędzia AzCopy V10 do dowolnego katalogu na komputerze. AzCopy V10 to tylko plik wykonywalny, więc nie ma nic do zainstalowania.

Te pliki są kompresowane jako plik zip (Windows i Mac) lub plik tar (Linux). Aby pobrać i zdekompresować plik tar w systemie Linux, zobacz dokumentację dystrybucji systemu Linux.

Aby uzyskać szczegółowe informacje na temat wydań narzędzia AzCopy, zobacz stronę wydania narzędzia AzCopy.

Uwaga

Jeśli chcesz skopiować dane do i z usługi Azure Table Storage , zainstaluj narzędzie AzCopy w wersji 7.3.

Uruchamianie narzędzia AzCopy

Dla wygody rozważ dodanie lokalizacji katalogu pliku wykonywalnego narzędzia AzCopy do ścieżki systemowej w celu ułatwienia użytkowania. W ten sposób można wpisać azcopy dowolny katalog w systemie.

Jeśli nie chcesz dodawać katalogu AzCopy do ścieżki, musisz zmienić katalogi na lokalizację pliku wykonywalnego narzędzia AzCopy i wpisać azcopy lub .\azcopy w Windows PowerShell wierszach polecenia.

Jako właściciel konta usługi Azure Storage nie masz automatycznie przypisanych uprawnień dostępu do danych. Zanim będzie można wykonać dowolne istotne czynności za pomocą narzędzia AzCopy, musisz zdecydować, jak podać poświadczenia autoryzacji do usługi magazynu.

Autoryzowanie narzędzia AzCopy

Poświadczenia autoryzacji można podać przy użyciu usługi Azure Active Directory (AD) lub tokenu sygnatury dostępu współdzielonego (SAS).

Użyj tej tabeli jako przewodnika:

Typ magazynu Obecnie obsługiwana metoda autoryzacji
Blob Storage sygnatura & dostępu współdzielonego Azure AD
Blob Storage (hierarchiczna przestrzeń nazw) sygnatura & dostępu współdzielonego Azure AD
File Storage Tylko sygnatura dostępu współdzielonego

Opcja 1. Korzystanie z usługi Azure Active Directory

Ta opcja jest dostępna tylko dla usługi Blob Storage. Za pomocą usługi Azure Active Directory można podać poświadczenia raz, zamiast dołączać token SAS do każdego polecenia.

Opcja 2. Używanie tokenu sygnatury dostępu współdzielonego

Token sygnatury dostępu współdzielonego można dołączyć do każdego źródłowego lub docelowego adresu URL, który jest używany w poleceniach narzędzia AzCopy.

To przykładowe polecenie cyklicznie kopiuje dane z katalogu lokalnego do kontenera obiektów blob. Fikcyjny token sygnatury dostępu współdzielonego jest dołączany na końcu adresu URL kontenera.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Aby dowiedzieć się więcej o tokenach SAS i sposobie ich uzyskiwania, zobacz Using shared access signatures (SAS) (Używanie sygnatur dostępu współdzielonego).

Uwaga

Ustawienie Wymagany bezpieczny transfer konta magazynu określa, czy połączenie z kontem magazynu jest zabezpieczone za pomocą protokołu Transport Layer Security (TLS). To ustawienie jest domyślnie włączone.

Transfer danych

Po autoryzowaniu tożsamości lub uzyskaniu tokenu SAS możesz rozpocząć przesyłanie danych.

Aby znaleźć przykładowe polecenia, zobacz dowolny z tych artykułów.

Usługa Artykuł
Azure Blob Storage Przekazywanie plików do magazynu Azure Blob Storage
Azure Blob Storage Pobieranie obiektów blob z Azure Blob Storage
Azure Blob Storage Kopiowanie obiektów blob między kontami magazynu platformy Azure
Azure Blob Storage Synchronizowanie z usługą Azure Blob Storage
Azure Files Transferowanie danych za pomocą narzędzia AzCopy i magazynu plików
Amazon S3 Kopiowanie danych z usługi Amazon S3 do usługi Azure Storage
Google Cloud Storage Kopiowanie danych z usługi Google Cloud Storage do usługi Azure Storage (wersja zapoznawcza)
Magazyn usługi Azure Stack Transferowanie danych za pomocą narzędzia AzCopy i magazynu usługi Azure Stack

Uzyskiwanie pomocy przy użyciu polecenia

Aby wyświetlić listę poleceń, wpisz azcopy -h , a następnie naciśnij klawisz ENTER.

Aby dowiedzieć się więcej o konkretnym poleceniu, wystarczy dołączyć nazwę polecenia (na przykład: azcopy list -h).

Wbudowana pomoc

Lista poleceń

W poniższej tabeli wymieniono wszystkie polecenia narzędzia AzCopy w wersji 10. Każde polecenie łączy się z artykułem referencyjnym.

Polecenie Opis
azcopy bench Uruchamia test porównawczy wydajności, przekazując lub pobierając dane testowe do lub z określonej lokalizacji.
azcopy copy Kopiuje dane źródłowe do lokalizacji docelowej
azcopy doc Generuje dokumentację narzędzia w formacie Markdown.
azcopy env Przedstawia zmienne środowiskowe, które mogą skonfigurować zachowanie narzędzia AzCopy.
azcopy jobs Podpolecenia związane z zarządzaniem zadaniami.
azcopy jobs clean Usuń wszystkie pliki dziennika i planu dla wszystkich zadań.
azcopy jobs list Wyświetla informacje o wszystkich zadaniach.
azcopy jobs remove Usuń wszystkie pliki skojarzone z danym identyfikatorem zadania.
azcopy jobs resume Wznawia istniejące zadanie przy użyciu danego identyfikatora zadania.
azcopy jobs show Przedstawia szczegółowe informacje dotyczące danego identyfikatora zadania.
azcopy list Wyświetla listę jednostek w danym zasobie.
azcopy login Zaloguje się do usługi Azure Active Directory, aby uzyskać dostęp do zasobów usługi Azure Storage.
azcopy login status (stan logowania narzędzia azcopy) Wyświetla listę jednostek w danym zasobie.
azcopy logout Rejestruje użytkownika i kończy dostęp do zasobów usługi Azure Storage.
azcopy make Tworzy kontener lub udział plików.
azcopy remove Usuń obiekty blob lub pliki z konta usługi Azure Storage.
azcopy sync Replikuje lokalizację źródłową do lokalizacji docelowej.
azcopy set-properties Zmień warstwę dostępu co najmniej jednego obiektu blob i zastąp (zastąpić) metadane oraz tagi indeksu co najmniej jednego obiektu blob.

Uwaga

Narzędzie AzCopy nie ma polecenia do zmiany nazwy plików.

Używanie w skrycie

W czasie link pobierania narzędzia AzCopy wskaże nowe wersje narzędzia AzCopy. Jeśli skrypt pobiera narzędzie AzCopy, skrypt może przestać działać, jeśli nowsza wersja narzędzia AzCopy modyfikuje funkcje zależne od skryptu.

Aby uniknąć tych problemów, uzyskaj statyczny (niezmieniający) link do bieżącej wersji narzędzia AzCopy. W ten sposób skrypt pobiera tę samą dokładną wersję narzędzia AzCopy za każdym razem, gdy jest uruchamiany.

Aby uzyskać link, uruchom następujące polecenie:

System operacyjny Polecenie
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux \| grep ^Location
Windows PowerShell (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue).headers.location
PowerShell 6.1+ (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue -SkipHttpErrorCheck).headers.location

Uwaga

W przypadku systemu Linux --strip-components=1 polecenie tar usuwa folder najwyższego poziomu zawierający nazwę wersji, a zamiast tego wyodrębnia plik binarny bezpośrednio do bieżącego folderu. Dzięki temu skrypt może zostać zaktualizowany przy użyciu nowej wersji azcopy , aktualizując wget tylko adres URL.

Adres URL jest wyświetlany w danych wyjściowych tego polecenia. Następnie skrypt może pobrać narzędzie AzCopy przy użyciu tego adresu URL.

Linux

wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1

Windows PowerShell

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\'
$AzCopy = (Get-ChildItem -path '.\' -Recurse -File -Filter 'azcopy.exe').FullName
# Invoke AzCopy 
& $AzCopy

PowerShell 6.1+

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
$AzCopy = (Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\' -PassThru | where-object {$_.Name -eq 'azcopy.exe'}).FullName
# Invoke AzCopy
& $AzCopy

Znaki specjalne ucieczki w tokenach SAS

W plikach wsadowych, które mają .cmd rozszerzenie, należy uciec od % znaków wyświetlanych w tokenach SAS. Możesz to zrobić, dodając dodatkowy % znak obok istniejących % znaków w ciągu tokenu sygnatury dostępu współdzielonego.

Uruchamianie skryptów przy użyciu narzędzia Jenkins

Jeśli planujesz używać narzędzia Jenkins do uruchamiania skryptów, pamiętaj, aby umieścić następujące polecenie na początku skryptu.

/usr/bin/keyctl new_session

Używanie w Eksplorator usługi Azure Storage

Eksplorator usługi Storage używa narzędzia AzCopy do wykonywania wszystkich operacji transferu danych. Możesz użyć Eksplorator usługi Storage, jeśli chcesz zastosować zalety wydajności narzędzia AzCopy, ale wolisz używać graficznego interfejsu użytkownika, a nie wiersza polecenia do interakcji z plikami.

Eksplorator usługi Storage używa klucza konta do wykonywania operacji, więc po zalogowaniu się do Eksplorator usługi Storage nie musisz podawać dodatkowych poświadczeń autoryzacji.

Konfigurowanie, optymalizowanie i naprawianie

Zobacz dowolne z następujących zasobów:

Użyj poprzedniej wersji (przestarzałe)

Jeśli musisz użyć poprzedniej wersji narzędzia AzCopy, zobacz jeden z następujących linków:

Uwaga

Te wersje narzędzia AzCopy są przestarzałe. Firma Microsoft zaleca korzystanie z narzędzia AzCopy w wersji 10.

Następne kroki

Jeśli masz pytania, problemy lub ogólną opinię, prześlij je na stronie usługi GitHub .