Gegevens overdragen met AzCopy v8.1 in Windows
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 /S
niet 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:\myfolder
bevinden:
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 /S
niet 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:\myfolder
bevinden:
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 /S
niet 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.
Bestanden uploaden naar een Azure-bestandsshare
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.
Kopiëren van de ene bestandsshare naar de 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 tussen bestandsshares kopieert, wordt er 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 er 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 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 /PKRS
niet opgeeft.
Stel dat AzCopy twee gegevensbestanden genereert nadat de gebruiker de optie /SplitSize
heeft 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 /PKRS
opgeeft. 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 /PKRS
opgeeft, 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:\responsefiles
bevinden, 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 /Z
weglaat 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.
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.
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:
Documentatie voor Azure Storage:
- Kennismaking met Azure Storage
- Blob Storage gebruiken met .NET
- Bestandsopslag gebruiken vanuit .NET
- Table Storage gebruiken vanuit .NET
- Een opslagaccount maken, beheren of verwijderen
- Gegevens overdragen met AzCopy voor Linux
Azure Storage-blogberichten:
- Inleiding tot de preview-versie van de Bibliotheek voor gegevensverplaatsing van Azure Storage
- AzCopy: introductie van synchroon kopiëren en aangepast inhoudstype
- AzCopy: aankondiging van algemene beschikbaarheid van AzCopy 3.0 plus preview-versie van AzCopy 4.0 met ondersteuning voor Tabellen en bestanden
- AzCopy: geoptimaliseerd voor scenario's voor Large-Scale kopiëren
- AzCopy: ondersteuning voor geografisch redundante opslag met leestoegang
- AzCopy: gegevens overdragen met de modus voor opnieuw opstarten en een SAS-token
- AzCopy: Blob kopiëren tussen accounts gebruiken
- AzCopy: bestanden uploaden/downloaden voor Azure-blobs