Aan de slag met AzCopy

AzCopy is een opdrachtregelprogramma dat u kunt gebruiken om blobs of bestanden vanuit of naar een opslagaccount te kopiëren. Dit artikel helpt u AzCopy te downloaden, verbinding te maken met uw opslagaccount en vervolgens gegevens over te dragen.

Notitie

AzCopy V10 is de momenteel ondersteunde versie van AzCopy.

Als u een eerdere versie van AzCopy wilt gebruiken, raadpleegt u de sectie De vorige versie van AzCopy van dit artikel gebruiken.

AzCopy downloaden

Download eerst het uitvoerbare bestand AzCopy V10 naar een map op uw computer. AzCopy V10 is slechts een uitvoerbaar bestand, dus er is niets te installeren.

Deze bestanden worden gecomprimeerd als een zip-bestand (Windows en Mac) of een tar-bestand (Linux). Als u het tar-bestand op Linux wilt downloaden en decomprimeren, raadpleegt u de documentatie voor uw Linux-distributie.

Zie de releasepagina van AzCopy voor gedetailleerde informatie over AzCopy-releases.

Notitie

Als u gegevens wilt kopiëren naar en van uw Azure Table Storage-service , installeert u AzCopy versie 7.3.

AzCopy uitvoeren

Voor het gemak kunt u de maplocatie van het uitvoerbare AzCopy-bestand toevoegen aan het systeempad. Op die manier kunt u vanuit elke map op uw systeem typen azcopy .

Als u ervoor kiest om de AzCopy-map niet toe te voegen aan uw pad, moet u mappen wijzigen in de locatie van het uitvoerbare AzCopy-bestand en azcopy moet u of .\azcopy in Windows PowerShell opdrachtprompts typen.

Als eigenaar van uw Azure Storage-account worden niet automatisch machtigingen toegewezen voor toegang tot gegevens. Voordat u iets zinvols met AzCopy kunt doen, moet u beslissen hoe u autorisatiereferenties aan de opslagservice opgeeft.

AzCopy autoriseren

U kunt autorisatiereferenties opgeven met behulp van Azure Active Directory (AD) of met behulp van een SAS-token (Shared Access Signature).

Gebruik deze tabel als richtlijn:

Opslagtype Momenteel ondersteunde autorisatiemethode
Blob Storage & SAS Azure AD
Blob Storage (hiërarchische naamruimte) & SAS Azure AD
File Storage Alleen SAS

Optie 1: Azure Active Directory gebruiken

Deze optie is alleen beschikbaar voor blob-Storage. Met behulp van Azure Active Directory kunt u eenmaal referenties opgeven in plaats van een SAS-token aan elke opdracht toe te voegen.

Optie 2: een SAS-token gebruiken

U kunt een SAS-token toevoegen aan elke bron- of doel-URL die wordt gebruikt in uw AzCopy-opdrachten.

Met deze voorbeeldopdracht worden gegevens recursief gekopieerd van een lokale map naar een blobcontainer. Er wordt een fictief SAS-token toegevoegd aan het einde van de container-URL.

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

Zie Shared Access Signatures (SAS) gebruiken voor meer informatie over SAS-tokens en hoe u er een kunt verkrijgen.

Notitie

De vereiste instelling voor veilige overdracht van een opslagaccount bepaalt of de verbinding met een opslagaccount is beveiligd met TLS (Transport Layer Security). Deze instelling is standaard ingeschakeld.

Gegevens overdragen

Nadat u uw identiteit hebt geautoriseerd of een SAS-token hebt verkregen, kunt u beginnen met het overdragen van gegevens.

Zie een van deze artikelen om voorbeeldopdrachten te vinden.

Service Artikel
Azure Blob Storage Bestanden uploaden naar Azure Blob Storage
Azure Blob Storage Blobs downloaden van Azure Blob Storage
Azure Blob Storage Blobs kopiëren tussen Azure-opslagaccounts
Azure Blob Storage Synchroniseren met Azure Blob Storage
Azure Files Gegevens overdragen met AzCopy en bestandsopslag
Amazon S3 Gegevens kopiëren van Amazon S3 naar Azure Storage
Google Cloud Storage Gegevens kopiëren van Google Cloud Storage naar Azure Storage (preview)
Azure Stack-opslag Gegevens overdragen met AzCopy- en Azure Stack-opslag

Help voor opdrachten ophalen

Als u een lijst met opdrachten wilt zien, typt azcopy -h u en drukt u op Enter.

Als u meer wilt weten over een specifieke opdracht, neemt u alleen de naam van de opdracht op (bijvoorbeeld: azcopy list -h).

Inline help

Lijst met opdrachten

De volgende tabel bevat alle AzCopy v10-opdrachten. Elke opdracht bevat koppelingen naar een naslagartikel.

Opdracht Beschrijving
azcopy bench Voert een prestatiebenchmark uit door testgegevens naar of van een opgegeven locatie te uploaden of te downloaden.
azcopy copy Brongegevens naar een doellocatie kopiëren
azcopy doc Genereert documentatie voor het hulpprogramma in Markdown-indeling.
azcopy env Hier ziet u de omgevingsvariabelen die het gedrag van AzCopy kunnen configureren.
azcopy jobs Subopdrachten met betrekking tot het beheren van taken.
azcopy jobs clean Verwijder alle logboek- en planbestanden voor alle taken.
azcopy jobs list Geeft informatie weer over alle taken.
azcopy jobs remove Verwijder alle bestanden die zijn gekoppeld aan de opgegeven taak-id.
azcopy jobs resume Hervat de bestaande taak met de opgegeven taak-id.
azcopy jobs show Geeft gedetailleerde informatie weer voor de opgegeven taak-id.
azcopy jobs Subopdrachten met betrekking tot het beheren van taken.
azcopy list Geeft een lijst weer van de entiteiten in een bepaalde resource.
azcopy login Meldt u aan bij Azure Active Directory voor toegang tot Azure Storage resources.
azcopy login status Geeft een lijst weer van de entiteiten in een bepaalde resource.
azcopy logout Hiermee wordt de gebruiker afgelogd en wordt de toegang tot Azure Storage resources beëindigd.
azcopy make Hiermee maakt u een container of bestandsshare.
azcopy remove Verwijder blobs of bestanden uit een Azure-opslagaccount.
azcopy sync Repliceert de bronlocatie naar de doellocatie.

Notitie

AzCopy heeft geen opdracht om de naam van bestanden te wijzigen.

Gebruiken in een script

Na verloop van tijd verwijst de downloadkoppeling van AzCopy naar nieuwe versies van AzCopy. Als uw script AzCopy downloadt, werkt het script mogelijk niet meer als een nieuwere versie van AzCopy functies wijzigt waarvan uw script afhankelijk is.

U kunt deze problemen voorkomen door een statische (onveranderbare) koppeling naar de huidige versie van AzCopy op te halen. Op die manier downloadt uw script steeds dezelfde exacte versie van AzCopy wanneer het wordt uitgevoerd.

Voer deze opdracht uit om de koppeling te verkrijgen:

Besturingssysteem Opdracht
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
Windows (PowerShell Core 7) (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue -SkipHttpErrorCheck).headers.location[0]
Windows (PowerShell 5.1) (Invoke-WebRequest https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue ).headers.location

Notitie

Voor Linux --strip-components=1 verwijdert u met de opdracht de tar map op het hoogste niveau die de versienaam bevat en wordt het binaire bestand in plaats daarvan rechtstreeks in de huidige map geëxtraheerd. Hierdoor kan het script worden bijgewerkt met een nieuwe versie door azcopy alleen de wget URL bij te werken.

De URL wordt weergegeven in de uitvoer van deze opdracht. Uw script kan AzCopy vervolgens downloaden met behulp van die URL.

Besturingssysteem Opdracht
Linux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
Windows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

Escape speciale tekens in SAS-tokens

In batchbestanden met de .cmd extensie moet u ontsnappen aan de % tekens die worden weergegeven in SAS-tokens. U kunt dit doen door een extra % teken toe te voegen naast bestaande % tekens in de SAS-tokentekenreeks.

Scripts uitvoeren met Behulp van Jenkins

Als u van plan bent om Jenkins te gebruiken om scripts uit te voeren, moet u de volgende opdracht aan het begin van het script plaatsen.

/usr/bin/keyctl new_session

Gebruiken in Azure Storage Explorer

Storage Explorer AzCopy gebruikt om alle bewerkingen voor gegevensoverdracht uit te voeren. U kunt Storage Explorer gebruiken als u de prestatievoordelen van AzCopy wilt benutten, maar u liever een grafische gebruikersinterface gebruikt in plaats van de opdrachtregel om met uw bestanden te communiceren.

Storage Explorer uw accountsleutel gebruikt om bewerkingen uit te voeren. Nadat u zich bij Storage Explorer hebt aangemeld, hoeft u geen aanvullende autorisatiereferenties op te geven.

Configureren, optimaliseren en oplossen

Bekijk een van de volgende resources:

Een eerdere versie gebruiken

Als u de vorige versie van AzCopy wilt gebruiken, raadpleegt u een van de volgende koppelingen:

Volgende stappen

Als u vragen, problemen of algemene feedback hebt, dient u deze in op GitHub pagina.