Přenos dat pomocí nástroje AzCopy v8.1 ve Windows
AzCopy je nástroj příkazového řádku určený ke kopírování dat do a ze služeb Microsoft Azure Blob, File a Table Storage za použití jednoduchých příkazů navržených pro optimální výkon. Data můžete kopírovat mezi systémem souborů a účtem úložiště nebo mezi účty úložiště.
Důležité
Tento článek popisuje starší verzi nástroje AzCopy. Pokud chcete nainstalovat nejnovější verzi AzCopy, přečtěte si téma AzCopy v10.
Pokud se rozhodnete nainstalovat starší verzi AzCopy (AzCopy v8.1), můžete si stáhnout několik verzí. AzCopy ve Windows nabízí možnosti příkazového řádku ve stylu Windows. AzCopy v Linuxu cílí na linuxové platformy nabízející možnosti příkazového řádku ve stylu POSIX. Tento článek se zabývá nástrojem AzCopy ve Windows.
Stažení a instalace nástroje AzCopy (v8.1) ve Windows
Stáhněte si AzCopy (v8.1) ve Windows.
AzCopy ve Windows 8.1 – zpráva k vydání verze
- Služba Table Service se už v nejnovější verzi nepodporuje. Pokud používáte funkci exportu tabulky, stáhněte si AzCopy verze 7.3.
- Sestavené pomocí .NET Core 2.1 a všechny závislosti .NET Core jsou teď zabalené v instalaci.
- Přidání podpory ověřování OAuth Používá
azcopy login
se k přihlášení pomocí Azure Active Directory.
AzCopy s podporou tabulek (v7.3)
Stáhněte si AzCopy 7.3 s podporou tabulky.
Krok po instalaci
Po instalaci nástroje AzCopy ve Windows pomocí instalačního programu otevřete příkazové okno a přejděte do instalačního adresáře AzCopy ve vašem počítači , kde AzCopy.exe
se nachází spustitelný soubor. V případě potřeby můžete do systémové cesty přidat umístění instalace AzCopy. Ve výchozím nastavení je nástroj AzCopy nainstalován do %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy
nebo %ProgramFiles%\Microsoft SDKs\Azure\AzCopy
.
Psaní prvního příkazu AzCopy
Základní syntaxe příkazů AzCopy je:
AzCopy /Source:<source> /Dest:<destination> [Options]
Následující příklady ukazují různé scénáře kopírování dat do a z objektů blob, souborů a tabulek Microsoft Azure. Podrobné vysvětlení parametrů použitých v jednotlivých ukázkách najdete v části Parametry AzCopy.
Stažení objektů blob ze služby Blob Storage
Pojďme se podívat na několik způsobů, jak stáhnout objekty blob pomocí AzCopy.
Stažení jednoho objektu blob
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"
Všimněte si, že pokud složka C:\myfolder
neexistuje, AzCopy ji vytvoří a stáhne abc.txt
do nové složky.
Stažení jednoho objektu blob ze sekundární oblasti
AzCopy /Source:https://myaccount-secondary.blob.core.windows.net/mynewcontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"
Mějte na paměti, že pro přístup k sekundární oblasti musíte mít povolené geograficky redundantní úložiště s přístupem pro čtení.
Stažení všech objektů blob v kontejneru
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /S
Předpokládejme, že se v zadaném kontejneru nacházejí následující objekty blob:
abc.txt
abc1.txt
abc2.txt
vd1\a.txt
vd1\abcd.txt
Po operaci stahování adresář C:\myfolder
obsahuje následující soubory:
C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\vd1\a.txt
C:\myfolder\vd1\abcd.txt
Pokud nezadáte možnost /S
, nestáhnou se žádné objekty blob.
Stažení objektů blob s konkrétní předponou
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:a /S
Předpokládejme, že se v zadaném kontejneru nacházejí následující objekty blob. Všechny objekty blob začínající předponou a
se stáhnou:
abc.txt
abc1.txt
abc2.txt
xyz.txt
vd1\a.txt
vd1\abcd.txt
Po operaci stahování složka C:\myfolder
obsahuje následující soubory:
C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
Předpona se vztahuje na virtuální adresář, který tvoří první část názvu objektu blob. V příkladu uvedeném výše se virtuální adresář neshoduje se zadanou předponou, takže se nestáhnou. Kromě toho, pokud není možnost /S
zadána, AzCopy nestahuje žádné objekty blob.
Nastavte čas poslední změny exportovaných souborů tak, aby byl stejný jako zdrojové objekty blob.
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT
Objekty blob můžete také vyloučit z operace stahování na základě času poslední změny. Pokud například chcete vyloučit objekty blob, jejichž čas poslední změny je stejný nebo novější než cílový soubor, přidejte /XN
tuto možnost:
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XN
Pokud chcete vyloučit objekty blob, jejichž čas poslední změny je stejný nebo starší než cílový soubor, přidejte /XO
tuto možnost:
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XO
Nahrání objektů blob do úložiště objektů blob
Pojďme se podívat na několik způsobů, jak pomocí AzCopy nahrát objekty blob.
Nahrání jednoho objektu blob
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:"abc.txt"
Pokud zadaný cílový kontejner neexistuje, AzCopy ho vytvoří a soubor do něj nahraje.
Nahrání jednoho objektu blob do virtuálního adresáře
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer/vd /DestKey:key /Pattern:abc.txt
Pokud zadaný virtuální adresář neexistuje, AzCopy nahraje soubor tak, aby zahrnoval virtuální adresář do jejího názvu (napřvd/abc.txt
. v předchozím příkladu).
Nahrání všech objektů blob ve složce
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /S
Určení možnosti /S
nahraje obsah zadaného adresáře do úložiště objektů blob rekurzivně, což znamená, že se nahrají i všechny podsložky a jejich soubory. Předpokládejme například, že se ve složce C:\myfolder
nacházejí následující soubory:
C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt
Po operaci nahrání kontejner obsahuje následující soubory:
abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt
Pokud nezadáte možnost /S
, AzCopy nenahraje rekurzivně. Po operaci nahrání kontejner obsahuje následující soubory:
abc.txt
abc1.txt
abc2.txt
Nahrání objektů blob odpovídajících určitému vzoru
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:a* /S
Předpokládejme, že se ve složce C:\myfolder
nacházejí následující soubory:
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
Po operaci nahrání kontejner obsahuje následující soubory:
abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt
Pokud nezadáte možnost /S
, AzCopy nahraje pouze objekty blob, které se nenabídnou ve virtuálním adresáři:
C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
Určení typu obsahu MIME cílového objektu blob
Ve výchozím nastavení AzCopy nastaví typ obsahu cílového objektu blob na application/octet-stream
. Počínaje verzí 3.1.0 můžete explicitně zadat typ obsahu prostřednictvím možnosti /SetContentType:[content-type]
. Tato syntaxe nastaví typ obsahu pro všechny objekty blob v operaci nahrávání.
AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType:video/mp4
Pokud zadáte /SetContentType
bez hodnoty, AzCopy nastaví jednotlivé objekty blob nebo typ obsahu souboru podle jeho přípony souboru.
AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType
Kopírování objektů blob v úložišti objektů blob
Pojďme se podívat na několik způsobů kopírování objektů blob z jednoho umístění do jiného pomocí nástroje AzCopy.
Zkopírování jednoho objektu blob z jednoho kontejneru do druhého ve stejném účtu úložiště
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceKey:key /DestKey:key /Pattern:abc.txt
Při kopírování objektu blob v rámci účtu úložiště se provede operace kopírování na straně serveru.
Kopírování jednoho objektu blob z jednoho účtu úložiště do druhého
AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt
Při kopírování objektu blob mezi účty úložiště se provede operace kopírování na straně serveru.
Zkopírování jednoho objektu blob ze sekundární oblasti do primární oblasti
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
Mějte na paměti, že pro přístup k sekundárnímu úložišti musíte mít povolené geograficky redundantní úložiště jen pro čtení.
Kopírování jednoho objektu blob a jeho snímků z jednoho účtu úložiště do druhého
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
Po operaci kopírování zahrnuje cílový kontejner objekt blob a jeho snímky. Za předpokladu, že objekt blob v předchozím příkladu obsahuje dva snímky, kontejner obsahuje následující objekt blob a snímky:
abc.txt
abc (2013-02-25 080757).txt
abc (2014-02-21 150331).txt
Kopírování všech objektů blob v kontejneru do jiného účtu úložiště
AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1
/Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /S
Určení možnosti /S nahraje obsah zadaného kontejneru rekurzivně. Další informace a příklad najdete v tématu Nahrání všech objektů blob ve složce .
Synchronní kopírování objektů blob z jednoho účtu úložiště do druhého
AzCopy ve výchozím nastavení kopíruje data mezi dvěma koncovými body úložiště asynchronně. Operace kopírování se proto spouští na pozadí s využitím volné kapacity šířky pásma, která nemá žádnou smlouvu SLA z hlediska rychlosti kopírování objektu blob, a AzCopy pravidelně kontroluje stav kopírování, dokud se kopírování nedokončí nebo se nezdaří.
Tato /SyncCopy
možnost zajišťuje, aby operace kopírování získala konzistentní rychlost. AzCopy provede synchronní kopii stažením objektů blob, které se mají zkopírovat ze zadaného zdroje do místní paměti, a pak je nahraje do cíle úložiště objektů blob.
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
může vygenerovat další náklady na výchozí přenos dat v porovnání s asynchronní kopií. Doporučeným přístupem je použití této možnosti ve virtuálním počítači Azure, který je ve stejné oblasti jako váš zdrojový účet úložiště, aby se zabránilo nákladům na výchozí přenos dat.
Stažení souborů ze služby File Storage
Pojďme se podívat na několik způsobů, jak stáhnout soubory pomocí nástroje AzCopy.
Stažení jednoho souboru
AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/myfolder1/ /Dest:C:\myfolder /SourceKey:key /Pattern:abc.txt
Pokud je zadaným zdrojem sdílená složka Azure, musíte buď zadat přesný název souboru (např. abc.txt
) ke stažení jednoho souboru, nebo zadat možnost /S
stažení všech souborů ve sdílené složce rekurzivně. Při pokusu o zadání vzoru souboru i možnosti /S
najednou dojde k chybě.
Stažení všech souborů v adresáři
AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/ /Dest:C:\myfolder /SourceKey:key /S
Všimněte si, že prázdné složky se nestáhnou.
Nahrání souborů do sdílené složky Azure
Pojďme se podívat na několik způsobů nahrávání souborů pomocí AzCopy.
Nahrání jednoho souboru
AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:abc.txt
Nahrání všech souborů ve složce
AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /S
Všimněte si, že prázdné složky se nenahrají.
Nahrání souborů odpovídajících určitému vzoru
AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:ab* /S
Kopírování souborů v úložišti souborů
Pojďme se podívat na několik způsobů kopírování souborů ve sdílené složce Azure pomocí AzCopy.
Kopírování z jedné sdílené složky do druhé
AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S
Při kopírování souboru mezi sdílenými složkami se provede operace kopírování na straně serveru.
Kopírování ze sdílené složky Azure do úložiště objektů blob
AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare/ /Dest:https://myaccount2.blob.core.windows.net/mycontainer/ /SourceKey:key1 /DestKey:key2 /S
Při kopírování souboru ze sdílené složky do objektu blob se provede operace kopírování na straně serveru.
Kopírování objektu blob z úložiště objektů blob do sdílené složky Azure
AzCopy /Source:https://myaccount1.blob.core.windows.net/mycontainer/ /Dest:https://myaccount2.file.core.windows.net/myfileshare/ /SourceKey:key1 /DestKey:key2 /S
Při kopírování souboru z objektu blob do sdílené složky se provede operace kopírování na straně serveru.
Synchronní kopírování souborů
Můžete určit /SyncCopy
možnost kopírování dat ze služby File Storage do File Storage, ze File Storage do Blob Storage a synchronně z Úložiště objektů blob do File Storage, AzCopy to provede stažením zdrojových dat do místní paměti a jejich opětovným nahráním do cíle. Platí standardní náklady na výchozí přenos dat.
AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S /SyncCopy
Při kopírování z Úložiště souborů do úložiště objektů blob je výchozím typem objektu blob objektu blob objekt blob. uživatel může zadat možnost /BlobType:page
změnit typ cílového objektu blob.
Všimněte si, že /SyncCopy
ve srovnání s asynchronní kopií můžou generovat další náklady na výchozí přenos dat. Doporučeným přístupem je použít tuto možnost na virtuálním počítači Azure, který je ve stejné oblasti jako váš zdrojový účet úložiště, abyste se vyhnuli nákladům na výchozí přenos dat.
Export dat z Table Storage
Pojďme se podívat na export dat z Azure Table Storage pomocí AzCopy.
Export tabulky
AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key
AzCopy zapíše soubor manifestu do zadané cílové složky. Soubor manifestu se používá v procesu importu k vyhledání potřebných datových souborů a k ověření dat. Soubor manifestu ve výchozím nastavení používá následující zásady vytváření názvů:
<account name>_<table name>_<timestamp>.manifest
Uživatel může také zadat možnost /Manifest:<manifest file name>
nastavení názvu souboru manifestu.
AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /Manifest:abc.manifest
Rozdělení exportu z Úložiště tabulek do několika souborů
AzCopy /Source:https://myaccount.table.core.windows.net/mytable/ /Dest:C:\myfolder /SourceKey:key /S /SplitSize:100
AzCopy používá index svazku v názvech rozdělených datových souborů k rozlišení více souborů. Index svazku se skládá ze dvou částí, index rozsahu klíčů oddílu a rozděleného indexu souboru. Oba indexy jsou založené na nule.
Index rozsahu klíčů oddílu je 0, pokud uživatel nezadá možnost /PKRS
.
Předpokládejme například, že AzCopy vygeneruje dva datové soubory poté, co uživatel určí možnost /SplitSize
. Výsledné názvy datových souborů můžou být:
myaccount_mytable_20140903T051850.8128447Z_0_0_C3040FE8.json
myaccount_mytable_20140903T051850.8128447Z_0_1_0AB9AC20.json
Mějte na paměti, že minimální možná hodnota pro možnost /SplitSize
je 32 MB. Pokud je zadaným cílem úložiště objektů blob, AzCopy rozdělí datový soubor, jakmile jeho velikost dosáhne omezení velikosti objektu blob (200 GB), bez ohledu na to, jestli byla možnost /SplitSize
určena uživatelem.
Export tabulky do formátu datového souboru JSON nebo CSV
Ve výchozím nastavení AzCopy exportuje tabulky do datových souborů JSON. Můžete zadat možnost /PayloadFormat:JSON|CSV
exportu tabulek jako JSON nebo CSV.
AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PayloadFormat:CSV
Při zadávání formátu datové části CSV vygeneruje AzCopy také soubor schématu s příponou .schema.csv
souboru pro každý datový soubor.
Souběžný export entit tabulky
AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PKRS:"aa#bb"
AzCopy spouští souběžné operace pro export entit, když uživatel určuje možnost /PKRS
. Každá operace exportuje jeden rozsah klíčů oddílu.
Všimněte si, že počet souběžných operací je také řízen možností /NC
. AzCopy používá počet procesorů jader jako výchozí hodnotu /NC
při kopírování entit tabulky, i když /NC
nebyl zadán. Když uživatel určí možnost /PKRS
, AzCopy použije menší ze dvou hodnot – rozsahy klíčů oddílů a implicitně nebo explicitně zadané souběžné operace – k určení počtu souběžných operací, které se mají spustit. Další podrobnosti získáte zadáním AzCopy /?:NC
na příkazový řádek.
Export tabulky do úložiště objektů blob
AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:https://myaccount.blob.core.windows.net/mycontainer/ /SourceKey:key1 /Destkey:key2
AzCopy vygeneruje do kontejneru objektů blob datový soubor JSON s následující konvencí pojmenování:
<account name>_<table name>_<timestamp>_<volume index>_<CRC>.json
Vygenerovaný datový soubor JSON se řídí formátem datové části pro minimální metadata. Podrobnosti o tomto formátu datové části najdete v tématu Formát datové části pro operace služby Table Service.
Všimněte si, že při exportu tabulek do objektů blob nástroj AzCopy stáhne entity tabulky do místních dočasných datových souborů a pak tyto entity nahraje do objektu blob. Tyto dočasné datové soubory se umístí do složky souboru deníku s výchozí cestou "%LocalAppData%\Microsoft\Azure\AzCopy
", můžete zadat možnost /Z:[journal-file-folder] pro změnu umístění složky souboru deníku a tím změnit umístění dočasných datových souborů. Velikost dočasných datových souborů je určena velikostí entit tabulky a velikostí, kterou jste zadali pomocí možnosti /SplitSize, i když dočasný datový soubor na místním disku se okamžitě odstraní po nahrání do objektu blob, ujistěte se, že máte dostatek místa na místním disku k uložení těchto dočasných datových souborů před odstraněním.
Import dat do služby Table Storage
Pojďme se podívat na import dat do azure Table Storage pomocí AzCopy.
Import tabulky
AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.core.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace
Tato možnost /EntityOperation
označuje, jak do tabulky vložit entity. Možné hodnoty jsou:
InsertOrSkip
: Přeskočí existující entitu nebo vloží novou entitu, pokud v tabulce neexistuje.InsertOrMerge
: Sloučí existující entitu nebo vloží novou entitu, pokud v tabulce neexistuje.InsertOrReplace
: Nahradí existující entitu nebo vloží novou entitu, pokud v tabulce neexistuje.
Všimněte si, že ve scénáři importu nelze zadat možnost /PKRS
. Na rozdíl od scénáře exportu, ve kterém je nutné zadat možnost /PKRS
pro spuštění souběžných operací, AzCopy spustí při importu tabulky ve výchozím nastavení souběžné operace. Výchozí počet spuštěných souběžných operací se rovná počtu procesorů jádra; můžete však zadat jiný počet souběžných s možností /NC
. Další podrobnosti získáte zadáním AzCopy /?:NC
na příkazový řádek.
Všimněte si, že AzCopy podporuje import jenom pro JSON, ne CSV. AzCopy nepodporuje importy tabulek ze souborů JSON a manifestu vytvořených uživatelem. Oba tyto soubory musí pocházet z exportu tabulky AzCopy. Abyste se vyhnuli chybám, neupravujte exportovaný soubor JSON ani soubor manifestu.
Import entit do tabulky z úložiště objektů blob
Předpokládejme, že kontejner objektů blob obsahuje následující: Soubor JSON představující tabulku Azure a přidružený soubor manifestu.
myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json
Spuštěním následujícího příkazu můžete importovat entity do tabulky pomocí souboru manifestu v tomto kontejneru objektů blob:
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"
Další funkce AzCopy
Pojďme se podívat na některé další funkce AzCopy.
Kopírovat pouze data, která v cíli neexistují
/XN
Parametry /XO
umožňují vyloučit z kopírování starších nebo novějších zdrojových prostředků. Pokud chcete kopírovat pouze zdrojové prostředky, které v cíli neexistují, můžete v příkazu AzCopy zadat oba parametry:
/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
Mějte na paměti, že tato možnost není podporována, pokud je zdrojem nebo cílem tabulka.
Zadání parametrů příkazového řádku pomocí souboru odpovědi
AzCopy /@:"C:\responsefiles\copyoperation.txt"
Do souboru odpovědi můžete zahrnout všechny parametry příkazového řádku AzCopy. AzCopy zpracuje parametry v souboru tak, jako kdyby byly zadány na příkazovém řádku, a provádí přímou náhradu obsahu souboru.
Předpokládejme soubor odpovědi s názvem copyoperation.txt
, který obsahuje následující řádky. Každý parametr AzCopy je možné zadat na jednom řádku.
/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y
nebo na samostatných řádcích:
/Source:http://myaccount.blob.core.windows.net/mycontainer
/Dest:C:\myfolder
/SourceKey:<sourcekey>
/S
/Y
AzCopy selže, pokud parametr rozdělíte mezi dva řádky, jak je znázorněno tady pro /sourcekey
parametr:
http://myaccount.blob.core.windows.net/mycontainer
C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y
Zadání parametrů příkazového řádku pomocí více souborů odpovědí
Předpokládejme soubor odpovědi s názvem source.txt
, který určuje zdrojový kontejner:
/Source:http://myaccount.blob.core.windows.net/mycontainer
A soubor odpovědi s názvem dest.txt
, který určuje cílovou složku v systému souborů:
/Dest:C:\myfolder
A soubor odpovědi s názvem options.txt
, který určuje možnosti pro AzCopy:
/S /Y
Pokud chcete volat AzCopy s těmito soubory odpovědí, všechny, které se nacházejí v adresáři C:\responsefiles
, použijte tento příkaz:
AzCopy /@:"C:\responsefiles\source.txt" /@:"C:\responsefiles\dest.txt" /SourceKey:<sourcekey> /@:"C:\responsefiles\options.txt"
AzCopy zpracuje tento příkaz stejně, jako kdybyste do příkazového řádku zahrnuli všechny jednotlivé parametry:
AzCopy /Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y
Zadání sdíleného přístupového podpisu (SAS)
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 identifikátoru URI kontejneru můžete také zadat SAS:
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1/?SourceSASToken /Dest:C:\myfolder /S
Složka souboru deníku
Pokaždé, když vydáte příkaz do AzCopy, zkontroluje, jestli soubor deníku existuje ve výchozí složce nebo jestli existuje ve složce, kterou jste zadali pomocí této možnosti. Pokud soubor deníku na jiném místě neexistuje, AzCopy zachází s operací jako s novým a vygeneruje nový soubor deníku.
Pokud soubor deníku existuje, AzCopy zkontroluje, jestli se zadaný příkazový řádek shoduje s příkazovým řádkem v souboru deníku. Pokud se oba příkazové řádky shodují, AzCopy obnoví nedokončenou operaci. Pokud se neshodují, zobrazí se výzva k přepsání souboru deníku, aby se spustila nová operace, nebo zrušit aktuální operaci.
Pokud chcete použít výchozí umístění souboru deníku:
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z
Pokud možnost vynecháte /Z
nebo zadáte možnost /Z
bez cesty ke složce, jak je uvedeno výše, AzCopy vytvoří soubor deníku ve výchozím umístění, což je %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy
. Pokud soubor deníku již existuje, AzCopy obnoví operaci na základě souboru deníku.
Pokud chcete zadat vlastní umístění souboru deníku:
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z:C:\journalfolder\
Tento příklad vytvoří soubor deníku, pokud ještě neexistuje. Pokud existuje, AzCopy obnoví operaci na základě souboru deníku.
Pokud chcete obnovit operaci AzCopy:
AzCopy /Z:C:\journalfolder\
Tento příklad obnoví poslední operaci, která se možná nepovedla dokončit.
Vygenerování souboru protokolu
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V
Pokud zadáte možnost /V
bez zadání cesty k souboru do podrobného protokolu, AzCopy vytvoří soubor protokolu ve výchozím umístění, což je %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy
.
V opačném případě můžete vytvořit soubor protokolu ve vlastním umístění:
AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V:C:\myfolder\azcopy1.log
Všimněte si, že pokud zadáte relativní cestu následující možnost /V
, například /V:test/azcopy1.log
, pak se podrobný protokol vytvoří v aktuálním pracovním adresáři v podsložce s názvem test
.
Zadejte počet souběžných operací, které se mají spustit.
Možnost /NC
určuje počet souběžných operací kopírování. AzCopy ve výchozím nastavení spustí určitý počet souběžných operací, aby se zvýšila propustnost přenosu dat. U tabulkových operací se počet souběžných operací rovná počtu procesorů, které máte. U operací objektů blob a souborů se počet souběžných operací rovná 8krát počtu procesorů, které máte. Pokud používáte AzCopy v síti s nízkou šířkou pásma, můžete zadat nižší číslo pro /NC, abyste se vyhnuli selhání způsobené konkurenci prostředků.
Spuštění nástroje AzCopy proti emulátoru úložiště Azure
AzCopy můžete spustit pro emulátor úložiště Azure pro objekty blob:
AzCopy /Source:https://127.0.0.1:10000/myaccount/mycontainer/ /Dest:C:\myfolder /SourceKey:key /SourceType:Blob /S
Můžete ho také spustit pro tabulky:
AzCopy /Source:https://127.0.0.1:10002/myaccount/mytable/ /Dest:C:\myfolder /SourceKey:key /SourceType:Table
Automatické určení typu obsahu objektu blob
AzCopy určuje typ obsahu objektu blob na základě souboru JSON, který ukládá typ obsahu na mapování přípony souboru. Tento soubor JSON má název AzCopyConfig.json a nachází se v adresáři AzCopy. Pokud máte typ souboru, který není v seznamu, můžete připojit mapování k souboru JSON:
{
"MIMETypeMapping": {
".myext": "text/mycustomtype",
.
.
}
}
Parametry AzCopy
Parametry pro AzCopy jsou popsány níže. Můžete také zadat jeden z následujících příkazů z příkazového řádku, který vám pomůže s používáním nástroje AzCopy:
- Podrobnou nápovědu k příkazovému řádku pro AzCopy:
AzCopy /?
- Podrobnou nápovědu k libovolnému parametru AzCopy:
AzCopy /?:SourceKey
- Příklady příkazového řádku:
AzCopy /?:Sample
/Source:"source"
Určuje zdrojová data, ze kterých se mají kopírovat. Zdrojem může být adresář systému souborů, kontejner objektů blob, virtuální adresář objektů blob, sdílená složka úložiště, adresář souborů úložiště nebo tabulka Azure.
Platí pro: Objekty blob, soubory, tabulky
/Dest:"destination"
Určuje cíl, do které se má kopírovat. Cílem může být adresář systému souborů, kontejner objektů blob, virtuální adresář objektů blob, sdílená složka úložiště, adresář souborů úložiště nebo tabulka Azure.
Platí pro: Objekty blob, soubory, tabulky
/Pattern:"file-pattern"
Určuje vzor souboru, který označuje, které soubory se mají kopírovat. Chování parametru /Pattern je určeno umístěním zdrojových dat a přítomností možnosti rekurzivního režimu. Rekurzivní režim je určen prostřednictvím možnosti /S.
Pokud je zadaným zdrojem adresář v systému souborů, projeví se standardní zástupné cardy a zadaný vzor souboru se shoduje se soubory v adresáři. Pokud je zadaná možnost /S, azCopy také odpovídá zadanému vzoru vůči všem souborům v podsložkách pod adresářem.
Pokud je zadaným zdrojem kontejner objektů blob nebo virtuální adresář, nepoužijí se zástupné cardy. Pokud je zadaná možnost /S, AzCopy interpretuje zadaný vzor souboru jako předponu objektu blob. Pokud není zadaná možnost /S, azCopy odpovídá vzoru souboru s přesnými názvy objektů blob.
Pokud je zadaným zdrojem sdílená složka Azure, musíte buď zadat přesný název souboru (např. abc.txt) ke zkopírování jednoho souboru, nebo zadat možnost /S pro rekurzivní kopírování všech souborů ve sdílené složce. Při pokusu o zadání vzoru souboru i možnosti /S dojde k chybě.
AzCopy používá porovnávání malých a velkých písmen, pokud je /Source kontejner objektů blob nebo virtuální adresář objektů blob, a ve všech ostatních případech používá porovnávání bez rozlišování malých a velkých písmen.
Výchozí vzor souboru použitý v případě, že není zadán žádný vzor souboru, je určen pro umístění systému souborů nebo prázdná předpona pro umístění služby Azure Storage. Zadání více vzorů souborů není podporováno.
Platí pro: Objekty blob, soubory
/DestKey:"storage-key"
Určuje klíč účtu úložiště pro cílový prostředek.
Platí pro: Objekty blob, soubory, tabulky
/DestSAS:"sas-token"
Určuje sdílený přístupový podpis (SAS) s oprávněními ke čtení a zápisu pro cíl (pokud je k dispozici). Ohraničí SAS dvojitými uvozovkami, protože může obsahovat speciální znaky příkazového řádku.
Pokud je cílovým prostředkem kontejner objektů blob, sdílená složka nebo tabulka, můžete buď zadat tuto možnost následovanou tokenem SAS, nebo můžete sas zadat jako součást cílového kontejneru objektů blob, identifikátoru URI sdílené složky nebo tabulky bez této možnosti.
Pokud jsou zdrojem i cílem oba objekty blob, musí se cílový objekt blob nacházet ve stejném účtu úložiště jako zdrojový objekt blob.
Platí pro: Objekty blob, soubory, tabulky
/SourceKey:"storage-key"
Určuje klíč účtu úložiště pro zdrojový prostředek.
Platí pro: Objekty blob, soubory, tabulky
/SourceSAS:"sas-token"
Určuje sdílený přístupový podpis s oprávněními READ a LIST pro zdroj (pokud je k dispozici). Ohraničí SAS dvojitými uvozovkami, protože může obsahovat speciální znaky příkazového řádku.
Pokud je zdrojovým prostředkem kontejner objektů blob a není k dispozici klíč ani SAS, pak se kontejner objektů blob přečte prostřednictvím anonymního přístupu.
Pokud je zdrojem sdílená složka nebo tabulka, musí být zadaný klíč nebo SAS.
Platí pro: Objekty blob, soubory, tabulky
/S
Určuje rekurzivní režim pro operace kopírování. V rekurzivním režimu AzCopy zkopíruje všechny objekty blob nebo soubory, které odpovídají zadanému vzoru souboru, včetně objektů v podsložkách.
Platí pro: Objekty blob, soubory
/BlobType:"block" | "page" | "append"
Určuje, jestli je cílovým objektem blob objekt blob bloku, objekt blob stránky nebo doplňovací objekt blob. Tato možnost platí jenom v případě, že nahráváte objekt blob. V opačném případě se vygeneruje chyba. Pokud je cílem objekt blob a tato možnost není ve výchozím nastavení zadaná, AzCopy vytvoří objekt blob bloku.
Použitelné pro: Objekty blob
/CheckMD5
Vypočítá hodnotu hash MD5 pro stažená data a ověří, že hodnota hash MD5 uložená ve vlastnosti Content-MD5 objektu blob nebo souboru odpovídá vypočítané hodnotě hash. Pokud se hodnoty neshodují, AzCopy data nestáhne. Ve výchozím nastavení je kontrola MD5 vypnutá, takže při stahování dat je nutné zadat tuto možnost.
Upozorňujeme, že Azure Storage nezaručuje, že hodnota hash MD5 uložená pro objekt blob nebo soubor je aktuální. Je zodpovědností klienta aktualizovat MD5 při každé změně objektu blob nebo souboru. V případě imagí disků (spravovaných nebo nespravovaných disků) virtuální počítače Azure neaktualizují hodnotu MD5 při změně obsahu disku, takže /CheckMD5 vyvolá chybu při stahování imagí disku.
AzCopy v8 po nahrání do služby vždy nastaví vlastnost Content-MD5 objektu blob nebo souboru Azure.
Platí pro: Objekty blob, soubory
/Snímek
Určuje, jestli se mají snímky přenášet. Tato možnost je platná pouze v případě, že zdrojem je objekt blob.
Snímky přenesených objektů blob se přejmenují v tomto formátu: název objektu blob (snímek-čas).extension
Ve výchozím nastavení se snímky nekopírují.
Použitelné pro: Objekty blob
/V:[verbose-log-file]
Vypíše podrobné stavové zprávy do souboru protokolu.
Ve výchozím nastavení je soubor podrobného protokolu pojmenován AzCopyVerbose.log v %LocalAppData%\Microsoft\Azure\AzCopy
. Pokud pro tuto možnost zadáte existující umístění souboru, připojí se k tomuto souboru podrobný protokol.
Platí pro: Objekty blob, soubory, tabulky
/Z:[journal-file-folder]
Určuje složku souboru deníku pro obnovení operace.
AzCopy vždy podporuje obnovení, pokud byla operace přerušena.
Pokud tato možnost není zadaná nebo je zadaná bez cesty ke složce, nástroj AzCopy vytvoří soubor deníku ve výchozím umístění, což je %LocalAppData%\Microsoft\Azure\AzCopy.
Pokaždé, když vydáte příkaz do AzCopy, zkontroluje, jestli soubor deníku existuje ve výchozí složce nebo jestli existuje ve složce, kterou jste zadali pomocí této možnosti. Pokud soubor deníku na jiném místě neexistuje, AzCopy zachází s operací jako s novým a vygeneruje nový soubor deníku.
Pokud soubor deníku existuje, AzCopy zkontroluje, jestli se zadaný příkazový řádek shoduje s příkazovým řádkem v souboru deníku. Pokud se oba příkazové řádky shodují, AzCopy obnoví nedokončenou operaci. Pokud se neshodují, zobrazí se výzva k přepsání souboru deníku, aby se spustila nová operace, nebo zrušit aktuální operaci.
Soubor deníku se odstraní po úspěšném dokončení operace.
Upozorňujeme, že obnovení operace ze souboru deníku vytvořeného předchozí verzí nástroje AzCopy se nepodporuje.
Platí pro: Objekty blob, soubory, tabulky
/@:"parameter-file"
Určuje soubor, který obsahuje parametry. AzCopy zpracovává parametry v souboru stejně, jako kdyby byly zadány na příkazovém řádku.
V souboru odpovědi můžete buď zadat více parametrů na jednom řádku, nebo zadat každý parametr na vlastním řádku. Všimněte si, že jednotlivý parametr nemůže obsahovat více řádků.
Soubory odpovědí můžou obsahovat řádky komentářů, které začínají symbolem #.
Můžete zadat více souborů odpovědí. Mějte ale na paměti, že Nástroj AzCopy nepodporuje vnořené soubory odpovědí.
Platí pro: Objekty blob, soubory, tabulky
/Y
Potlačí všechny výzvy k potvrzení nástroje AzCopy. Tato možnost také umožňuje použít tokeny SAS jen pro zápis pro scénáře nahrávání dat, pokud nejsou zadány /XO a /XN.
Platí pro: Objekty blob, soubory, tabulky
/L
Určuje pouze operaci výpisu; nejsou zkopírována žádná data.
AzCopy interpretuje použití této možnosti jako simulaci pro spuštění příkazového řádku bez této možnosti /L a spočítá, kolik objektů se kopíruje, můžete současně zadat možnost /V a zkontrolovat, které objekty se zkopírují do podrobného protokolu.
Chování této možnosti je také určeno umístěním zdrojových dat a přítomností možnosti rekurzivního režimu /S a možnosti vzoru souboru /Pattern.
AzCopy při použití této možnosti vyžaduje oprávnění LIST a READ tohoto zdrojového umístění.
Platí pro: Objekty blob, soubory
/MT
Nastaví čas poslední změny staženého souboru tak, aby byl stejný jako zdrojový objekt blob nebo soubor.
Platí pro: Objekty blob, soubory
/XN
Vyloučí novější zdrojový prostředek. Prostředek se nezkopíruje, pokud je čas poslední změny zdroje stejný nebo novější než cíl.
Platí pro: Objekty blob, soubory
/XO
Vyloučí starší zdrojový prostředek. Prostředek se nezkopíruje, pokud je čas poslední změny zdroje stejný nebo starší než cíl.
Platí pro: Objekty blob, soubory
/A
Nahraje pouze soubory, které mají nastavený atribut Archiv.
Platí pro: Objekty blob, soubory
/IA:[RASHCNETOI]
Nahraje pouze soubory, které mají nastavenou některou ze zadaných atributů.
Mezi dostupné atributy patří:
- R = soubory jen pro čtení
- A = Soubory připravené k archivaci
- S = Systémové soubory
- H = Skryté soubory
- C = Komprimované soubory
- N = Normální soubory
- E = Šifrované soubory
- T = Dočasné soubory
- O = Offline soubory
- I = Neindexované soubory
Platí pro: Objekty blob, soubory
/XA:[RASHCNETOI]
Vyloučí soubory, které mají některou ze zadaných atributů nastavenou.
Mezi dostupné atributy patří:
- R = soubory jen pro čtení
- A = Soubory připravené k archivaci
- S = Systémové soubory
- H = Skryté soubory
- C = Komprimované soubory
- N = Normální soubory
- E = Šifrované soubory
- T = Dočasné soubory
- O = Offline soubory
- I = Neindexované soubory
Platí pro: Objekty blob, soubory
/Delimiter:"delimiter"
Označuje znak oddělovače použitý k oddělovači virtuálních adresářů v názvu objektu blob.
Ve výchozím nastavení azcopy používá znak oddělovače / jako znak oddělovače. AzCopy však podporuje použití libovolného společného znaku (například @, #nebo %) jako oddělovače. Pokud potřebujete do příkazového řádku zahrnout jeden z těchto speciálních znaků, uzavřete název souboru do dvojitých uvozovek.
Tato možnost se vztahuje pouze na stahování objektů blob.
Použitelné pro: Objekty blob
/NC:"number-of-concurrent-operations"
Určuje počet souběžných operací.
AzCopy ve výchozím nastavení spustí určitý počet souběžných operací pro zvýšení propustnosti přenosu dat. Mějte na paměti, že velký počet souběžných operací v prostředí s nízkou šířkou pásma může zahltit síťové připojení a zabránit úplnému dokončení operací. Omezení souběžných operací na základě skutečné dostupné šířky pásma sítě
Horní limit souběžných operací je 512.
Platí pro: Objekty blob, soubory, tabulky
/SourceType:"Blob" | "Tabulka"
Určuje, že source
prostředek je objekt blob dostupný v místním vývojovém prostředí, který běží v emulátoru úložiště.
Použitelné pro: Objekty blob, tabulky
/DestType:"Blob" | "Tabulka"
Určuje, že destination
prostředek je objekt blob dostupný v místním vývojovém prostředí, který běží v emulátoru úložiště.
Použitelné pro: Objekty blob, tabulky
/PKRS:"key1#key2#key3#..."
Rozdělí rozsah klíčů oddílu, aby bylo možné exportovat data tabulky paralelně, což zvyšuje rychlost operace exportu.
Pokud tato možnost není zadaná, AzCopy k exportu entit tabulky použije jedno vlákno. Pokud například uživatel zadá /PKRS:"aa#bb", azCopy spustí tři souběžné operace.
Každá operace exportuje jeden ze tří rozsahů klíčů oddílů, jak je znázorněno níže:
[first-partition-key, aa)
[aa, bb)
[bb, last-partition-key]
Použitelné pro: Tabulky
/SplitSize:"file-size"
Určuje velikost rozdělení exportovaného souboru v MB, minimální povolená hodnota je 32.
Pokud tato možnost není zadaná, AzCopy exportuje data tabulky do jednoho souboru.
Pokud se data tabulky exportují do objektu blob a exportovaná velikost souboru dosáhne limitu 200 GB pro velikost objektu blob, AzCopy rozdělí exportovaný soubor, i když tato možnost není zadaná.
Použitelné pro: Tabulky
/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"
Určuje chování importu dat tabulky.
- InsertOrSkip – Přeskočí existující entitu nebo vloží novou entitu, pokud v tabulce neexistuje.
- InsertOrMerge – Sloučí existující entitu nebo vloží novou entitu, pokud v tabulce neexistuje.
- InsertOrReplace – Nahradí existující entitu nebo vloží novou entitu, pokud v tabulce neexistuje.
Použitelné pro: Tabulky
/Manifest:"manifest-file"
Určuje soubor manifestu pro operaci exportu a importu tabulky.
Tato možnost je volitelná během operace exportu, AzCopy vygeneruje soubor manifestu s předdefinovaným názvem, pokud tato možnost není zadána.
Tato možnost se vyžaduje během operace importu pro vyhledání datových souborů.
Použitelné pro: Tabulky
/SyncCopy
Určuje, jestli se mají synchronně kopírovat objekty blob nebo soubory mezi dvěma koncovými body služby Azure Storage.
AzCopy ve výchozím nastavení používá asynchronní kopírování na straně serveru. Tuto možnost zadejte, pokud chcete provést synchronní kopii, která stáhne objekty blob nebo soubory do místní paměti a pak je nahraje do služby Azure Storage.
Tuto možnost můžete použít při kopírování souborů v úložišti objektů blob, v rámci úložiště File nebo z úložiště objektů blob do úložiště File nebo naopak.
Platí pro: Objekty blob, soubory
/SetContentType:"content-type"
Určuje typ obsahu MIME pro cílové objekty blob nebo soubory.
AzCopy ve výchozím nastavení nastaví typ obsahu objektu blob nebo souboru na application/octet-stream. Typ obsahu pro všechny objekty blob nebo soubory můžete nastavit explicitním zadáním hodnoty pro tuto možnost.
Pokud tuto možnost zadáte bez hodnoty, AzCopy nastaví jednotlivé objekty blob nebo typ obsahu souboru podle jeho přípony souboru.
Platí pro: Objekty blob, soubory
/PayloadFormat:"JSON" | "CSV"
Určuje formát exportovaného datového souboru tabulky.
Pokud tuto možnost nezadáte, AzCopy ve výchozím nastavení exportuje datový soubor tabulky ve formátu JSON.
Použitelné pro: Tabulky
Známé problémy a osvědčené postupy
Pojďme se podívat na některé známé problémy a osvědčené postupy.
Omezení souběžných zápisů při kopírování dat
Při kopírování objektů blob nebo souborů pomocí nástroje AzCopy mějte na paměti, že během kopírování může data upravovat jiná aplikace. Pokud je to možné, ujistěte se, že se během operace kopírování neupravují data, která kopírujete. Například při kopírování virtuálního pevného disku přidruženého k virtuálnímu počítači Azure se ujistěte, že do virtuálního pevného disku aktuálně nezapisují žádné jiné aplikace. Dobrým způsobem, jak to udělat, je pronájem prostředku, který se má zkopírovat. Případně můžete nejprve vytvořit snímek virtuálního pevného disku a pak snímek zkopírovat.
Pokud při kopírování nemůžete zabránit jiným aplikacím v zápisu do objektů blob nebo souborů, mějte na paměti, že po dokončení úlohy nemusí mít zkopírované prostředky úplnou paritu se zdrojovými prostředky.
Povolte algoritmy MD5 kompatibilní se standardem FIPS pro AzCopy při použití algoritmů kompatibilních se standardem FIPS pro šifrování, hashování a podepisování.
AzCopy ve výchozím nastavení používá implementaci .NET MD5 k výpočtu MD5 při kopírování objektů, ale existují některé požadavky na zabezpečení, které vyžadují AzCopy k povolení nastavení MD5 kompatibilního s FIPS.
Můžete vytvořit soubor AzCopy.exe.config
app.config s vlastností AzureStorageUseV1MD5
a dát ho stranou AzCopy.exe.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="AzureStorageUseV1MD5" value="false"/>
</appSettings>
</configuration>
Vlastnost AzureStorageUseV1MD5:
- True – Výchozí hodnota, AzCopy používá implementaci .NET MD5.
- False – AzCopy používá algoritmus MD5 kompatibilní se standardem FIPS.
Algoritmy kompatibilní se standardem FIPS jsou ve Výchozím nastavení ve Windows zakázané. Toto nastavení zásad můžete změnit na svém počítači. V okně Spustit (Windows+R) zadejte secpol.msc a otevřete okno Místní zásady zabezpečení. V okně Nastavení zabezpečení přejděte na Možnosti zabezpečení>místních zásad>nastavení zabezpečení. Vyhledejte kryptografii systému: Pro šifrování, hashování a podepisování zásad použijte algoritmy kompatibilní se standardem FIPS. Poklikáním na zásadu zobrazíte hodnotu zobrazenou ve sloupci Nastavení zabezpečení.
Další kroky
Další informace o službě Azure Storage a AzCopy najdete v následujících zdrojích informací:
Dokumentace ke službě Azure Storage:
- Seznámení se službou Azure Storage
- Jak používat úložiště objektů blob z .NET
- Jak používat úložiště souborů z .NET
- Použití služby Table Storage z .NET
- Vytvoření, správa nebo odstranění účtu úložiště
- Přenos dat pomocí AzCopy v Linuxu
Blogové příspěvky ke službě Azure Storage:
- Představujeme knihovnu pro přesun dat ve službě Azure Storage ve verzi Preview
- AzCopy: Představujeme synchronní kopírování a přizpůsobený typ obsahu
- AzCopy: Oznámení obecné dostupnosti nástroje AzCopy 3.0 a verze Preview nástroje AzCopy 4.0 s podporou tabulek a souborů
- AzCopy: Optimalizované pro scénáře kopírování ve velkém měřítku
- AzCopy: Podpora geograficky redundantního úložiště jen pro čtení
- AzCopy: Přenos dat s restartovatelným režimem a tokenem SAS
- AzCopy: Použití kopírování objektu blob mezi účty
- AzCopy: Nahrávání a stahování souborů pro objekty blob Azure