Gegevens overdragen met AzCopy v8.1 in Windows

Artikel
01/03/2019

AzCopy is een opdrachtregelprogramma dat is ontworpen voor het kopiëren van gegevens naar/van Microsoft Azure Blob-, Bestands- en Tabelopslag, met behulp van eenvoudige opdrachten die zijn ontworpen voor optimale prestaties. U kunt gegevens tussen een bestandssysteem en een opslagaccount of tussen opslagaccounts kopiëren.

Belangrijk

In dit artikel wordt een oudere versie van AzCopy beschreven. Zie AzCopy v10 als u de meest recente versie van AzCopy wilt installeren.

Als u ervoor kiest om de oudere versie van AzCopy (AzCopy v8.1) te installeren, kunt u meerdere versies downloaden. AzCopy in Windows biedt opdrachtregelopties in Windows-stijl. AzCopy op Linux is gericht op Linux-platforms met opdrachtregelopties in POSIX-stijl. Dit artikel heeft betrekking op AzCopy in Windows.

AzCopy (v8.1) downloaden en installeren in Windows

Download AzCopy (v8.1) in Windows.

Opmerkingen bij de release van AzCopy in Windows 8.1

Tabelservice wordt niet meer ondersteund in de nieuwste versie. Als u de functie Tabelexport gebruikt, downloadt u versie AzCopy 7.3.
Gebouwd met .NET Core 2.1 en alle .NET Core-afhankelijkheden worden nu in de installatie verpakt.
Ondersteuning voor OAuth-verificatie toegevoegd. Gebruik azcopy login om u aan te melden met behulp van Azure Active Directory.

Azcopy met table-ondersteuning (v7.3)

Download azcopy 7.3 met ondersteuning voor tabellen.

Stap na installatie

Nadat u AzCopy in Windows hebt geïnstalleerd met behulp van het installatieprogramma, opent u een opdrachtvenster en navigeert u naar de AzCopy-installatiemap op uw computer, waar het AzCopy.exe uitvoerbare bestand zich bevindt. Indien gewenst kunt u de AzCopy-installatielocatie toevoegen aan uw systeempad. AzCopy wordt standaard geïnstalleerd in %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy of %ProgramFiles%\Microsoft SDKs\Azure\AzCopy.

Uw eerste AzCopy-opdracht schrijven

De basissyntaxis voor AzCopy-opdrachten is:

AzCopy /Source:<source> /Dest:<destination> [Options]

In de volgende voorbeelden ziet u diverse scenario's voor het kopiëren van gegevens van en naar Microsoft Azure Blobs, Files en Tables. Raadpleeg de sectie AzCopy-parameters voor een gedetailleerde uitleg van de parameters die in elk voorbeeld worden gebruikt.

Blobs downloaden uit Blob Storage

Laten we eens kijken naar verschillende manieren om blobs te downloaden met AzCopy.

Eén blob downloaden

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

Als de map C:\myfolder niet bestaat, wordt deze door AzCopy gemaakt en gedownload abc.txt naar de nieuwe map.

Eén blob downloaden uit de secundaire regio

AzCopy /Source:https://myaccount-secondary.blob.core.windows.net/mynewcontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

Houd er rekening mee dat geografisch redundante opslag met leestoegang moet zijn ingeschakeld om toegang te krijgen tot de secundaire regio.

Alle blobs in een container downloaden

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /S

Stel dat de volgende blobs zich in de opgegeven container bevinden:

abc.txt
abc1.txt
abc2.txt
vd1\a.txt
vd1\abcd.txt

Na de downloadbewerking bevat de map C:\myfolder de volgende bestanden:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\vd1\a.txt
C:\myfolder\vd1\abcd.txt

Als u de optie /Sniet opgeeft, worden er geen blobs gedownload.

Blobs met een specifiek voorvoegsel downloaden

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:a /S

Stel dat de volgende blobs zich in de opgegeven container bevinden. Alle blobs die beginnen met het voorvoegsel a worden gedownload:

abc.txt
abc1.txt
abc2.txt
xyz.txt
vd1\a.txt
vd1\abcd.txt

Na de downloadbewerking bevat de map C:\myfolder de volgende bestanden:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

Het voorvoegsel is van toepassing op de virtuele map, die het eerste deel van de blobnaam vormt. In het bovenstaande voorbeeld komt de virtuele map niet overeen met het opgegeven voorvoegsel, zodat deze niet wordt gedownload. Als de optie /S niet is opgegeven, downloadt AzCopy bovendien geen blobs.

De tijd van de laatste wijziging van geëxporteerde bestanden instellen op dezelfde als de bron-blobs

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT

U kunt ook blobs uitsluiten van de downloadbewerking op basis van het tijdstip van de laatste wijziging. Als u bijvoorbeeld blobs wilt uitsluiten waarvan de laatste wijzigingstijd hetzelfde of nieuwer is dan het doelbestand, voegt u de /XN optie toe:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XN

Als u blobs wilt uitsluiten waarvan de laatste wijzigingstijd gelijk is aan of ouder is dan het doelbestand, voegt u de optie toe /XO :

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XO

Blobs uploaden naar Blob Storage

Laten we eens kijken naar verschillende manieren om blobs te uploaden met behulp van AzCopy.

Eén blob uploaden

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:"abc.txt"

Als de opgegeven doelcontainer niet bestaat, wordt deze door AzCopy gemaakt en wordt het bestand erin geüpload.

Eén blob uploaden naar een virtuele map

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer/vd /DestKey:key /Pattern:abc.txt

Als de opgegeven virtuele map niet bestaat, uploadt AzCopy het bestand om de virtuele map op te nemen in de naam (bijvoorbeeldvd/abc.txt in het bovenstaande voorbeeld).

Alle blobs in een map uploaden

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /S

Als u de optie /S opgeeft, wordt de inhoud van de opgegeven map recursief geüpload naar blobopslag, wat betekent dat alle submappen en hun bestanden ook worden geüpload. Stel dat de volgende bestanden zich in de map C:\myfolderbevinden:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

Na de uploadbewerking bevat de container de volgende bestanden:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

Als u de optie /Sniet opgeeft, uploadt AzCopy niet recursief. Na de uploadbewerking bevat de container de volgende bestanden:

abc.txt
abc1.txt
abc2.txt

Blobs uploaden die overeenkomen met een specifiek patroon

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:a* /S

Stel dat de volgende bestanden zich in de map C:\myfolderbevinden:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\xyz.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

Na de uploadbewerking bevat de container de volgende bestanden:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

Als u de optie /Sniet opgeeft, uploadt AzCopy alleen blobs die zich niet in een virtuele map bevinden:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

Het MIME-inhoudstype van een doel-blob opgeven

Standaard stelt AzCopy het inhoudstype van een doel-blob in op application/octet-stream. Vanaf versie 3.1.0 kunt u het inhoudstype expliciet opgeven via de optie /SetContentType:[content-type]. Met deze syntaxis wordt het inhoudstype voor alle blobs in een uploadbewerking ingesteld.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType:video/mp4

Als u opgeeft /SetContentType zonder een waarde, wordt in AzCopy het inhoudstype van elke blob of elk bestand ingesteld op basis van de bestandsextensie.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType

Blobs kopiëren in Blob Storage

Laten we eens kijken naar verschillende manieren om blobs van de ene locatie naar de andere te kopiëren met behulp van AzCopy.

Eén blob kopiëren van de ene container naar een andere binnen hetzelfde opslagaccount

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceKey:key /DestKey:key /Pattern:abc.txt

Wanneer u een blob in een opslagaccount kopieert, wordt er een kopieerbewerking aan de serverzijde uitgevoerd.

Eén blob kopiëren van het ene opslagaccount naar het andere

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

Wanneer u een blob kopieert tussen opslagaccounts, wordt er een kopieerbewerking aan de serverzijde uitgevoerd.

Eén blob kopiëren van de secundaire regio naar de primaire regio

AzCopy /Source:https://myaccount1-secondary.blob.core.windows.net/mynewcontainer1 /Dest:https://myaccount2.blob.core.windows.net/mynewcontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

Houd er rekening mee dat geografisch redundante opslag met leestoegang moet zijn ingeschakeld om toegang te krijgen tot secundaire opslag.

Eén blob en de bijbehorende momentopnamen van het ene opslagaccount naar het andere kopiëren

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt /Snapshot

Na de kopieerbewerking bevat de doelcontainer de blob en de bijbehorende momentopnamen. Ervan uitgaande dat de blob in het bovenstaande voorbeeld twee momentopnamen heeft, bevat de container de volgende blob en momentopnamen:

abc.txt
abc (2013-02-25 080757).txt
abc (2014-02-21 150331).txt

Alle blobs in een container naar een ander opslagaccount kopiëren

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 
/Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /S

Als u optie /S opgeeft, wordt de inhoud van de opgegeven container recursief geüpload. Zie Alle blobs in een map uploaden voor meer informatie en een voorbeeld.

Blobs synchroon kopiëren van het ene opslagaccount naar het andere

AzCopy kopieert standaard asynchroon gegevens tussen twee opslageindpunten. Daarom wordt de kopieerbewerking op de achtergrond uitgevoerd met een capaciteit voor reservebandbreedte die geen SLA heeft wat betreft de snelheid waarmee een blob wordt gekopieerd. AzCopy controleert de kopieerstatus regelmatig totdat het kopiëren is voltooid of mislukt.

De /SyncCopy optie zorgt ervoor dat de kopieerbewerking een consistente snelheid krijgt. AzCopy voert de synchrone kopie uit door de blobs te downloaden die moeten worden gekopieerd van de opgegeven bron naar het lokale geheugen en deze vervolgens te uploaden naar de blobopslagbestemming.

AzCopy /Source:https://myaccount1.blob.core.windows.net/myContainer/ /Dest:https://myaccount2.blob.core.windows.net/myContainer/ /SourceKey:key1 /DestKey:key2 /Pattern:ab /SyncCopy

/SyncCopy kan extra kosten voor uitgaand verkeer genereren in vergelijking met asynchrone kopieën. De aanbevolen aanpak is om deze optie te gebruiken op een Azure-VM die zich in dezelfde regio bevindt als uw bronopslagaccount om uitgaande kosten te voorkomen.

Bestanden downloaden uit File Storage

Laten we eens kijken naar verschillende manieren om bestanden te downloaden met AzCopy.

Eén bestand downloaden

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/myfolder1/ /Dest:C:\myfolder /SourceKey:key /Pattern:abc.txt

Als de opgegeven bron een Azure-bestandsshare is, moet u de exacte bestandsnaam opgeven (bijvoorbeeldabc.txt) om één bestand te downloaden of de optie /S opgeven om alle bestanden in de share recursief te downloaden. Als u een bestandspatroon en een optie /S samen probeert op te geven, resulteert dit in een fout.

Alle bestanden in een map downloaden

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/ /Dest:C:\myfolder /SourceKey:key /S

Houd er rekening mee dat lege mappen niet worden gedownload.

Laten we eens kijken naar verschillende manieren om bestanden te uploaden met behulp van AzCopy.

Eén bestand uploaden

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:abc.txt

Alle bestanden in een map uploaden

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /S

Houd er rekening mee dat lege mappen niet worden geüpload.

Bestanden uploaden die overeenkomen met een specifiek patroon

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:ab* /S

Bestanden kopiëren in File Storage

Laten we eens kijken naar verschillende manieren om bestanden te kopiëren in een Azure-bestandsshare met behulp van AzCopy.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S

Wanneer u een bestand tussen bestandsshares kopieert, wordt er een kopieerbewerking aan de serverzijde uitgevoerd.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare/ /Dest:https://myaccount2.blob.core.windows.net/mycontainer/ /SourceKey:key1 /DestKey:key2 /S

Wanneer u een bestand van een bestandsshare naar een blob kopieert, wordt er een kopieerbewerking aan de serverzijde uitgevoerd.

AzCopy /Source:https://myaccount1.blob.core.windows.net/mycontainer/ /Dest:https://myaccount2.file.core.windows.net/myfileshare/ /SourceKey:key1 /DestKey:key2 /S

Wanneer u een bestand van een blob naar een bestandsshare kopieert, wordt een kopieerbewerking aan de serverzijde uitgevoerd.

Bestanden synchroon kopiëren

U kunt de /SyncCopy optie opgeven om gegevens te kopiëren van File Storage naar File Storage, van File Storage naar Blob Storage en van Blob Storage naar File Storage synchroon. AzCopy doet dit door de brongegevens te downloaden naar het lokale geheugen en opnieuw te uploaden naar het doel. Standaardkosten voor uitgaand verkeer zijn van toepassing.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S /SyncCopy

Bij het kopiëren van File Storage naar Blob Storage is het standaard blobtype blok-blob; de gebruiker kan de optie /BlobType:page opgeven om het doel-blobtype te wijzigen.

Houd er rekening mee dat /SyncCopy er extra kosten voor uitgaand verkeer kunnen ontstaan in vergelijking met asynchrone kopieën. De aanbevolen aanpak is om deze optie te gebruiken in de Azure-VM die zich in dezelfde regio bevindt als uw bronopslagaccount om uitgaande kosten te voorkomen.

Gegevens exporteren uit Table Storage

Laten we eens kijken naar het exporteren van gegevens uit Azure Table Storage met behulp van AzCopy.

Een tabel exporteren

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key

AzCopy schrijft een manifestbestand naar de opgegeven doelmap. Het manifestbestand wordt gebruikt in het importproces om de benodigde gegevensbestanden te vinden en gegevensvalidatie uit te voeren. Het manifestbestand gebruikt standaard de volgende naamconventie:

<account name>_<table name>_<timestamp>.manifest

De gebruiker kan ook de optie /Manifest:<manifest file name> opgeven om de naam van het manifestbestand in te stellen.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /Manifest:abc.manifest

Een export van Table Storage splitsen in meerdere bestanden

AzCopy /Source:https://myaccount.table.core.windows.net/mytable/ /Dest:C:\myfolder /SourceKey:key /S /SplitSize:100

AzCopy gebruikt een volume-index in de namen van gesplitste gegevensbestanden om meerdere bestanden te onderscheiden. De volume-index bestaat uit twee delen, een partitiesleutelbereikindex en een index voor gesplitste bestanden. Beide indexen zijn gebaseerd op nul.

De index van het partitiesleutelbereik is 0 als de gebruiker de optie /PKRSniet opgeeft.

Stel dat AzCopy twee gegevensbestanden genereert nadat de gebruiker de optie /SplitSizeheeft opgegeven. De resulterende namen van gegevensbestanden kunnen zijn:

myaccount_mytable_20140903T051850.8128447Z_0_0_C3040FE8.json
myaccount_mytable_20140903T051850.8128447Z_0_1_0AB9AC20.json

Houd er rekening mee dat de minimaal mogelijke waarde voor de optie /SplitSize 32 MB is. Als blobopslag de opgegeven bestemming is, splitst AzCopy het gegevensbestand zodra de blobgroottelimiet (200 GB) is bereikt, ongeacht of de optie /SplitSize is opgegeven door de gebruiker.

Een tabel exporteren naar JSON- of CSV-gegevensbestandsindeling

Standaard exporteert AzCopy tabellen naar JSON-gegevensbestanden. U kunt de optie /PayloadFormat:JSON|CSV opgeven voor het exporteren van de tabellen als JSON of CSV.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PayloadFormat:CSV

Bij het opgeven van de indeling van de CSV-nettolading genereert AzCopy ook een schemabestand met bestandsextensie .schema.csv voor elk gegevensbestand.

Tabelentiteiten gelijktijdig exporteren

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PKRS:"aa#bb"

AzCopy start gelijktijdige bewerkingen om entiteiten te exporteren wanneer de gebruiker de optie /PKRSopgeeft. Elke bewerking exporteert één partitiesleutelbereik.

Houd er rekening mee dat het aantal gelijktijdige bewerkingen ook wordt bepaald door de optie /NC. AzCopy gebruikt het aantal kernprocessors als de standaardwaarde van bij het kopiëren van /NC tabelentiteiten, zelfs als /NC dit niet is opgegeven. Wanneer de gebruiker de optie /PKRSopgeeft, gebruikt AzCopy de kleinste van de twee waarden ( partitiesleutelbereiken versus impliciet of expliciet opgegeven gelijktijdige bewerkingen ) om het aantal gelijktijdige bewerkingen te bepalen dat moet worden gestart. Typ voor meer informatie AzCopy /?:NC op de opdrachtregel.

Een tabel exporteren naar Blob Storage

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:https://myaccount.blob.core.windows.net/mycontainer/ /SourceKey:key1 /Destkey:key2

AzCopy genereert een JSON-gegevensbestand in de blobcontainer met de volgende naamconventie:

<account name>_<table name>_<timestamp>_<volume index>_<CRC>.json

Het gegenereerde JSON-gegevensbestand volgt de nettoladingindeling voor minimale metagegevens. Zie Payload Format for Table Service Operations (Nettoladingindeling voor tabelservicebewerkingen) voor meer informatie over deze nettoladingindeling.

Houd er rekening mee dat wanneer u tabellen exporteert naar blobs, AzCopy de tabelentiteiten downloadt naar lokale tijdelijke gegevensbestanden en deze entiteiten vervolgens uploadt naar de blob. Deze tijdelijke gegevensbestanden worden met het standaardpad%LocalAppData%\Microsoft\Azure\AzCopy in de map van het logboekbestand geplaatst. U kunt de optie /Z:[journal-file-folder] opgeven om de locatie van de logboekbestandsmap te wijzigen en zo de locatie van de tijdelijke gegevensbestanden te wijzigen. De grootte van de tijdelijke gegevensbestanden wordt bepaald door de grootte van de tabelentiteiten en de grootte die u hebt opgegeven met de optie /SplitSize, hoewel het tijdelijke gegevensbestand op de lokale schijf direct wordt verwijderd zodra het naar de blob is geüpload, moet u ervoor zorgen dat u voldoende lokale schijfruimte hebt om deze tijdelijke gegevensbestanden op te slaan voordat ze worden verwijderd.

Gegevens importeren in Table Storage

Laten we eens kijken naar het importeren van gegevens in Azure Table Storage met behulp van AzCopy.

Een tabel importeren

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.core.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace

De optie /EntityOperation geeft aan hoe entiteiten in de tabel moeten worden ingevoegd. Mogelijke waarden zijn:

InsertOrSkip: Slaat een bestaande entiteit over of voegt een nieuwe entiteit in als deze niet in de tabel bestaat.
InsertOrMerge: voegt een bestaande entiteit samen of voegt een nieuwe entiteit in als deze niet in de tabel bestaat.
InsertOrReplace: Vervangt een bestaande entiteit of voegt een nieuwe entiteit in als deze niet in de tabel bestaat.

Houd er rekening mee dat u geen optie /PKRS kunt opgeven in het importscenario. In tegenstelling tot het exportscenario, waarin u de optie /PKRS moet opgeven om gelijktijdige bewerkingen te starten, start AzCopy standaard gelijktijdige bewerkingen wanneer u een tabel importeert. Het standaardaantal gelijktijdig gestarte bewerkingen is gelijk aan het aantal kernprocessors; U kunt echter een ander aantal gelijktijdige opties opgeven met de optie /NC. Typ voor meer informatie AzCopy /?:NC op de opdrachtregel.

Houd er rekening mee dat AzCopy alleen ondersteuning biedt voor het importeren voor JSON, niet voor CSV. AzCopy biedt geen ondersteuning voor het importeren van tabellen uit door de gebruiker gemaakte JSON- en manifestbestanden. Beide bestanden moeten afkomstig zijn van een AzCopy-tabelexport. Wijzig het geëxporteerde JSON- of manifestbestand niet om fouten te voorkomen.

Entiteiten importeren in een tabel vanuit Blob Storage

Stel dat een blobcontainer het volgende bevat: een JSON-bestand dat een Azure-tabel en het bijbehorende manifestbestand vertegenwoordigt.

myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json

U kunt de volgende opdracht uitvoeren om entiteiten in een tabel te importeren met behulp van het manifestbestand in die blobcontainer:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:https://myaccount.table.core.windows.net/mytable /SourceKey:key1 /DestKey:key2 /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:"InsertOrReplace"

Andere AzCopy-functies

Laten we eens kijken naar enkele andere AzCopy-functies.

Alleen gegevens kopiëren die niet bestaan in de bestemming

Met de /XO parameters en /XN kunt u respectievelijk oudere of nieuwere bronresources uitsluiten van het kopiëren. Als u alleen bronresources wilt kopiëren die niet in het doel aanwezig zijn, kunt u beide parameters opgeven in de AzCopy-opdracht:

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /XO /XN

/Source:C:\myfolder /Dest:http://myaccount.file.core.windows.net/myfileshare /DestKey:<destkey> /S /XO /XN

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:http://myaccount.blob.core.windows.net/mycontainer1 /SourceKey:<sourcekey> /DestKey:<destkey> /S /XO /XN

Houd er rekening mee dat dit niet wordt ondersteund wanneer de bron of het doel een tabel is.

Een antwoordbestand gebruiken om opdrachtregelparameters op te geven

AzCopy /@:"C:\responsefiles\copyoperation.txt"

U kunt alle AzCopy-opdrachtregelparameters opnemen in een antwoordbestand. AzCopy verwerkt de parameters in het bestand alsof ze zijn opgegeven op de opdrachtregel, waarbij een directe vervanging door de inhoud van het bestand wordt uitgevoerd.

Ga uit van een antwoordbestand met de naam copyoperation.txt, dat de volgende regels bevat. Elke AzCopy-parameter kan op één regel worden opgegeven

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

of op afzonderlijke regels:

/Source:http://myaccount.blob.core.windows.net/mycontainer
/Dest:C:\myfolder
/SourceKey:<sourcekey>
/S
/Y

AzCopy mislukt als u de parameter over twee regels splitst, zoals hier wordt weergegeven voor de /sourcekey parameter:

http://myaccount.blob.core.windows.net/mycontainer
 C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y

Meerdere antwoordbestanden gebruiken om opdrachtregelparameters op te geven

Stel dat een antwoordbestand met de naam source.txt een broncontainer opgeeft:

/Source:http://myaccount.blob.core.windows.net/mycontainer

En een antwoordbestand met de naam dest.txt dat een doelmap in het bestandssysteem aangeeft:

/Dest:C:\myfolder

En een antwoordbestand met de naam options.txt waarin opties voor AzCopy worden opgegeven:

/S /Y

Als u AzCopy wilt aanroepen met deze antwoordbestanden, die zich allemaal in een map C:\responsefilesbevinden, gebruikt u deze opdracht:

AzCopy /@:"C:\responsefiles\source.txt" /@:"C:\responsefiles\dest.txt" /SourceKey:<sourcekey> /@:"C:\responsefiles\options.txt"

AzCopy verwerkt deze opdracht op dezelfde als wanneer u alle afzonderlijke parameters op de opdrachtregel opgeeft:

AzCopy /Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

Een Shared Access Signature (SAS) opgeven

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceSAS:SAS1 /DestSAS:SAS2 /Pattern:abc.txt

U kunt ook een SAS opgeven voor de container-URI:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1/?SourceSASToken /Dest:C:\myfolder /S

Logboek bestandsmap

Telkens wanneer u een opdracht uitgeeft aan AzCopy, wordt gecontroleerd of er een logboekbestand in de standaardmap bestaat of dat het bestaat in een map die u via deze optie hebt opgegeven. Als het logboekbestand niet op een van beide plaatsen bestaat, behandelt AzCopy de bewerking als nieuw en wordt er een nieuw logboekbestand gegenereerd.

Als het logboekbestand bestaat, controleert AzCopy of de opdrachtregel die u invoert overeenkomt met de opdrachtregel in het logboekbestand. Als de twee opdrachtregels overeenkomen, wordt de onvolledige bewerking hervat in AzCopy. Als ze niet overeenkomen, wordt u gevraagd het logboekbestand te overschrijven om een nieuwe bewerking te starten of de huidige bewerking te annuleren.

Als u de standaardlocatie voor het logboekbestand wilt gebruiken:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z

Als u de optie /Zweglaat of een optie /Z opgeeft zonder het mappad, zoals hierboven wordt weergegeven, maakt AzCopy het logboekbestand op de standaardlocatie, namelijk %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy. Als het logboekbestand al bestaat, hervat AzCopy de bewerking op basis van het logboekbestand.

Als u een aangepaste locatie voor het logboekbestand wilt opgeven:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z:C:\journalfolder\

In dit voorbeeld wordt het logboekbestand gemaakt als dit nog niet bestaat. Als deze wel bestaat, hervat AzCopy de bewerking op basis van het logboekbestand.

Als u een AzCopy-bewerking wilt hervatten:

AzCopy /Z:C:\journalfolder\

In dit voorbeeld wordt de laatste bewerking hervat, die mogelijk niet is voltooid.

Een logboekbestand genereren

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V

Als u een optie /V opgeeft zonder een bestandspad naar het uitgebreide logboek op te geven, maakt AzCopy het logboekbestand op de standaardlocatie, namelijk %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy.

Anders kunt u een logboekbestand maken op een aangepaste locatie:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V:C:\myfolder\azcopy1.log

Als u een relatief pad opgeeft na de optie /V, zoals /V:test/azcopy1.log, wordt het uitgebreide logboek gemaakt in de huidige werkmap in een submap met de naam test.

Geef het aantal gelijktijdige bewerkingen op dat moet worden gestart

Optie /NC geeft het aantal gelijktijdige kopieerbewerkingen op. Standaard start AzCopy een bepaald aantal gelijktijdige bewerkingen om de doorvoer van gegevensoverdracht te verhogen. Voor tabelbewerkingen is het aantal gelijktijdige bewerkingen gelijk aan het aantal processors dat u hebt. Voor blob- en bestandsbewerkingen is het aantal gelijktijdige bewerkingen gelijk aan 8 keer het aantal processors dat u hebt. Als u AzCopy uitvoert via een netwerk met lage bandbreedte, kunt u een lager nummer opgeven voor /NC om te voorkomen dat fouten worden veroorzaakt door resourceconcurrentie.

AzCopy uitvoeren op de Azure Storage-emulator

U kunt AzCopy uitvoeren op de Azure Storage Emulator voor blobs:

AzCopy /Source:https://127.0.0.1:10000/myaccount/mycontainer/ /Dest:C:\myfolder /SourceKey:key /SourceType:Blob /S

U kunt deze ook uitvoeren voor tabellen:

AzCopy /Source:https://127.0.0.1:10002/myaccount/mytable/ /Dest:C:\myfolder /SourceKey:key /SourceType:Table

Automatisch inhoudstype van een blob bepalen

AzCopy bepaalt het inhoudstype van een blob op basis van een JSON-bestand waarin het inhoudstype wordt opgeslagen in de toewijzing van bestandsextensies. Dit JSON-bestand heeft de naam AzCopyConfig.json en bevindt zich in de map AzCopy. Als u een bestandstype hebt dat niet in de lijst staat, kunt u de toewijzing toevoegen aan het JSON-bestand:

{
  "MIMETypeMapping": {
    ".myext": "text/mycustomtype",
    .
    .
  }
}

AzCopy-parameters

Parameters voor AzCopy worden hieronder beschreven. U kunt ook een van de volgende opdrachten typen vanaf de opdrachtregel voor hulp bij het gebruik van AzCopy:

Voor gedetailleerde opdrachtregelhulp voor AzCopy: AzCopy /?
Voor gedetailleerde hulp bij een AzCopy-parameter: AzCopy /?:SourceKey
Voor opdrachtregelvoorbeelden: AzCopy /?:Sample

/Bron:"bron"

Hiermee geeft u de brongegevens waaruit te kopiëren. De bron kan een bestandssysteemmap, een blobcontainer, een virtuele blobmap, een opslagbestandsshare, een opslagbestandsmap of een Azure-tabel zijn.

Van toepassing op: Blobs, bestanden, tabellen

/Dest:"destination"

Hiermee geeft u de bestemming naar te kopiëren. De bestemming kan een bestandssysteemmap, een blobcontainer, een virtuele blobmap, een opslagbestandsshare, een opslagbestandsmap of een Azure-tabel zijn.

Van toepassing op: Blobs, bestanden, tabellen

/Pattern:"file-pattern"

Hiermee geeft u een bestandspatroon op dat aangeeft welke bestanden moeten worden gekopieerd. Het gedrag van de /Pattern parameter wordt bepaald door de locatie van de brongegevens en de aanwezigheid van de recursieve modus optie. Recursieve modus wordt opgegeven via optie /S.

Als de opgegeven bron een map in het bestandssysteem is, zijn standaard jokertekens van kracht en wordt het opgegeven bestandspatroon vergeleken met bestanden in de map. Als optie /S is opgegeven, azCopy komt ook overeen met het opgegeven patroon voor alle bestanden in eventuele submappen onder de map.

Als de opgegeven bron een blobcontainer of virtuele map is, worden er geen jokertekens toegepast. Als optie /S is opgegeven, interpreteert AzCopy het opgegeven bestandspatroon als een blobvoorvoegsel. Als optie /S niet is opgegeven, wordt het bestandspatroon in AzCopy vergeleken met exacte blobnamen.

Als de opgegeven bron een Azure-bestandsshare is, moet u de exacte bestandsnaam opgeven (bijvoorbeeld abc.txt) om één bestand te kopiëren of de optie /S opgeven om alle bestanden in de share recursief te kopiëren. Een poging om zowel een bestandspatroon als optie /S samen op te geven, resulteert in een fout.

AzCopy maakt gebruik van hoofdlettergevoelige overeenkomsten wanneer de /Source een blobcontainer of virtuele blobmap is, en maakt gebruik van niet-hoofdlettergevoelige overeenkomsten in alle andere gevallen.

Het standaardbestandspatroon dat wordt gebruikt wanneer er geen bestandspatroon is opgegeven, is . voor een bestandssysteemlocatie of een leeg voorvoegsel voor een Azure Storage-locatie. Het opgeven van meerdere bestandspatronen wordt niet ondersteund.

Van toepassing op: Blobs, Bestanden

/DestKey:"storage-key"

Hiermee geeft u de opslagaccountsleutel voor de doelresource op.

Van toepassing op: Blobs, bestanden, tabellen

/DestSAS:"sas-token"

Hiermee geeft u een Shared Access Signature (SAS) met lees- en schrijfmachtigingen voor de bestemming (indien van toepassing). Plaats de SAS tussen dubbele aanhalingstekens, omdat deze speciale opdrachtregeltekens kan bevatten.

Als de doelresource een blobcontainer, bestandsshare of tabel is, kunt u deze optie opgeven, gevolgd door het SAS-token of kunt u de SAS opgeven als onderdeel van de doel-blobcontainer, bestandsshare of tabel-URI, zonder deze optie.

Als de bron en het doel beide blobs zijn, moet de doel-blob zich in hetzelfde opslagaccount bevinden als de bron-blob.

Van toepassing op: Blobs, bestanden, tabellen

/SourceKey:"storage-key"

Hiermee geeft u de opslagaccountsleutel voor de bronresource op.

Van toepassing op: Blobs, bestanden, tabellen

/SourceSAS:"sas-token"

Hiermee geeft u een Shared Access Signature met lees- en lijstmachtigingen voor de bron (indien van toepassing). Plaats de SAS tussen dubbele aanhalingstekens, omdat deze speciale opdrachtregeltekens kan bevatten.

Als de bronresource een blobcontainer is en er geen sleutel of SAS wordt opgegeven, wordt de blobcontainer gelezen via anonieme toegang.

Als de bron een bestandsshare of tabel is, moet er een sleutel of een SAS worden opgegeven.

Van toepassing op: Blobs, bestanden, tabellen

/ S

Hiermee geeft u de recursieve modus voor kopieerbewerkingen. In de recursieve modus kopieert AzCopy alle blobs of bestanden die overeenkomen met het opgegeven bestandspatroon, inclusief die in submappen.

Van toepassing op: Blobs, Bestanden

/BlobType:"block" | "page" | "append"

Hiermee geeft u op of de doel-blob een blok-blob, een pagina-blob of een toevoeg-blob is. Deze optie is alleen van toepassing wanneer u een blob uploadt. Anders wordt er een fout gegenereerd. Als het doel een blob is en deze optie niet is opgegeven, maakt AzCopy standaard een blok-blob.

Van toepassing op: Blobs

/CheckMD5

Berekent een MD5-hash voor gedownloade gegevens en controleert of de MD5-hash die is opgeslagen in de eigenschap Content-MD5 van de blob of het bestand, overeenkomt met de berekende hash. Als de waarden niet overeenkomen, kan AzCopy de gegevens niet downloaden. De MD5-controle is standaard uitgeschakeld, dus u moet deze optie opgeven om de MD5-controle uit te voeren bij het downloaden van gegevens.

Houd er rekening mee dat Azure Storage niet garandeert dat de MD5-hash die is opgeslagen voor de blob of het bestand up-to-date is. Het is de verantwoordelijkheid van de client om de MD5 bij te werken wanneer de blob of het bestand wordt gewijzigd. In het geval van schijfinstallatiekopieën (beheerde of onbeheerde schijven), azure-VM's de MD5-waarde niet bijwerken als de schijfinhoud wordt gewijzigd. Daarom veroorzaakt /CheckMD5 een fout bij het downloaden van schijfinstallatiekopieën.

AzCopy v8 stelt altijd de eigenschap Content-MD5 in voor een Azure-blob of -bestand nadat deze naar de service is geüpload.

Van toepassing op: Blobs, Bestanden

/Momentopname

Geeft aan of momentopnamen moeten worden overgedragen. Deze optie is alleen geldig als de bron een blob is.

De naam van de overgedragen blob-momentopnamen wordt gewijzigd in deze indeling: blob-name (snapshot-time).extension

Standaard worden momentopnamen niet gekopieerd.

Van toepassing op: Blobs

/V:[verbose-log-file]

Voert uitgebreide statusberichten uit in een logboekbestand.

Het uitgebreide logboekbestand heeft standaard de naam AzCopyVerbose.log in %LocalAppData%\Microsoft\Azure\AzCopy. Als u een bestaande bestandslocatie voor deze optie opgeeft, wordt het uitgebreide logboek toegevoegd aan dat bestand.

Van toepassing op: Blobs, bestanden, tabellen

/Z:[journal-file-folder]

Hiermee geeft u een logboekbestandsmap op voor het hervatten van een bewerking.

AzCopy ondersteunt altijd hervatten als een bewerking is onderbroken.

Als deze optie niet is opgegeven of als deze is opgegeven zonder een mappad, maakt AzCopy het logboekbestand op de standaardlocatie, namelijk %LocalAppData%\Microsoft\Azure\AzCopy.

Het logboekbestand wordt verwijderd wanneer de bewerking is voltooid.

Houd er rekening mee dat het hervatten van een bewerking op basis van een logboekbestand dat is gemaakt met een eerdere versie van AzCopy niet wordt ondersteund.

Van toepassing op: Blobs, bestanden, tabellen

/@:"parameter-file"

Hiermee geeft u een bestand dat parameters bevat. AzCopy verwerkt de parameters in het bestand alsof ze zijn opgegeven op de opdrachtregel.

In een antwoordbestand kunt u meerdere parameters op één regel opgeven of elke parameter op een eigen regel opgeven. Houd er rekening mee dat een afzonderlijke parameter niet meerdere regels kan omvatten.

Antwoordbestanden kunnen opmerkingenregels bevatten die beginnen met het #-symbool.

U kunt meerdere antwoordbestanden opgeven. Houd er echter rekening mee dat AzCopy geen ondersteuning biedt voor geneste antwoordbestanden.

Van toepassing op: Blobs, bestanden, tabellen

/Y

Onderdrukt alle AzCopy-bevestigingsprompts. Met deze optie kunt u ook alleen-schrijven SAS-tokens gebruiken voor scenario's voor het uploaden van gegevens, wanneer /XO en /XN niet zijn opgegeven.

Van toepassing op: Blobs, bestanden, tabellen

/L

Hiermee geeft u alleen een vermeldingsbewerking op; er geen gegevens worden gekopieerd.

AzCopy interpreteert het gebruik van deze optie als een simulatie voor het uitvoeren van de opdrachtregel zonder deze optie /L en telt hoeveel objecten worden gekopieerd. U kunt optie /V tegelijkertijd opgeven om te controleren welke objecten worden gekopieerd in het uitgebreide logboek.

Het gedrag van deze optie wordt ook bepaald door de locatie van de brongegevens en de aanwezigheid van de recursieve modusoptie /S en bestandspatroonoptie /Patroon.

AzCopy vereist de machtiging LIST en READ van deze bronlocatie wanneer u deze optie gebruikt.

Van toepassing op: Blobs, Bestanden

/MT

Hiermee stelt u de laatste wijzigingstijd van het gedownloade bestand in op dezelfde tijd als die van de bron-blob of het bestand.

Van toepassing op: Blobs, Bestanden

/XN

Sluit een nieuwere bronresource uit. De resource wordt niet gekopieerd als de laatste wijzigingstijd van de bron hetzelfde of nieuwer is dan het doel.

Van toepassing op: Blobs, Bestanden

/XO

Sluit een oudere bronresource uit. De resource wordt niet gekopieerd als de laatste wijzigingstijd van de bron hetzelfde is of ouder is dan het doel.

Van toepassing op: Blobs, Bestanden

/A

Uploadt alleen bestanden waarvoor het kenmerk Archief is ingesteld.

Van toepassing op: Blobs, Bestanden

/IA:[RASHCNETOI]

Uploadt alleen bestanden waarvoor een van de opgegeven kenmerken zijn ingesteld.

Beschikbare kenmerken zijn:

R = Alleen-lezenbestanden
A = Bestanden die gereed zijn voor archivering
S = Systeembestanden
H = Verborgen bestanden
C = Gecomprimeerde bestanden
N = Normale bestanden
E = Versleutelde bestanden
T = Tijdelijke bestanden
O = Offlinebestanden
I = Niet-geïndexeerde bestanden

Van toepassing op: Blobs, Bestanden

/XA:[RASHCNETOI]

Sluit bestanden uit waarvoor een van de opgegeven kenmerken zijn ingesteld.

Beschikbare kenmerken zijn:

R = Alleen-lezenbestanden
A = Bestanden die gereed zijn voor archivering
S = Systeembestanden
H = Verborgen bestanden
C = Gecomprimeerde bestanden
N = Normale bestanden
E = Versleutelde bestanden
T = Tijdelijke bestanden
O = Offlinebestanden
I = Niet-geïndexeerde bestanden

Van toepassing op: Blobs, Bestanden

/Scheidingsteken:"scheidingsteken"

Geeft het scheidingsteken aan dat wordt gebruikt om virtuele mappen in een blobnaam te scheiden.

Standaard gebruikt AzCopy / als het scheidingsteken. AzCopy ondersteunt echter het gebruik van algemene tekens (zoals @, #of %) als scheidingsteken. Als u een van deze speciale tekens op de opdrachtregel wilt opnemen, plaatst u de bestandsnaam tussen dubbele aanhalingstekens.

Deze optie is alleen van toepassing op het downloaden van blobs.

Van toepassing op: Blobs

/NC:"number-of-concurrent-operations"

Hiermee geeft u het aantal gelijktijdige bewerkingen op.

AzCopy start standaard een bepaald aantal gelijktijdige bewerkingen om de doorvoer van gegevensoverdracht te verhogen. Houd er rekening mee dat een groot aantal gelijktijdige bewerkingen in een omgeving met lage bandbreedte de netwerkverbinding kan overbelasten en kan voorkomen dat de bewerkingen volledig worden voltooid. Gelijktijdige bewerkingen beperken op basis van de werkelijke beschikbare netwerkbandbreedte.

De bovengrens voor gelijktijdige bewerkingen is 512.

Van toepassing op: Blobs, bestanden, tabellen

/SourceType:"Blob" | "Tabel"

Hiermee geeft u op dat de source resource een blob is die beschikbaar is in de lokale ontwikkelomgeving, die wordt uitgevoerd in de opslagemulator.

Van toepassing op: Blobs, tabellen

/DestType:"Blob" | "Tabel"

Hiermee geeft u op dat de destination resource een blob is die beschikbaar is in de lokale ontwikkelomgeving, die wordt uitgevoerd in de opslagemulator.

Van toepassing op: Blobs, tabellen

/PKRS:"key1#key2#key3#..."

Splitst het partitiesleutelbereik om het parallel exporteren van tabelgegevens mogelijk te maken, waardoor de snelheid van de exportbewerking wordt verhoogd.

Als deze optie niet is opgegeven, gebruikt AzCopy één thread om tabelentiteiten te exporteren. Als de gebruiker bijvoorbeeld /PKRS:"aa#bb" opgeeft, start AzCopy drie gelijktijdige bewerkingen.

Elke bewerking exporteert een van de drie partitiesleutelbereiken, zoals hieronder wordt weergegeven:

[first-partition-key, aa)

[aa, bb)

[bb, last-partition-key]

Van toepassing op: Tabellen

/SplitSize:"file-size"

Hiermee geeft u de grootte van het geëxporteerde bestand splitsen in MB, de minimale waarde is toegestaan 32.

Als deze optie niet is opgegeven, exporteert AzCopy tabelgegevens naar één bestand.

Als de tabelgegevens worden geëxporteerd naar een blob en de geëxporteerde bestandsgrootte de limiet van 200 GB voor blobgrootte bereikt, splitst AzCopy het geëxporteerde bestand, zelfs als deze optie niet is opgegeven.

Van toepassing op: Tabellen

/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"

Hiermee geeft u het gedrag voor het importeren van tabelgegevens op.

InsertOrSkip: slaat een bestaande entiteit over of voegt een nieuwe entiteit in als deze niet in de tabel bestaat.
InsertOrMerge: voegt een bestaande entiteit samen of voegt een nieuwe entiteit in als deze niet in de tabel bestaat.
InsertOrReplace: vervangt een bestaande entiteit of voegt een nieuwe entiteit in als deze niet in de tabel bestaat.

Van toepassing op: Tabellen

/Manifest:"manifest-bestand"

Hiermee geeft u het manifestbestand voor de export- en importbewerking van de tabel op.

Deze optie is optioneel tijdens de exportbewerking. AzCopy genereert een manifestbestand met vooraf gedefinieerde naam als deze optie niet is opgegeven.

Deze optie is vereist tijdens de importbewerking om de gegevensbestanden te vinden.

Van toepassing op: Tabellen

/SyncCopy

Geeft aan of blobs of bestanden synchroon moeten worden gekopieerd tussen twee Azure Storage-eindpunten.

AzCopy maakt standaard gebruik van asynchrone kopie aan de serverzijde. Geef deze optie op om een synchrone kopie uit te voeren, waarmee blobs of bestanden naar het lokale geheugen worden gedownload en deze vervolgens worden geüpload naar Azure Storage.

U kunt deze optie gebruiken bij het kopiëren van bestanden in Blob Storage, binnen Bestandsopslag of van Blob-opslag naar Bestandsopslag of omgekeerd.

Van toepassing op: Blobs, Bestanden

/SetContentType:"content-type"

Hiermee geeft u het MIME-inhoudstype voor doel-blobs of -bestanden op.

AzCopy stelt het inhoudstype voor een blob of bestand standaard in op toepassing/octet-stream. U kunt het inhoudstype voor alle blobs of bestanden instellen door expliciet een waarde voor deze optie op te geven.

Als u deze optie zonder een waarde opgeeft, wordt in AzCopy het inhoudstype van elke blob of elk bestand ingesteld op basis van de bestandsextensie.

Van toepassing op: Blobs, Bestanden

/PayloadFormat:"JSON" | "CSV"

Hiermee geeft u de indeling van het geëxporteerde gegevensbestand van de tabel op.

Als deze optie niet is opgegeven, exporteert AzCopy standaard een tabelgegevensbestand in JSON-indeling.

Van toepassing op: Tabellen

Bekende problemen en aanbevolen procedures

Laten we eens kijken naar enkele van de bekende problemen en aanbevolen procedures.

Gelijktijdige schrijfbewerkingen tijdens het kopiëren van gegevens beperken

Wanneer u blobs of bestanden kopieert met AzCopy, moet u er rekening mee houden dat de gegevens mogelijk door een andere toepassing worden gewijzigd terwijl u deze kopieert. Zorg er indien mogelijk voor dat de gegevens die u kopieert, niet worden gewijzigd tijdens de kopieerbewerking. Wanneer u bijvoorbeeld een VHD kopieert die is gekoppeld aan een virtuele Azure-machine, moet u ervoor zorgen dat er momenteel geen andere toepassingen naar de VHD worden geschreven. Een goede manier om dit te doen, is door de resource te leasen die moet worden gekopieerd. U kunt ook eerst een momentopname van de VHD maken en vervolgens de momentopname kopiëren.

Als u niet kunt voorkomen dat andere toepassingen naar blobs of bestanden schrijven terwijl ze worden gekopieerd, moet u er rekening mee houden dat tegen de tijd dat de taak is voltooid, de gekopieerde resources mogelijk niet meer volledig pariteit hebben met de bronresources.

Schakel FIPS-compatibele MD5-algoritmen in voor AzCopy wanneer u FIPS-compatibele algoritmen gebruikt voor versleuteling, hashing en ondertekening.

AzCopy maakt standaard gebruik van .NET MD5-implementatie om de MD5 te berekenen bij het kopiëren van objecten, maar er zijn enkele beveiligingsvereisten waarvoor AzCopy nodig is om DE INSTELLING VOOR FIPS-compatibele MD5 in te schakelen.

U kunt een app.config-bestand AzCopy.exe.config met de eigenschap AzureStorageUseV1MD5 maken en dit opzij zetten met AzCopy.exe.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="AzureStorageUseV1MD5" value="false"/>
  </appSettings>
</configuration>

Voor de eigenschap AzureStorageUseV1MD5:

True: de standaardwaarde AzCopy maakt gebruik van .NET MD5-implementatie.
False: AzCopy maakt gebruik van HET FIPS-compatibele MD5-algoritme.

FIPS-compatibele algoritmen zijn standaard uitgeschakeld in Windows. U kunt deze beleidsinstelling op uw computer wijzigen. Typ secpol.msc in het venster Uitvoeren (Windows+R) om het venster Lokaal beveiligingsbeleid te openen. Navigeer in het venster Beveiligingsinstellingen naar Beveiligingsinstellingen>Lokaal beleid>Beveiligingsopties. Zoek de systeemcryptografie: gebruik FIPS-compatibele algoritmen voor versleuteling, hashing en ondertekeningsbeleid . Dubbelklik op het beleid om de waarde weer te geven die wordt weergegeven in de kolom Beveiligingsinstelling .

Volgende stappen

Zie de volgende bronnen voor meer informatie over Azure Storage en AzCopy:

Gegevens overdragen met AzCopy v8.1 in Windows

AzCopy (v8.1) downloaden en installeren in Windows

Opmerkingen bij de release van AzCopy in Windows 8.1

Azcopy met table-ondersteuning (v7.3)

Stap na installatie

Uw eerste AzCopy-opdracht schrijven

Blobs downloaden uit Blob Storage

Eén blob downloaden

Eén blob downloaden uit de secundaire regio

Alle blobs in een container downloaden

Blobs met een specifiek voorvoegsel downloaden

De tijd van de laatste wijziging van geëxporteerde bestanden instellen op dezelfde als de bron-blobs

Blobs uploaden naar Blob Storage

Eén blob uploaden

Eén blob uploaden naar een virtuele map

Alle blobs in een map uploaden

Blobs uploaden die overeenkomen met een specifiek patroon

Het MIME-inhoudstype van een doel-blob opgeven

Blobs kopiëren in Blob Storage

Eén blob kopiëren van de ene container naar een andere binnen hetzelfde opslagaccount

Eén blob kopiëren van het ene opslagaccount naar het andere

Eén blob kopiëren van de secundaire regio naar de primaire regio

Eén blob en de bijbehorende momentopnamen van het ene opslagaccount naar het andere kopiëren

Alle blobs in een container naar een ander opslagaccount kopiëren

Blobs synchroon kopiëren van het ene opslagaccount naar het andere

Bestanden downloaden uit File Storage

Eén bestand downloaden

Alle bestanden in een map downloaden

Bestanden uploaden naar een Azure-bestandsshare

Eén bestand uploaden

Alle bestanden in een map uploaden

Bestanden uploaden die overeenkomen met een specifiek patroon

Bestanden kopiëren in File Storage

Kopiëren van de ene bestandsshare naar de andere

Kopiëren van een Azure-bestandsshare naar Blob Storage

Een blob kopiëren van Blob Storage naar een Azure-bestandsshare

Bestanden synchroon kopiëren

Gegevens exporteren uit Table Storage

Een tabel exporteren

Een export van Table Storage splitsen in meerdere bestanden

Een tabel exporteren naar JSON- of CSV-gegevensbestandsindeling

Tabelentiteiten gelijktijdig exporteren

Een tabel exporteren naar Blob Storage

Gegevens importeren in Table Storage

Een tabel importeren

Entiteiten importeren in een tabel vanuit Blob Storage

Andere AzCopy-functies

Alleen gegevens kopiëren die niet bestaan in de bestemming

Een antwoordbestand gebruiken om opdrachtregelparameters op te geven

Meerdere antwoordbestanden gebruiken om opdrachtregelparameters op te geven

Een Shared Access Signature (SAS) opgeven

Logboek bestandsmap

Een logboekbestand genereren

Geef het aantal gelijktijdige bewerkingen op dat moet worden gestart

AzCopy uitvoeren op de Azure Storage-emulator

Automatisch inhoudstype van een blob bepalen

AzCopy-parameters

/Bron:"bron"

/Dest:"destination"

/Pattern:"file-pattern"

/DestKey:"storage-key"

/DestSAS:"sas-token"

/SourceKey:"storage-key"

/SourceSAS:"sas-token"

/ S

/BlobType:"block" | "page" | "append"

/CheckMD5

/Momentopname

/V:[verbose-log-file]

/Z:[journal-file-folder]

/@:"parameter-file"

/Y

/L

/MT

/XN

/XO

/A

/IA:[RASHCNETOI]

/XA:[RASHCNETOI]

/Scheidingsteken:"scheidingsteken"