Adatok áthelyezése az AzCopy 8.1-es verziójával Windows rendszeren

  • Cikk

Az AzCopy egy parancssori segédprogram, amely a Microsoft Azure Blob-, File- és Table Storage-tárolókba és -tárolókba másol adatokat az optimális teljesítmény érdekében tervezett egyszerű parancsokkal. Az adatokat egy fájlrendszer és egy tárfiók, illetve több tárfiók között is másolhatja.

Fontos

Ez a cikk az AzCopy egy régebbi verzióját ismerteti. Az AzCopy legújabb verziójának telepítéséhez tekintse meg az AzCopy 10-es verzióját.

Ha az AzCopy régebbi verzióját (AzCopy 8.1-es verzió) telepíti, akkor több verziót is letölthet. Az AzCopy Windows rendszeren windowsos stílusú parancssori lehetőségeket kínál. A Linuxon futó AzCopy a POSIX stílusú parancssori lehetőségeket kínáló Linux-platformokat célozza meg. Ez a cikk a WindowsOn futó AzCopyt ismerteti.

Az AzCopy (v8.1) letöltése és telepítése Windows rendszeren

Töltse le az AzCopyt (v8.1) Windows rendszeren.

AzCopy a Windows 8.1 kiadási megjegyzéseiben

  • A Table Service már nem támogatott a legújabb verzióban. Ha táblaexportálási funkciót használ, töltse le az AzCopy 7.3-at.
  • A .NET Core 2.1-zel készült, és az összes .NET Core-függőség be van csomagolva a telepítésbe.
  • OAuth-hitelesítés támogatása hozzáadva. Az Azure Active Directory használatával történő bejelentkezéshez használható azcopy login .

AzCopy táblatámogatással (7.3-s verzió)

Töltse le az AzCopy 7.3-at táblatámogatással.

Telepítés utáni lépés

Miután telepítette az AzCopyt a Windowsra a telepítővel, nyisson meg egy parancsablakot, és keresse meg az AzCopy telepítési könyvtárát a számítógépen , ahol a AzCopy.exe végrehajtható fájl található. Szükség esetén hozzáadhatja az AzCopy telepítési helyét a rendszerútvonalhoz. Alapértelmezés szerint az AzCopy telepítve van a következőre %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy : vagy %ProgramFiles%\Microsoft SDKs\Azure\AzCopy.

Az első AzCopy-parancs írása

Az AzCopy-parancsok alapszintaxisa:

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

Az alábbi példák számos forgatókönyvet mutatnak be az adatok Microsoft Azure-blobokra, fájlokra és táblákra történő másolására. Az egyes mintákban használt paraméterek részletes magyarázatáért tekintse meg az AzCopy-paraméterek szakaszt.

Blobok letöltése a Blob Storage-ból

Tekintsük át a blobok AzCopyval való letöltésének számos módját.

Egyetlen blob letöltése

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

Vegye figyelembe, hogy ha a mappa C:\myfolder nem létezik, az AzCopy létrehozza, és letölti abc.txt az új mappába.

Egyetlen blob letöltése a másodlagos régióból

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

Vegye figyelembe, hogy a másodlagos régió eléréséhez engedélyeznie kell az írásvédett georedundáns tárolást.

Tárolóban lévő összes blob letöltése

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

Tegyük fel, hogy a következő blobok a megadott tárolóban találhatók:

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

A letöltési művelet után a könyvtár C:\myfolder a következő fájlokat tartalmazza:

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

Ha nem adja meg a beállítást /S, a rendszer nem tölt le blobokat.

Adott előtaggal rendelkező blobok letöltése

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

Tegyük fel, hogy a következő blobok a megadott tárolóban találhatók. Az előtaggal a kezdődő összes blob letöltődik:

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

A letöltési művelet után a mappa C:\myfolder a következő fájlokat tartalmazza:

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

Az előtag a virtuális könyvtárra vonatkozik, amely a blobnév első részét képezi. A fenti példában a virtuális könyvtár nem egyezik a megadott előtaggal, ezért nem töltődik le. Ha a beállítás /S nincs megadva, az AzCopy nem tölt le blobokat.

Az exportált fájlok utolsó módosítási idejének beállítása a forrásblobokkal megegyezőre

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

A blobokat az utolsó módosítás időpontja alapján is kizárhatja a letöltési műveletből. Ha például ki szeretné zárni azokat a blobokat, amelyek utolsó módosítási ideje megegyezik vagy újabb a célfájlénál, adja hozzá a /XN következő lehetőséget:

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

Ha ki szeretné zárni azokat a blobokat, amelyek utolsó módosítási időpontja megegyezik vagy régebbi a célfájlénál, adja hozzá a /XO következő lehetőséget:

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

Blobok feltöltése Blob Storage-ba

Vizsgáljuk meg a blobok AzCopyval való feltöltésének több módját.

Egyetlen blob feltöltése

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

Ha a célként megadott tároló nem létezik, az AzCopy létrehozza, majd feltölti a fájlt a tárolóba.

Egyetlen blob feltöltése virtuális könyvtárba

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

Ha a megadott virtuális könyvtár nem létezik, az AzCopy feltölti a fájlt, hogy belefoglalja a virtuális könyvtárat a nevébe (példáulvd/abc.txt a fenti példában).

Egy mappában lévő összes blob feltöltése

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

A beállítás /S megadása rekurzív módon tölti fel a megadott könyvtár tartalmát a Blob Storage-ba, ami azt jelenti, hogy az összes almappát és azok fájljait is feltölti a rendszer. Tegyük fel például, hogy a következő fájlok a mappában C:\myfoldertalálhatók:

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

A feltöltési művelet után a tároló a következő fájlokat tartalmazza:

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

Ha nem adja meg a beállítást /S, az AzCopy nem tölt fel rekurzívan. A feltöltési művelet után a tároló a következő fájlokat tartalmazza:

abc.txt
abc1.txt
abc2.txt

Adott mintának megfelelő blobok feltöltése

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

Tegyük fel, hogy a következő fájlok a mappában C:\myfoldertalálhatók:

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

A feltöltési művelet után a tároló a következő fájlokat tartalmazza:

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

Ha nem adja meg a beállítást /S, az AzCopy csak olyan blobokat tölt fel, amelyek nem egy virtuális könyvtárban találhatók:

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

Célblob MIME-tartalomtípusának megadása

Alapértelmezés szerint az AzCopy a célblob tartalomtípusát a következőre application/octet-streamállítja be: . A 3.1.0-s verziótól kezdve explicit módon megadhatja a tartalomtípust a beállítással /SetContentType:[content-type]. Ez a szintaxis egy feltöltési művelet összes blobjának tartalomtípusát állítja be.

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

Ha érték nélkül adja meg /SetContentType , az AzCopy az egyes blobok vagy fájlok tartalomtípusát a fájlkiterjesztésének megfelelően állítja be.

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

Blobok másolása a Blob Storage-ban

Vizsgáljuk meg, hogyan másolhat blobokat egyik helyről a másikra az AzCopy használatával.

Egyetlen blob másolása egy tárolóból egy másikba ugyanabban a tárfiókban

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

Ha egy Storage-fiókban lévő blobot másol, a rendszer kiszolgálóoldali másolási műveletet hajt végre.

Egyetlen blob másolása egy tárfiókból egy másikba

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

Amikor egy blobot tárfiókok között másol, a rendszer kiszolgálóoldali másolási műveletet hajt végre.

Egyetlen blob másolása a másodlagos régióból az elsődleges régióba

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

Vegye figyelembe, hogy a másodlagos tároló eléréséhez engedélyeznie kell az írásvédett georedundáns tárolást.

Egyetlen blob és pillanatképének másolása egy tárfiókból egy másikba

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

A másolási művelet után a céltároló tartalmazza a blobot és annak pillanatképeit. Feltételezve, hogy a fenti példában szereplő blob két pillanatképet tartalmaz, a tároló a következő blobot és pillanatképeket tartalmazza:

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

Egy tároló összes blobának másolása egy másik tárfiókba

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

Az /S beállítás megadása rekurzív módon tölti fel a megadott tároló tartalmát. További információkért és példákért tekintse meg a mappa összes blobjának feltöltése című témakört.

Blobok szinkronizálása egy tárfiókból egy másikba

Az AzCopy alapértelmezés szerint két tárolási végpont között aszinkron módon másolja az adatokat. Ezért a másolási művelet a háttérben fut olyan tartalék sávszélesség-kapacitással, amely nem rendelkezik SLA-val a blobok másolásának gyorsasága szempontjából, és az AzCopy rendszeres időközönként ellenőrzi a másolás állapotát, amíg a másolás befejeződik vagy sikertelen lesz.

Ez a /SyncCopy beállítás biztosítja, hogy a másolási művelet konzisztens sebességet kapjon. Az AzCopy úgy hajtja végre a szinkron másolatot, hogy letölti a blobokat a megadott forrásból a helyi memóriába másolandó blobok letöltésével, majd feltölti őket a Blob Storage célhelyére.

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 az aszinkron másolathoz képest további kimenő forgalmat eredményezhet. A kimenő forgalom elkerülése érdekében ajánlott ezt a lehetőséget használni egy olyan Azure-beli virtuális gépen, amely ugyanabban a régióban található, mint a forrás tárfiókja.

Fájlok letöltése a File Storage-ból

Tekintsük át a fájlok az AzCopyval való letöltésének számos módját.

Egyetlen fájl letöltése

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

Ha a megadott forrás egy Azure-fájlmegosztás, akkor meg kell adnia a pontos fájlnevet (példáulabc.txt) egyetlen fájl letöltéséhez, vagy meg kell adnia a megosztásban lévő összes fájl rekurzív letöltésének lehetőségét /S . A fájlminta és a beállítás /S együttes megadásának megkísérlése hibát eredményez.

Könyvtárban lévő összes fájl letöltése

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

Vegye figyelembe, hogy az üres mappák nem töltődnek le.

Fájlok feltöltése Azure-fájlmegosztásba

Tekintsük át a fájlok az AzCopyval való feltöltésének számos módját.

Egyetlen fájl feltöltése

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

Egy mappában lévő összes fájl feltöltése

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

Vegye figyelembe, hogy az üres mappák nincsenek feltöltve.

Adott mintának megfelelő fájlok feltöltése

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

Fájlok másolása a Fájltárolóban

Vizsgáljuk meg az Azure-fájlmegosztások fájljainak az AzCopyval történő másolásának több módját.

Másolás egy fájlmegosztásból egy másikba

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

Amikor fájlokat másol fájlmegosztások között, a rendszer kiszolgálóoldali másolási műveletet hajt végre.

Másolás Azure-fájlmegosztásból Blob Storage-ba

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

Amikor fájlmegosztásból blobba másol egy fájlt, a rendszer kiszolgálóoldali másolási műveletet hajt végre.

Blob másolása Blob Storage-ból Azure-fájlmegosztásba

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

Amikor fájlokat másol egy blobból egy fájlmegosztásba, a rendszer kiszolgálóoldali másolási műveletet hajt végre.

Fájlok szinkronizálása

Megadhatja, hogy a /SyncCopy Fájltárolóból a File Storage-ba, a File Storage-ból a Blob Storage-ba, valamint a Blob Storage-ból a File Storage-ba szinkron módon másoljon adatokat. Az AzCopy ezt úgy teszi meg, hogy letölti a forrásadatokat a helyi memóriába, és újra feltölti azokat a célhelyre. A normál kimenő forgalom költsége érvényes.

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

A Fájltárolóból a Blob Storage-ba történő másoláskor az alapértelmezett blobtípus a blokkblob; a felhasználó megadhatja a célblob típusának módosítására vonatkozó lehetőséget /BlobType:page .

Vegye figyelembe, hogy az /SyncCopy aszinkron másolathoz képest további kimenő költségekkel járhat. A kimenő forgalom költségeinek elkerülése érdekében ajánlott ezt a lehetőséget használni az Azure-beli virtuális gépen, amely ugyanabban a régióban található, mint a forrás tárfiókja.

Adatok exportálása a Table Storage-ból

Vessünk egy pillantást az Adatok exportálása az Azure Table Storage-ból az AzCopy használatával.

Tábla exportálása

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

Az AzCopy egy jegyzékfájlt ír a megadott célmappába. A jegyzékfájlt az importálási folyamat használja a szükséges adatfájlok megkereséséhez és az adatérvényesítés végrehajtásához. A jegyzékfájl alapértelmezés szerint a következő elnevezési konvenciót használja:

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

A felhasználó megadhatja a /Manifest:<manifest file name> jegyzékfájl nevének beállítását is.

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

Exportálás felosztása a Table Storage-ból több fájlra

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

Az AzCopy a felosztott adatfájlnevekben egy kötetindexet használ több fájl megkülönböztetésére. A kötetindex két részből áll, egy partíciókulcs-tartományindexből és egy felosztott fájlindexből. Mindkét index nulla alapú.

A partíciókulcs-tartomány indexe 0, ha a felhasználó nem adja meg a beállítást /PKRS.

Tegyük fel például, hogy az AzCopy két adatfájlt hoz létre, miután a felhasználó megadja a beállítást /SplitSize. Az eredményként kapott adatfájlnevek a következőek lehetnek:

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

Vegye figyelembe, hogy a beállítás /SplitSize minimális lehetséges értéke 32 MB. Ha a megadott cél a Blob Storage, az AzCopy felosztja az adatfájlt, miután a mérete elérte a blobméret korlátozását (200 GB), függetlenül attól, hogy a felhasználó megadta-e a beállítást /SplitSize .

Tábla exportálása JSON- vagy CSV-adatfájlformátumba

Alapértelmezés szerint az AzCopy JSON-adatfájlokba exportálja a táblákat. Megadhatja a táblák JSON-ként vagy CSV-ként való exportálásának lehetőségét /PayloadFormat:JSON|CSV .

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

A CSV hasznos adatformátumának megadásakor az AzCopy egy sémafájlt is létrehoz fájlkiterjesztéssel .schema.csv az egyes adatfájlokhoz.

Táblaentitások egyidejű exportálása

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

Az AzCopy egyidejű műveleteket indít el az entitások exportálásához, amikor a felhasználó megadja a beállítást /PKRS. Minden művelet egy partíciókulcs-tartományt exportál.

Vegye figyelembe, hogy az egyidejű műveletek számát a beállítás /NCis szabályozza. Az AzCopy az alapprocesszorok számát használja a táblaentitások másolásának /NC alapértelmezett értékeként, még akkor is, ha /NC nincs megadva. Amikor a felhasználó megadja a beállítást /PKRS, az AzCopy a két érték közül a kisebbet használja – a partíciókulcs-tartományokat az implicit vagy explicit módon megadott egyidejű műveletek helyett –, hogy meghatározza az egyidejűleg indítandó műveletek számát. További részletekért írja be AzCopy /?:NC a parancssorba.

Tábla exportálása Blob Storage-ba

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

Az AzCopy létrehoz egy JSON-adatfájlt a blobtárolóba a következő elnevezési konvencióval:

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

A létrehozott JSON-adatfájl a minimális metaadatok hasznos adatformátumát követi. Ennek a hasznosadat-formátumnak a részleteiért lásd a Table Service-műveletek hasznosadat-formátumát.

Vegye figyelembe, hogy amikor táblákat exportál blobokbe, az AzCopy letölti a Table-entitásokat a helyi ideiglenes adatfájlokba, majd feltölti ezeket az entitásokat a blobba. Ezek az ideiglenes adatfájlok a "" alapértelmezett elérési úttal%LocalAppData%\Microsoft\Azure\AzCopy kerülnek a naplófájl mappájába. A /Z:[journal-file-folder] lehetőséget megadva módosíthatja a naplófájl mappájának helyét, és így módosíthatja az ideiglenes adatfájlok helyét. Az ideiglenes adatfájlok méretét a táblaentitások mérete és a /SplitSize beállítással megadott méret határozza meg, bár a helyi lemezen lévő ideiglenes adatfájl azonnal törlődik a blobba való feltöltés után, győződjön meg arról, hogy elegendő helyi lemezterülettel rendelkezik ahhoz, hogy ezeket az ideiglenes adatfájlokat a törlésük előtt tárolja.

Adatok importálása a Table Storage-ba

Vessünk egy pillantást az adatok Azure Table Storage-ba való importálására az AzCopy használatával.

Tábla importálása

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

A beállítás /EntityOperation azt jelzi, hogyan szúrhat be entitásokat a táblába. Lehetséges értékek:

  • InsertOrSkip: Kihagy egy meglévő entitást, vagy új entitást szúr be, ha az nem létezik a táblában.
  • InsertOrMerge: Egy meglévő entitást egyesít, vagy új entitást szúr be, ha az nem létezik a táblában.
  • InsertOrReplace: Lecserél egy meglévő entitást, vagy új entitást szúr be, ha az nem létezik a táblában.

Vegye figyelembe, hogy az importálási forgatókönyvben nem adhat meg beállítást /PKRS . Az exportálási forgatókönyvtől eltérően, amelyben meg kell adnia az egyidejű műveletek indításának lehetőségét /PKRS , az AzCopy alapértelmezés szerint elindítja az egyidejű műveleteket egy tábla importálásakor. Az egyidejűleg indított műveletek alapértelmezett száma megegyezik a magprocesszorok számával; a beállítással /NCazonban eltérő számú egyidejű beállítást adhat meg. További részletekért írja be AzCopy /?:NC a parancssorba.

Vegye figyelembe, hogy az AzCopy csak a JSON-alapú importálást támogatja, a CSV-t nem. Az AzCopy nem támogatja a felhasználó által létrehozott JSON- és jegyzékfájlokból származó táblaimportálást. Mindkét fájlnak az AzCopy-tábla exportálásából kell származnia. A hibák elkerülése érdekében ne módosítsa az exportált JSON- vagy jegyzékfájlt.

Entitások importálása egy táblába Blob Storage-ból

Tegyük fel, hogy egy Blob-tároló a következőket tartalmazza: Egy Azure-táblát és annak kísérő jegyzékfájlját jelölő JSON-fájl.

myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json

A következő parancs futtatásával entitásokat importálhat egy táblába a blobtároló jegyzékfájljának használatával:

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"

Egyéb AzCopy-funkciók

Vessünk egy pillantást néhány más AzCopy-funkcióra.

Csak olyan adatok másolása, amelyek nem léteznek a célhelyen

A /XO paraméterek és /XN a paraméterek lehetővé teszik a régebbi vagy újabb forráserőforrások másolásának kizárását. Ha csak olyan forráserőforrásokat szeretne másolni, amelyek nem léteznek a célhelyen, mindkét paramétert megadhatja az AzCopy parancsban:

/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

Vegye figyelembe, hogy ez nem támogatott, ha a forrás vagy a cél egy tábla.

Parancssori paraméterek megadása válaszfájl használatával

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

A válaszfájlba bármilyen AzCopy parancssori paramétert belefoglalhat. Az AzCopy úgy dolgozza fel a fájl paramétereit, mintha a parancssorban lettek volna megadva, és közvetlen helyettesítést végez a fájl tartalmával.

Tegyük fel, hogy a válaszfájl neve copyoperation.txt, amely a következő sorokat tartalmazza. Minden AzCopy-paraméter megadható egyetlen sorban

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

vagy külön sorokban:

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

Az AzCopy meghiúsul, ha a paramétert két sorra osztja fel, ahogy az itt látható a /sourcekey paraméter esetében:

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

Parancssori paraméterek megadása több válaszfájllal

Tegyük fel, hogy egy forrástárolót meghatározó válaszfájl neve source.txt :

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

És egy válaszfájl neve dest.txt , amely megadja a célmappát a fájlrendszerben:

/Dest:C:\myfolder

És egy válaszfájl neve options.txt , amely megadja az AzCopy beállításait:

/S /Y

A következő paranccsal hívhatja meg az AzCopyt ezekkel a válaszfájlokkal, amelyek mindegyike egy könyvtárban C:\responsefilestalálható:

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

Az AzCopy ugyanúgy dolgozza fel ezt a parancsot, mintha az összes egyes paramétert belefoglalná a parancssorba:

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

Közös hozzáférésű jogosultságkód (SAS) megadása

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

SAS-t is megadhat a tároló URI-ján:

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

Naplófájl mappája

Minden alkalommal, amikor parancsot ad ki az AzCopynak, ellenőrzi, hogy létezik-e naplófájl az alapértelmezett mappában, vagy hogy létezik-e az ebben a beállításban megadott mappában. Ha a naplófájl egyik helyen sem létezik, az AzCopy újként kezeli a műveletet, és létrehoz egy új naplófájlt.

Ha a naplófájl létezik, az AzCopy ellenőrzi, hogy a bevitt parancssor megegyezik-e a naplófájl parancssorával. Ha a két parancssor egyezik, az AzCopy folytatja a hiányos műveletet. Ha nem egyeznek meg, a rendszer kérni fogja, hogy írja felül a naplófájlt egy új művelet elindításához, vagy szakítsa meg az aktuális műveletet.

Ha a naplófájl alapértelmezett helyét szeretné használni:

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

Ha kihagyja a beállítást /Z, vagy a mappa elérési útja nélkül adja meg a beállítást /Z , a fent látható módon az AzCopy létrehozza a naplófájlt az alapértelmezett helyen, azaz %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy. Ha a naplófájl már létezik, az AzCopy a naplófájl alapján folytatja a műveletet.

Ha egyéni helyet szeretne megadni a naplófájlhoz:

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

Ez a példa létrehozza a naplófájlt, ha még nem létezik. Ha létezik, akkor az AzCopy a naplófájl alapján folytatja a műveletet.

Ha folytatni szeretné az AzCopy-műveletet:

AzCopy /Z:C:\journalfolder\

Ez a példa folytatja az utolsó műveletet, amely esetleg nem fejeződött be.

Naplófájl létrehozása

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

Ha a részletes napló elérési útjának megadása nélkül adja meg a beállítást /V , akkor az AzCopy az alapértelmezett helyen hozza létre a naplófájlt, amely az %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy.

Ellenkező esetben létrehozhat egy naplófájlt egy egyéni helyen:

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

Vegye figyelembe, hogy ha relatív elérési utat ( /Vpéldául /V:test/azcopy1.log) ad meg, akkor a részletes napló az aktuális munkakönyvtárban jön létre a nevesített testalmappában.

Az egyidejű elindítandó műveletek számának megadása

A beállítás /NC az egyidejű másolási műveletek számát adja meg. Alapértelmezés szerint az AzCopy bizonyos számú egyidejű műveletet indít el az adatátviteli sebesség növelése érdekében. Táblaműveletek esetén az egyidejű műveletek száma megegyezik a processzorok számával. Blob- és fájlműveletek esetén az egyidejű műveletek száma megegyezik a processzorok számának 8-szorosával. Ha az AzCopyt alacsony sávszélességű hálózaton futtatja, az erőforrás-verseny által okozott hibák elkerülése érdekében megadhat alacsonyabb számot a /NC számára.

Az AzCopy futtatása az Azure Storage Emulatoron

Az AzCopyt futtathatja a blobokhoz készült Azure Storage Emulatoron :

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

Táblákhoz is futtathatja:

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

Blob tartalomtípusának automatikus meghatározása

Az AzCopy egy olyan JSON-fájl alapján határozza meg a blob tartalomtípusát, amely fájlkiterjesztés-leképezésre tárolja a tartalomtípust. Ez a JSON-fájl neve AzCopyConfig.json, és az AzCopy könyvtárban található. Ha olyan fájltípussal rendelkezik, amely nem szerepel a listában, hozzáfűzheti a leképezést a JSON-fájlhoz:

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

AzCopy-paraméterek

Az AzCopy paramétereit az alábbiakban ismertetjük. Az AzCopy használatához a parancssorból az alábbi parancsok egyikét is beírhatja:

  • Részletes parancssori súgó az AzCopyhoz: AzCopy /?
  • Részletes segítség az AzCopy-paraméterekkel kapcsolatban: AzCopy /?:SourceKey
  • Parancssori példák esetén: AzCopy /?:Sample

/Source:"source"

Meghatározza a forrásadatokat, amelyekből másolni szeretne. A forrás lehet fájlrendszerkönyvtár, blobtároló, blob virtuális könyvtár, tárolófájlmegosztás, tárolófájl-könyvtár vagy Azure-tábla.

A következőre vonatkozik: Blobok, fájlok, táblák

/Dest:"destination"

Meghatározza a célhelyet, amelybe a másolást szeretné. A cél lehet egy fájlrendszerkönyvtár, egy blobtároló, egy blob virtuális könyvtár, egy tárfájlmegosztás, egy tárolófájl könyvtára vagy egy Azure-tábla.

A következőre vonatkozik: Blobok, fájlok, táblák

/Pattern:"file-pattern"

Egy fájlmintát ad meg, amely jelzi, hogy mely fájlokat szeretné másolni. A /Pattern paraméter viselkedését a forrásadatok helye és a rekurzív mód beállítása határozza meg. A rekurzív mód az /S lehetőséggel van megadva.

Ha a megadott forrás egy könyvtár a fájlrendszerben, akkor a szabványos helyettesítő karakterek érvényesek, és a megadott fájlminta megegyezik a könyvtárban lévő fájlokkal. Ha az /S beállítás meg van adva, akkor az AzCopy a könyvtár alatti almappákban lévő összes fájlra is megfelel a megadott mintának.

Ha a megadott forrás egy blobtároló vagy virtuális könyvtár, akkor a program nem alkalmaz helyettesítő karaktereket. Ha az /S lehetőség meg van adva, akkor az AzCopy blobelőtagként értelmezi a megadott fájlmintát. Ha a /S lehetőség nincs megadva, akkor az AzCopy megfelelteti a fájlmintát a pontos blobneveknek.

Ha a megadott forrás egy Azure-fájlmegosztás, akkor meg kell adnia a pontos fájlnevet (például abc.txt) egyetlen fájl másolásához, vagy meg kell adnia az /S lehetőséget a megosztás összes fájljának rekurzív másolásához. A fájlminta és az /S lehetőség együttes megadása hibát eredményez.

Az AzCopy akkor használ kis- és nagybetűk megkülönböztetéses egyeztetést, ha a /Source egy blobtároló vagy blob virtuális könyvtár, és a kis- és nagybetűket nem megkülönböztető egyeztetést használ az összes többi esetben.

Az alapértelmezett fájlminta, amely akkor használatos, ha nincs megadva fájlminta, a fájlrendszer helye vagy egy Azure Storage-hely üres előtagja. Több fájlminta megadása nem támogatott.

A következőre vonatkozik: Blobok, fájlok

/DestKey:"storage-key"

Megadja a célerőforrás tárfiókkulcsát.

A következőre vonatkozik: Blobok, fájlok, táblák

/DestSAS:"sas-token"

Olyan közös hozzáférésű jogosultságkód (SAS) megadása, amely olvasási és írási engedéllyel rendelkezik a célhelyhez (ha van). Vegye körül az SAS-t idézőjelekkel, mivel speciális parancssori karaktereket tartalmazhat.

Ha a célerőforrás egy blobtároló, fájlmegosztás vagy tábla, megadhatja ezt a beállítást, amelyet az SAS-jogkivonat követ, vagy a cél blobtároló, fájlmegosztás vagy tábla URI-ja részeként is megadhatja az SAS-t ezen beállítás nélkül.

Ha a forrás és a cél is blob, akkor a célblobnak ugyanabban a tárfiókban kell lennie, mint a forrásblobnak.

A következőre vonatkozik: Blobok, fájlok, táblák

/SourceKey:"storage-key"

Megadja a forráserőforrás tárfiókkulcsát.

A következőre vonatkozik: Blobok, fájlok, táblák

/SourceSAS:"sas-token"

Olyan közös hozzáférésű jogosultságkódot ad meg, amely olvasási és LIST-engedélyekkel rendelkezik a forráshoz (ha van). Vegye körül az SAS-t idézőjelekkel, mivel speciális parancssori karaktereket tartalmazhat.

Ha a forráserőforrás egy blobtároló, és sem kulcs, sem SAS nincs megadva, akkor a blobtároló névtelen hozzáféréssel lesz beolvasva.

Ha a forrás fájlmegosztás vagy tábla, meg kell adni egy kulcsot vagy SAS-t.

A következőre vonatkozik: Blobok, fájlok, táblák

/S

Rekurzív módot ad meg a másolási műveletekhez. Rekurzív módban az AzCopy az összes olyan blobot vagy fájlt átmásolja, amely megfelel a megadott fájlmintának, beleértve az almappákban lévőket is.

A következőre vonatkozik: Blobok, fájlok

/BlobType:"block" | "page" | "append" (hozzáfűzés)

Meghatározza, hogy a célblob blokkblob, lapblob vagy hozzáfűző blob-e. Ez a beállítás csak akkor alkalmazható, ha blobot tölt fel. Ellenkező esetben hiba keletkezik. Ha a cél egy blob, és ez a beállítás nincs megadva, az AzCopy alapértelmezés szerint létrehoz egy blokkblobot.

A következőre vonatkozik: Festékfoltok

/CheckMD5

Kiszámít egy MD5-kivonatot a letöltött adatokhoz, és ellenőrzi, hogy a blobban vagy fájl Content-MD5 tulajdonságában tárolt MD5-kivonat megegyezik-e a számított kivonattal. Ha az értékek nem egyeznek, az AzCopy nem fogja letölteni az adatokat. Az MD5-ellenőrzés alapértelmezés szerint ki van kapcsolva, ezért meg kell adnia ezt a beállítást az MD5-ellenőrzés végrehajtásához az adatok letöltésekor.

Vegye figyelembe, hogy az Azure Storage nem garantálja, hogy a blobhoz vagy fájlhoz tárolt MD5-kivonat naprakész. Az ügyfél felelőssége, hogy a blob vagy fájl módosításakor frissítse az MD5-öt. Lemezképek (felügyelt vagy nem felügyelt lemezek) esetén az Azure-beli virtuális gépek nem frissítik az MD5 értéket a lemez tartalmának változásakor, ezért a /CheckMD5 hibát jelez a lemezképek letöltésekor.

Az AzCopy v8 mindig beállítja egy Azure-blob vagy -fájl Content-MD5 tulajdonságát, miután feltöltötte azt a szolgáltatásba.

A következőre vonatkozik: Blobok, fájlok

/Pillanatkép

Azt jelzi, hogy át szeretné-e vinni a pillanatképeket. Ez a beállítás csak akkor érvényes, ha a forrás egy blob.

Az átvitt blobpillanatképek a következő formátumban lesznek átnevezve: blob-név (pillanatkép-idő).extension

Alapértelmezés szerint a rendszer nem másolja a pillanatképeket.

A következőre vonatkozik: Festékfoltok

/V:[részletes-log-file]

Részletes állapotüzeneteket ad ki egy naplófájlba.

Alapértelmezés szerint a részletes naplófájl neve AzCopyVerbose.log in %LocalAppData%\Microsoft\Azure\AzCopy. Ha megad egy meglévő fájlhelyet ehhez a beállításhoz, a részletes napló hozzá lesz fűzve a fájlhoz.

A következőre vonatkozik: Blobok, fájlok, táblák

/Z:[journal-file-folder]

Naplófájlmappát ad meg a művelet folytatásához.

Az AzCopy mindig támogatja a folytatást, ha egy művelet megszakadt.

Ha ez a beállítás nincs megadva, vagy mappaelérési út nélkül van megadva, akkor az AzCopy létrehozza a naplófájlt az alapértelmezett helyen, amely a következő: %LocalAppData%\Microsoft\Azure\AzCopy.

Minden alkalommal, amikor parancsot ad ki az AzCopynak, ellenőrzi, hogy létezik-e naplófájl az alapértelmezett mappában, vagy hogy létezik-e az ebben a beállításban megadott mappában. Ha a naplófájl egyik helyen sem létezik, az AzCopy újként kezeli a műveletet, és létrehoz egy új naplófájlt.

Ha a naplófájl létezik, az AzCopy ellenőrzi, hogy a bevitt parancssor megegyezik-e a naplófájl parancssorával. Ha a két parancssor egyezik, az AzCopy folytatja a hiányos műveletet. Ha nem egyeznek meg, a rendszer kérni fogja, hogy írja felül a naplófájlt egy új művelet elindításához, vagy szakítsa meg az aktuális műveletet.

A naplófájl a művelet sikeres befejezésekor törlődik.

Vegye figyelembe, hogy az AzCopy egy korábbi verziója által létrehozott naplófájlból történő művelet folytatása nem támogatott.

A következőre vonatkozik: Blobok, fájlok, táblák

/@:"parameter-file"

Paramétereket tartalmazó fájlt ad meg. Az AzCopy ugyanúgy dolgozza fel a fájl paramétereit, mintha a parancssorban lettek volna megadva.

Egy válaszfájlban több paramétert is megadhat egyetlen sorban, vagy megadhatja az egyes paramétereket a saját sorában. Vegye figyelembe, hogy egy adott paraméter nem terjedhet ki több sorra.

A válaszfájlok tartalmazhatnak # szimbólummal kezdődő megjegyzéssorokat.

Több válaszfájlt is megadhat. Vegye figyelembe azonban, hogy az AzCopy nem támogatja a beágyazott válaszfájlokat.

A következőre vonatkozik: Blobok, fájlok, táblák

/Y

Letiltja az Összes AzCopy-megerősítési kérést. Ez a beállítás írásvédett SAS-jogkivonatok használatát is lehetővé teszi adatfeltöltési forgatókönyvekhez, ha a /XO és az /XN nincs megadva.

A következőre vonatkozik: Blobok, fájlok, táblák

/L

Csak lista műveletet határoz meg; nincs adatmásolás.

Az AzCopy ezt a beállítást szimulációként értelmezi a parancssor /L kapcsoló nélküli futtatásához, és megszámolja, hogy hány objektumot másol. A /V beállítást egyidejűleg megadhatja annak ellenőrzéséhez, hogy mely objektumok legyenek átmásolva a részletes naplóba.

Ennek a beállításnak a viselkedését a forrásadatok helye és a rekurzív mód /S és a fájlminta /Minta lehetőség jelenléte is meghatározza.

Az AzCopynak a forráshely LIST és READ engedélyére van szüksége ennek a beállításnak a használatakor.

A következőre vonatkozik: Blobok, fájlok

/MT

Beállítja, hogy a letöltött fájl utolsó módosítási időpontja megegyezik a forrásblobéval vagy -fájléval.

A következőre vonatkozik: Blobok, fájlok

/XN

Kizár egy újabb forráserőforrást. A program nem másolja az erőforrást, ha a forrás utolsó módosítási időpontja megegyezik vagy újabb, mint a cél.

A következőre vonatkozik: Blobok, fájlok

/XO

Kizár egy régebbi forráserőforrást. A program nem másolja az erőforrást, ha a forrás utolsó módosítási időpontja megegyezik vagy régebbi, mint a cél.

A következőre vonatkozik: Blobok, fájlok

/A

Csak az Archív attribútummal rendelkező fájlokat tölti fel.

A következőre vonatkozik: Blobok, fájlok

/IA:[RASHCNETOI]

Csak a megadott attribútumokkal rendelkező fájlokat tölti fel.

Az elérhető attribútumok a következők:

  • R = Írásvédett fájlok
  • A = Archiválásra kész fájlok
  • S = Rendszerfájlok
  • H = Rejtett fájlok
  • C = Tömörített fájlok
  • N = Normál fájlok
  • E = Titkosított fájlok
  • T = Ideiglenes fájlok
  • O = Offline fájlok
  • I = Nem indexelt fájlok

A következőre vonatkozik: Blobok, fájlok

/XA:[RASHCNETOI]

Kizárja azokat a fájlokat, amelyekhez a megadott attribútumok bármelyike be van állítva.

Az elérhető attribútumok a következők:

  • R = Írásvédett fájlok
  • A = Archiválásra kész fájlok
  • S = Rendszerfájlok
  • H = Rejtett fájlok
  • C = Tömörített fájlok
  • N = Normál fájlok
  • E = Titkosított fájlok
  • T = Ideiglenes fájlok
  • O = Offline fájlok
  • I = Nem indexelt fájlok

A következőre vonatkozik: Blobok, fájlok

/Elválasztó:"elválasztó"

A blobnévben lévő virtuális könyvtárak elválasztásához használt elválasztó karaktert jelzi.

Alapértelmezés szerint az AzCopy elválasztó karakterként / karaktert használ. Az AzCopy azonban bármilyen közös karaktert (például @, #vagy %) támogat elválasztóként. Ha a parancssorba be kell foglalnia a speciális karakterek egyikét, a fájlnevet idézőjelek közé kell foglalnia.

Ez a beállítás csak blobok letöltésére használható.

A következőre vonatkozik: Festékfoltok

/NC:"egyidejű műveletek száma"

Az egyidejű műveletek számát adja meg.

Az AzCopy alapértelmezés szerint bizonyos számú egyidejű műveletet indít el az adatátviteli sebesség növelése érdekében. Vegye figyelembe, hogy az alacsony sávszélességű környezetben nagyszámú egyidejű művelet túlterhelheti a hálózati kapcsolatot, és megakadályozhatja a műveletek teljes befejezését. Az egyidejű műveletek szabályozása a tényleges rendelkezésre álló hálózati sávszélesség alapján.

Az egyidejű műveletek felső korlátja 512.

A következőre vonatkozik: Blobok, fájlok, táblák

/SourceType:"Blob" | "Táblázat"

Megadja, hogy az source erőforrás egy, a helyi fejlesztési környezetben elérhető blob, amely a storage emulátorban fut.

A következőre vonatkozik: Blobok, táblák

/DestType:"Blob" | "Táblázat"

Megadja, hogy az destination erőforrás egy, a helyi fejlesztési környezetben elérhető blob, amely a storage emulátorban fut.

A következőre vonatkozik: Blobok, táblák

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

Felosztja a partíciókulcs-tartományt, hogy lehetővé tegye a táblaadatok párhuzamos exportálását, ami növeli az exportálási művelet sebességét.

Ha ez a beállítás nincs megadva, akkor az AzCopy egyetlen szálat használ a táblaentitások exportálásához. Ha például a felhasználó a /PKRS:"aa#bb" értéket adja meg, akkor az AzCopy három egyidejű műveletet indít el.

Mindegyik művelet a három partíciókulcs-tartomány egyikét exportálja, az alábbiak szerint:

[first-partition-key, aa)

[aa, bb)

[bb, last-partition-key]

A következőre vonatkozik: Táblázatok

/SplitSize:"fájlméret"

Az exportált fájl felosztási méretét adja meg MB-ban, a minimálisan megengedett érték 32.

Ha ez a beállítás nincs megadva, az AzCopy egyetlen fájlba exportálja a táblaadatokat.

Ha a táblaadatokat blobba exportálja, és az exportált fájlméret eléri a blobméretre vonatkozó 200 GB-os korlátot, akkor az AzCopy felosztja az exportált fájlt, még akkor is, ha ez a beállítás nincs megadva.

A következőre vonatkozik: Táblázatok

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

A táblaadatok importálási viselkedését határozza meg.

  • InsertOrSkip – Kihagy egy meglévő entitást, vagy új entitást szúr be, ha az nem létezik a táblában.
  • InsertOrMerge – Egy meglévő entitást egyesít, vagy új entitást szúr be, ha az nem létezik a táblában.
  • InsertOrReplace – Lecserél egy meglévő entitást, vagy új entitást szúr be, ha az nem létezik a táblában.

A következőre vonatkozik: Táblázatok

/Jegyzékfájl:"jegyzékfájl"

A tábla exportálási és importálási műveletének jegyzékfájlja.

Ez a beállítás nem kötelező az exportálási művelet során. Ha ez a beállítás nincs megadva, az AzCopy létrehoz egy előre definiált nevű jegyzékfájlt.

Ez a beállítás az adatfájlok kereséséhez szükséges az importálási művelet során.

A következőre vonatkozik: Táblázatok

/SyncCopy

Azt jelzi, hogy szinkron módon szeretne-e blobokat vagy fájlokat másolni két Azure Storage-végpont között.

Az AzCopy alapértelmezés szerint kiszolgálóoldali aszinkron másolatot használ. Ezzel a beállítással szinkron másolatot készíthet, amely letölti a blobokat vagy fájlokat a helyi memóriába, majd feltölti őket az Azure Storage-ba.

Ezt a lehetőséget akkor használhatja, ha a blobtárolóban, a Fájltárolóban vagy a Blob Storage-ból fájltárolóba másol fájlokat, vagy fordítva.

A következőre vonatkozik: Blobok, fájlok

/SetContentType:"content-type"

Meghatározza a célblobok vagy fájlok MIME-tartalomtípusát.

Az AzCopy alapértelmezés szerint alkalmazás-/oktet-streamre állítja be egy blob vagy fájl tartalomtípusát. Az összes blob vagy fájl tartalomtípusát úgy állíthatja be, hogy explicit módon megad egy értéket ehhez a beállításhoz.

Ha érték nélkül adja meg ezt a beállítást, akkor az AzCopy az egyes blobok vagy fájlok tartalomtípusát a fájlkiterjesztésének megfelelően állítja be.

A következőre vonatkozik: Blobok, fájlok

/PayloadFormat:"JSON" | "CSV"

A tábla exportált adatfájljának formátumát adja meg.

Ha ez a beállítás nincs megadva, az AzCopy alapértelmezés szerint JSON formátumban exportálja a táblaadatfájlt.

A következőre vonatkozik: Táblázatok

Ismert problémák és ajánlott eljárások

Vessünk egy pillantást néhány ismert problémára és ajánlott eljárásra.

Egyidejű írások korlátozása adatok másolása közben

Amikor blobokat vagy fájlokat másol az AzCopyval, vegye figyelembe, hogy másolás közben egy másik alkalmazás is módosíthatja az adatokat. Ha lehetséges, győződjön meg arról, hogy a másolt adatok nem módosulnak a másolási művelet során. Ha például egy Azure-beli virtuális géphez társított VHD-t másol, győződjön meg arról, hogy más alkalmazások jelenleg nem írnak a VHD-be. Ennek jó módja, ha lízingeli a másolandó erőforrást. Másik lehetőségként létrehozhat egy pillanatképet a VHD-ről, majd átmásolhatja a pillanatképet.

Ha nem tudja megakadályozni, hogy más alkalmazások blobokhoz vagy fájlokhoz írjanak a másolásuk során, akkor ne feledje, hogy a feladat befejeződése után előfordulhat, hogy a másolt erőforrások már nem rendelkeznek teljes mértékben a forráserőforrásokkal.

Engedélyezze a FIPS-kompatibilis MD5-algoritmusokat az AzCopyhoz a "FIPS-kompatibilis algoritmusok használata titkosításhoz, kivonatoláshoz és aláíráshoz".

Az AzCopy alapértelmezés szerint .NET MD5-implementációval számítja ki az MD5-öt az objektumok másolása során, de bizonyos biztonsági követelmények miatt az AzCopynak engedélyeznie kell a FIPS-kompatibilis MD5-beállítást.

Létrehozhat egy tulajdonsággal rendelkező AzureStorageUseV1MD5 app.config fájltAzCopy.exe.config, és félreteheti AzCopy.exe.

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

Az "AzureStorageUseV1MD5" tulajdonság esetében:

  • Igaz – Az AzCopy alapértelmezett értéke .NET MD5 implementációt használ.
  • Hamis – Az AzCopy FIPS-kompatibilis MD5-algoritmust használ.

A FIPS-kompatibilis algoritmusok alapértelmezés szerint le vannak tiltva Windows rendszeren. Ezt a házirend-beállítást módosíthatja a számítógépen. A Futtatás ablakban (Windows+R) írja be a secpol.msc parancsot a Helyi biztonsági házirend ablak megnyitásához. A Biztonsági beállítások ablakban lépjen a Biztonsági beállítások>helyi házirendek>biztonsági beállításai elemre. Keresse meg a rendszer titkosítását: FIPS-kompatibilis algoritmusok használata titkosítási, kivonatolási és aláírási szabályzatokhoz . Kattintson duplán a házirendre a Biztonsági beállítás oszlopban megjelenő érték megtekintéséhez.

Következő lépések

További, az Azure Storage szolgáltatással és az AzCopyval kapcsolatos adatokat a következő erőforrások nyújtanak:

Az Azure Storage dokumentációja:

Az Azure Storage blogbejegyzései: