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 bij het downloaden van AzCopy, het maken van verbinding met uw opslagaccount en het overdragen van gegevens.
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 gebruiken van dit artikel.
AzCopy downloaden
Download eerst het uitvoerbare bestand AzCopy V10 naar een map op uw computer. AzCopy V10 is slechts een uitvoerbaar bestand, dus u hoeft niets te installeren.
- Windows 64-bits (zip)
- Windows 32-bits (zip)
- Linux x86-64 (tar)
- Linux ARM64 Preview (tar)
- macOS (zip)
Deze bestanden worden gecomprimeerd als een zip-bestand (Windows en Mac) of een tar-bestand (Linux). Raadpleeg de documentatie voor uw Linux-distributie om het tar-bestand in Linux te downloaden en te decomprimeren.
Zie de azcopy-releasepagina voor gedetailleerde informatie over AzCopy-releases.
Notitie
Als u gegevens wilt kopiëren van en naar 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 typen azcopy
vanuit elke map op uw systeem.
Als u ervoor kiest om de AzCopy-map niet toe te voegen aan uw pad, moet u de mappen wijzigen in de locatie van het uitvoerbare AzCopy-bestand en Windows PowerShell opdrachtprompts typenazcopy
..\azcopy
Als eigenaar van uw Azure Storage-account krijgt u niet automatisch machtigingen voor toegang tot gegevens. Voordat u iets zinvols kunt doen met AzCopy, moet u bepalen hoe u autorisatiereferenties aan de opslagservice verstrekt.
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-opslag (hiërarchische naamruimte) | & SAS Azure AD |
File Storage | Alleen SAS |
Optie 1: Azure Active Directory gebruiken
Deze optie is alleen beschikbaar voor blobopslag. Door Azure Active Directory te gebruiken, kunt u eenmaal referenties opgeven in plaats van een SAS-token toe te voegen aan elke opdracht.
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. Een fictief SAS-token wordt 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 instelling Veilige overdracht vereist 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 voor voorbeelden van opdrachten.
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 Storage |
Help bij de opdracht ophalen
Als u een lijst met opdrachten wilt weergeven, typt azcopy -h
u en drukt u op Enter.
Als u meer wilt weten over een specifieke opdracht, hoeft u alleen de naam van de opdracht op te nemen (bijvoorbeeld: azcopy list -h
).
Lijst met opdrachten
De volgende tabel bevat alle AzCopy v10-opdrachten. Elke opdracht is gekoppeld aan een referentieartikel.
Opdracht | Beschrijving |
---|---|
azcopy bench | Voert een prestatiebenchmark uit door testgegevens te uploaden of te downloaden naar of van een opgegeven locatie. |
azcopy copy | Brongegevens naar een doellocatie kopiëren |
azcopy doc | Hiermee genereert u documentatie voor het hulpprogramma in Markdown-indeling. |
azcopy env | Toont 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 | Toont gedetailleerde informatie voor de opgegeven taak-id. |
azcopy list | Een lijst met de entiteiten in een bepaalde resource. |
azcopy login | Meld u aan bij Azure Active Directory voor toegang tot Azure Storage-resources. |
azcopy-aanmeldingsstatus | Een lijst met 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 | Blobs of bestanden verwijderen uit een Azure-opslagaccount. |
azcopy sync | Repliceert de bronlocatie naar de doellocatie. |
azcopy set-properties | Wijzig de toegangslaag van een of meer blobs en vervang (overschrijf) de metagegevens en indextags van een of meer blobs. |
Notitie
AzCopy heeft geen opdracht om de naam van bestanden te wijzigen.
Gebruiken in een script
Een statische downloadkoppeling verkrijgen
Na verloop van tijd verwijst de AzCopy-downloadkoppeling 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 (onveranderlijke) koppeling naar de huidige versie van AzCopy te verkrijgen. Op die manier downloadt uw script dezelfde exacte versie van AzCopy telkens 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 | (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 |
Notitie
Voor Linux --strip-components=1
wordt met de tar
opdracht de map op het hoogste niveau verwijderd die de versienaam bevat en wordt in plaats daarvan het binaire bestand rechtstreeks in de huidige map geëxtraheerd. Hierdoor kan het script worden bijgewerkt met een nieuwe versie van azcopy
door alleen de wget
URL bij te werken.
De URL wordt weergegeven in de uitvoer van deze opdracht. Uw script kan vervolgens AzCopy downloaden met behulp van die 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
Escape-speciale tekens in SAS-tokens
In batchbestanden die de .cmd
extensie hebben, moet u de %
tekens die in SAS-tokens worden weergegeven, escapen. 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 gebruikt AzCopy om alle gegevensoverdrachtbewerkingen uit te voeren. U kunt Storage Explorer gebruiken als u de prestatievoordelen van AzCopy wilt toepassen, maar u liever een grafische gebruikersinterface gebruikt in plaats van de opdrachtregel om met uw bestanden te werken.
Storage Explorer uw accountsleutel gebruikt om bewerkingen uit te voeren, dus nadat u zich hebt aangemeld bij Storage Explorer, hoeft u geen aanvullende autorisatiereferenties op te geven.
Configureren, optimaliseren en oplossen
Bekijk een van de volgende resources:
Een eerdere versie gebruiken (afgeschaft)
Als u de vorige versie van AzCopy wilt gebruiken, raadpleegt u een van de volgende koppelingen:
Notitie
Deze versies van AzCopy zijn afgeschaft. Microsoft raadt het gebruik van AzCopy v10 aan.
Volgende stappen
Als u vragen, problemen of algemene feedback hebt, kunt u deze indienen op de GitHub-pagina .