Delen via

Gegevens overdragen met AzCopy v8.1 in Windows

  • Artikel

AzCopy is een opdrachtregelprogramma voor het kopiëren van gegevens van/naar Microsoft Azure Blob-, File- en Table-opslag met 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 om de meest recente versie van AzCopy te installeren.

Als u ervoor kiest om de oudere versie van AzCopy (AzCopy v8.1) te installeren, zijn er meerdere versies die u kunt downloaden. AzCopy in Windows biedt opdrachtregelopties voor Windows-stijl. AzCopy op Linux is gericht op Linux-platforms met opdrachtregelopties in POSIX-stijl. In dit artikel wordt AzCopy in Windows behandeld.

AzCopy (v8.1) downloaden en installeren in Windows

Download AzCopy (v8.1) in Windows.

Releaseopmerkingen voor AzCopy in Windows 8.1

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

Azcopy met Table-ondersteuning (v7.3)

Download AzCopy 7.3 met table-ondersteuning.

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 Installatiemap van AzCopy op uw computer, waar het AzCopy.exe uitvoerbare bestand zich bevindt. Desgewenst kunt u de AzCopy-installatielocatie toevoegen aan uw systeempad. AzCopy is standaard geïnstalleerd op %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]

De volgende voorbeelden laten verschillende scenario's zien voor het kopiëren van gegevens naar en van Microsoft Azure Blobs, Bestanden en Tabellen. 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"

Houd er rekening mee dat als de map C:\myfolder niet bestaat, AzCopy deze maakt en naar de nieuwe map downloadt abc.txt .

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 voor toegang 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 geen optie /Sopgeeft, 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, dus deze wordt niet gedownload. Als de optie /S niet is opgegeven, downloadt AzCopy bovendien geen blobs.

De laatst gewijzigde tijd 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 blobs ook uitsluiten van de downloadbewerking op basis van hun laatst gewijzigde tijd. 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 hetzelfde is of ouder is dan het doelbestand, voegt u de /XO optie toe:

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 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 Blob Storage, 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 geen optie /Sopgeeft, 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 geen optie /Sopgeeft, 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 zonder waarde opgeeft /SetContentType , stelt AzCopy elk blob- of bestandsinhoudstype in 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 AzCopy.

Eén blob kopiëren van de ene container naar de 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 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 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 voor toegang 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 kopiëren naar een ander opslagaccount

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 uploaden in een map voor meer informatie en een voorbeeld.

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

AzCopy kopieert standaard gegevens tussen twee opslageindpunten asynchroon. Daarom wordt de kopieerbewerking op de achtergrond uitgevoerd met reservebandbreedtecapaciteit die geen SLA heeft in termen van hoe snel een blob wordt gekopieerd, en AzCopy controleert regelmatig de kopieerstatus totdat het kopiëren is voltooid of mislukt.

De /SyncCopy optie zorgt ervoor dat de kopieerbewerking consistent wordt. 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. De aanbevolen methode is deze optie te gebruiken in 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 (bijvoorbeeld abc.txt) om één bestand te downloaden of een optie /S opgeven om alle bestanden in de share recursief te downloaden. Als u zowel een bestandspatroon als een optie /S 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.

Bestanden uploaden naar een Azure-bestandsshare

Laten we eens kijken naar verschillende manieren om bestanden te uploaden met 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 in een Azure-bestandsshare te kopiëren met behulp van AzCopy.

Kopiëren van de ene bestandsshare naar een andere

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 kopieert tussen bestandsshares, wordt een kopieerbewerking aan de serverzijde uitgevoerd.

Kopiëren van een Azure-bestandsshare naar Blob Storage

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 een kopieerbewerking aan de serverzijde uitgevoerd.

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

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 synchroon naar File Storage. AzCopy doet dit door de brongegevens te downloaden naar het lokale geheugen en deze opnieuw te uploaden naar de bestemming. De 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 mogelijk extra kosten voor uitgaand verkeer worden gegenereerd in vergelijking met asynchrone kopie. De aanbevolen methode 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. In het manifestbestand wordt standaard de volgende naamconventie gebruikt:

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

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 uit 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 volumeindex in de namen van gesplitste gegevensbestanden om meerdere bestanden te onderscheiden. De volumeindex bestaat uit twee delen, een partitiesleutelbereikindex en een gesplitste bestandsindex. Beide indexen zijn gebaseerd op nul.

De partitiesleutelbereikindex is 0 als de gebruiker geen optie /PKRSopgeeft.

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 optie /SplitSize 32 MB is. Als de opgegeven bestemming Blob-opslag is, splitst AzCopy het gegevensbestand zodra de grootte van het gegevensbestand de beperking van de blobgrootte bereikt (200 GB), 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 om de tabellen als JSON of CSV te exporteren.

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

Wanneer u de INDELING van de CSV-nettolading opgeeft, genereert AzCopy ook een schemabestand met de 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 beheerd door de optie /NC. AzCopy gebruikt het aantal kernprocessors als de standaardwaarde voor het kopiëren van /NC tabelentiteiten, zelfs als /NC deze niet is opgegeven. Wanneer de gebruiker de optie /PKRSopgeeft, gebruikt AzCopy het kleinere van de twee waarden: partitiesleutelbereiken versus impliciet of expliciet opgegeven gelijktijdige bewerkingen, om het aantal gelijktijdige bewerkingen te bepalen dat moet worden gestart. Typ op de opdrachtregel voor meer informatie AzCopy /?:NC .

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 payload-indeling voor minimale metagegevens. Zie Payload Format voor Tabelservicebewerkingen voor meer informatie over deze payload-indeling.

Wanneer u tabellen naar blobs exporteert, downloadt AzCopy de tabelentiteiten naar lokale tijdelijke gegevensbestanden en uploadt deze entiteiten vervolgens naar de blob. Deze tijdelijke gegevensbestanden worden in de map met logboekbestanden geplaatst met het standaardpad '%LocalAppData%\Microsoft\Azure\AzCopy', u kunt optie /Z:[journal-file-folder] opgeven om de maplocatie van het logboekbestand 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 nadat het is geüpload naar de blob, 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

Met de optie /EntityOperation wordt aangegeven hoe u entiteiten in de tabel invoegt. 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 voor het starten van gelijktijdige bewerkingen moet opgeven, start AzCopy standaard gelijktijdige bewerkingen wanneer u een tabel importeert. Het standaardaantal gestarte gelijktijdige bewerkingen is gelijk aan het aantal kernprocessors; U kunt echter een ander aantal gelijktijdige /NCopties opgeven. Typ op de opdrachtregel voor meer informatie AzCopy /?:NC .

AzCopy biedt alleen ondersteuning voor importeren voor JSON, niet voor CSV. AzCopy biedt geen ondersteuning voor tabelimport 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 Blob-container 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 aanwezig zijn in de bestemming

Met de /XO parameters /XN kunt u oudere of nieuwere bronresources uitsluiten van respectievelijk kopiëren. Als u alleen bronresources wilt kopiëren die niet aanwezig zijn in de bestemming, 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 bestemming 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 wordt uitgevoerd met de inhoud van het bestand.

Stel 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 een antwoordbestand met de naam source.txt op dat een broncontainer aangeeft:

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

En een antwoordbestand met de naam dest.txt waarmee een doelmap in het bestandssysteem wordt opgegeven:

/Dest:C:\myfolder

En een antwoordbestand met de naam options.txt waarmee 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 net als wanneer u alle afzonderlijke parameters op de opdrachtregel hebt opgenomen:

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 op de container-URI:

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

Logboekbestandsmap

Telkens wanneer u een opdracht aan AzCopy geeft, wordt gecontroleerd of er een logboekbestand in de standaardmap bestaat of 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 genereert een nieuw logboekbestand.

Als het logboekbestand wel bestaat, controleert AzCopy of de opdrachtregel die u invoert overeenkomt met de opdrachtregel in het logboekbestand. Als de twee opdrachtregels overeenkomen, hervat AzCopy de onvolledige bewerking. Als deze 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.%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 wilt opgeven voor het logboekbestand:

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 het nog niet bestaat. Als deze 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 kan worden 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, dat wil %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopyzeggen.

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, /Vzoals /V:test/azcopy1.log, wordt het uitgebreide logboek gemaakt in de huidige werkmap binnen een submap met de naam test.

Geef het aantal gelijktijdige bewerkingen op dat moet worden gestart

Met de optie /NC geeft u het aantal gelijktijdige kopieerbewerkingen op. AzCopy start standaard 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 in een netwerk met lage bandbreedte, kunt u een lager aantal opgeven voor /NC om te voorkomen dat er fouten optreden die worden veroorzaakt door resourcecompetitie.

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

Inhoudstype van een blob automatisch 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 elke AzCopy-parameter: AzCopy /?:SourceKey
  • Voor opdrachtregelvoorbeelden: AzCopy /?:Sample

/Source:"source"

Hiermee geeft u de brongegevens van waaruit moet worden gekopieerd. 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 parameter /Pattern wordt bepaald door de locatie van de brongegevens en de aanwezigheid van de recursieve modusoptie. 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, komt AzCopy ook overeen met het opgegeven patroon voor alle bestanden in submappen onder de map.

Als de opgegeven bron een blobcontainer of virtuele map is, worden jokertekens niet toegepast. Als optie /S is opgegeven, interpreteert AzCopy het opgegeven bestandspatroon als een blobvoorvoegsel. Als optie /S niet is opgegeven, komt AzCopy overeen met het bestandspatroon ten opzichte van exacte blobnamen.

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

AzCopy maakt gebruik van hoofdlettergevoelige overeenkomsten wanneer de /Source een blobcontainer of virtuele blobmap is en maakt gebruik van 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 sleutel van het opslagaccount voor de doelresource op.

Van toepassing op: Blobs, bestanden, tabellen

/DestSAS:"sas-token"

Hiermee geeft u een SAS (Shared Access Signature) met LEES- en SCHRIJFmachtigingen voor de bestemming (indien van toepassing). Plaats de SAS tussen dubbele aanhalingstekens, omdat deze mogelijk speciale opdrachtregeltekens bevat.

Als de doelresource een blobcontainer, bestandsshare of tabel is, kunt u deze optie opgeven, gevolgd door het SAS-token, of u kunt 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 sleutel van het opslagaccount 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 op (indien van toepassing). Plaats de SAS tussen dubbele aanhalingstekens, omdat deze mogelijk speciale opdrachtregeltekens bevat.

Als de bronresource een blobcontainer is en 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 sas worden opgegeven.

Van toepassing op: Blobs, bestanden, tabellen

/S

Hiermee geeft u 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" | "toevoegen"

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 de bestemming 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 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 niet-beheerde schijven) werken Azure-VM's de MD5-waarde niet bij wanneer de schijfinhoud wordt gewijzigd, waardoor /CheckMD5 een fout genereert 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

Hiermee wordt aangegeven of momentopnamen moeten worden overgedragen. Deze optie is alleen geldig wanneer de bron een blob is.

De overgedragen blob-momentopnamen worden in deze indeling hernoemd: blob-name (snapshot-time).extension

Momentopnamen worden standaard niet gekopieerd.

Van toepassing op: Blobs

/V:[verbose-log-file]

Voert uitgebreide statusberichten uit in een logboekbestand.

Standaard krijgt het uitgebreide logboekbestand 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 biedt altijd ondersteuning voor hervatten als een bewerking is onderbroken.

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

Telkens wanneer u een opdracht aan AzCopy geeft, wordt gecontroleerd of er een logboekbestand in de standaardmap bestaat of 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 genereert een nieuw logboekbestand.

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

Het logboekbestand wordt verwijderd nadat de bewerking is voltooid.

Houd er rekening mee dat het hervatten van een bewerking vanuit een logboekbestand dat is gemaakt door 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 net 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 opmerkingenlijnen 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 worden geen gegevens 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 er worden gekopieerd. U kunt optie /V tegelijk opgeven om te controleren welke objecten in het uitgebreide logboek worden gekopieerd.

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

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 laatst gewijzigde tijd van het gedownloade bestand in op dezelfde als 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 de bestemming.

Van toepassing op: Blobs, Bestanden

/XO

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

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 met een van de opgegeven kenmerken die zijn ingesteld.

Beschikbare kenmerken zijn:

  • R = Alleen-lezen bestanden
  • A = Bestanden gereed 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 is ingesteld.

Beschikbare kenmerken zijn:

  • R = Alleen-lezen bestanden
  • A = Bestanden gereed 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 een gemeenschappelijk teken (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:"aantal gelijktijdige bewerkingen"

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 dat de bewerkingen niet volledig kunnen 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 bereik van de partitiesleutel om tabelgegevens parallel te exporteren, 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:

[eerste partitiesleutel, aa)

[aa, bb)

[bb, laatste partitiesleutel]

Van toepassing op: Tabellen

/SplitSize:"file-size"

Hiermee geeft u de grootte van de geëxporteerde bestandssplitsing in MB op. De minimale waarde is 32.

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

Als de tabelgegevens naar een blob worden geëxporteerd 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 importgedrag voor 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-file"

Hiermee geeft u het manifestbestand voor de tabelexport- en importbewerking.

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 voor het zoeken naar de gegevensbestanden.

Van toepassing op: Tabellen

/SyncCopy

Hiermee wordt aangegeven 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 vervolgens naar Azure Storage worden geüpload.

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

Van toepassing op: Blobs, Bestanden

/SetContentType:"content-type"

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

AzCopy stelt standaard het inhoudstype voor een blob of bestand in op de 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 waarde opgeeft, stelt AzCopy elk blob- of bestandsinhoudstype in 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.

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

Van toepassing op: Tabellen

Bekende problemen en aanbevolen procedures

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

Gelijktijdige schrijfbewerkingen beperken tijdens het kopiëren van gegevens

Wanneer u blobs of bestanden kopieert met AzCopy, moet u er rekening mee houden dat een andere toepassing de gegevens mogelijk wijzigt terwijl u deze kopieert. Zorg er indien mogelijk voor dat de gegevens die u kopieert niet worden gewijzigd tijdens de kopieerbewerking. Als 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 de gekopieerde resources mogelijk niet langer volledige pariteit hebben met de bronbronnen.

Schakel MD5-algoritmen die compatibel zijn met FIPS in voor AzCopy wanneer u 'FIPS-compatibele algoritmen gebruiken 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 die AzCopy nodig hebben om FIPS-compatibele MD5-instelling in te schakelen.

U kunt een app.config-bestand AzCopy.exe.config met eigenschap AzureStorageUseV1MD5 maken en het 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 MD5-algoritme dat compatibel is met FIPS.

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 Voor beveiligingsinstellingen.>> 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:

Documentatie voor Azure Storage:

Azure Storage-blogberichten: