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 verbinden met uw opslag account en het overdragen van bestanden.
Notitie
AzCopy V10 is de momenteel ondersteunde versie van AzCopy.
Als u een eerdere versie van AzCopy wilt gebruiken, zie dan de sectie De vorige versie van AzCopy gebruiken van dit artikel.
AzCopy downloaden
Download eerst het uitvoerbare AzCopy V10-bestand naar een map op uw computer. AzCopy V10 is slechts een uitvoerbaar bestand, dus u kunt niets installeren.
- Windows 64-bits (zip)
- Windows 32-bits (zip)
- Linux x86-64 (tar)
- macOS (zip)
Deze bestanden worden gecomprimeerd als een ZIP-bestand (Windows mac) of een TAR-bestand (Linux). Als u het TAR-bestand in Linux wilt downloaden en decomprimeren, bekijkt u de documentatie voor uw Linux-distributie.
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 azcopy vanuit elke map op uw systeem typen.
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 typt u of azcopy in Windows PowerShell opdrachtprompts. .\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 beslissen hoe u autorisatiereferenties aan de opslagservice verstrekt.
AzCopy machtigen
U kunt autorisatiereferenties verstrekken met behulp van Azure Active Directory (AD) of met behulp van een Shared Access Signature -token (SAS).
Gebruik deze tabel als richtlijn:
| Opslagtype | Momenteel ondersteunde autorisatiemethode |
|---|---|
| Blob Storage | Azure AD en SAS |
| Blob Storage (hiërarchische naamruimte) | Azure AD en SAS |
| File Storage | Alleen SAS |
Optie 1: Azure Active Directory
Deze optie is alleen beschikbaar voor Storage blobs. Met behulp Azure Active Directory kunt u referenties eenmaal verstrekken in plaats van een SAS-token aan elke opdracht te moeten geven.
Notitie
Als u in de huidige release blobs wilt kopiëren tussen opslagaccounts, moet u een SAS-token toevoegen aan elke bron-URL. U kunt het SAS-token alleen weglaten uit de doel-URL. Zie Blobs kopiëren tussen opslagaccounts voor voorbeelden.
Zie Toegang tot blobs machtigen met AzCopy en Azure Active Directory (Azure AD) omtoegang te verlenen met behulp van Azure AD.
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 Using Shared Access Signatures (SAS) (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 wordt beveiligd met Transport Layer Security (TLS). 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 voorbeeldopdrachten.
| 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 |
Hulp bij opdrachten krijgen
Typ en druk op enter om een lijst met opdrachten azcopy -h weer te geven.
Neem voor meer informatie over een specifieke opdracht alleen de naam van de opdracht op (bijvoorbeeld: azcopy list -h ).
Lijst met opdrachten
De volgende tabel bevat alle AzCopy v10-opdrachten. Elke opdracht is een koppeling 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 | Kopieert brongegevens naar een doellocatie |
| azcopy doc | Genereert documentatie voor het hulpprogramma in Markdown-indeling. |
| azcopy env | Toont de omgevingsvariabelen die het gedrag van AzCopy kunnen configureren. |
| azcopy jobs | Subtaken 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 load | Subcommands met betrekking tot het overdragen van gegevens in specifieke indelingen. |
| azcopy load clfs | Brengt lokale gegevens over naar een container en slaat deze op in de INDELING Avere Cloud FileSystem (CLFS) van Microsoft. |
| azcopy list | Hiermee worden de entiteiten in een bepaalde resource vermeld. |
| azcopy login | Meldt u aan bij Azure Active Directory toegang tot Azure Storage resources. |
| azcopy logout | Registreert de gebruiker en beëindigt de toegang tot Azure Storage resources. |
| azcopy make | Hiermee maakt u een container of bestands share. |
| 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
Een statische downloadkoppeling verkrijgen
Na een periode zal de AzCopy-downloadkoppeling verwijzen naar nieuwe versies van AzCopy. Als uw script AzCopy downloadt, werkt het script mogelijk niet meer als een nieuwere versie van AzCopy functies wijzigt die afhankelijk zijn van uw script.
Om deze problemen te voorkomen, haalt u een statische (ongewijzigde) koppeling op naar de huidige versie van AzCopy. Op die manier downloadt uw script steeds dezelfde exacte versie van AzCopy wanneer het wordt uitgevoerd.
Voer de volgende opdracht uit om de koppeling te verkrijgen:
| Besturingssysteem | Opdracht |
|---|---|
| Linux | curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location |
| Windows | (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location |
Notitie
Voor Linux verwijdert u met de opdracht de map op het hoogste niveau die de versienaam bevat en extraheert u in plaats daarvan het binaire bestand --strip-components=1 rechtstreeks in de huidige tar map. Hierdoor kan het script worden bijgewerkt met een nieuwe versie van door azcopy alleen de URL bij te wget werken.
De URL wordt weergegeven in de uitvoer van deze opdracht. Uw script kan vervolgens AzCopy 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>> |
Speciale tekens escapen in SAS-tokens
In batchbestanden die de extensie hebben, moet u de tekens die worden weergegeven .cmd % in SAS-tokens escapen. U kunt dit doen door een extra teken toe % te voegen naast bestaande tekens in de tekenreeks van het % SAS-token.
Scripts uitvoeren met Jenkins
Als u Jenkins wilt 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 bewerkingen voor gegevensoverdracht uit te voeren. U kunt Storage Explorer gebruiken als u gebruik wilt maken van de prestatievoordelen van AzCopy, maar u liever een grafische gebruikersinterface gebruikt in plaats van de opdrachtregel om met uw bestanden te communiceren.
Storage Explorer gebruikt uw accountsleutel om bewerkingen uit te voeren, dus nadat u zich hebt Storage Explorer, hoeft u geen aanvullende autorisatiereferenties op te geven.
Configureren, optimaliseren en oplossen
Zie een van de volgende resources:
Een eerdere versie gebruiken
Als u de vorige versie van AzCopy wilt gebruiken, bekijkt u een van de volgende koppelingen:
Volgende stappen
Als u vragen, problemen of algemene feedback hebt, kunt u deze indienen op GitHub pagina.