Adatok áthelyezése az AzCopy 8.1-es verziójával Windows rendszeren
Az AzCopy egy parancssori segédprogram, amely az adatok egyszerű parancsokkal a Microsoft Azure Blob, File és Table Storage szolgáltatásba vagy onnan máshová való optimális teljesítményű másolására lett kifejlesztve. 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 úgy dönt, hogy telepíti az AzCopy régebbi verzióját (AzCopy v8.1), akkor több verzió is letölthető. Az AzCopy 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 az AzCopyt ismerteti Windows rendszeren.
AzCopy (v8.1) letöltése és telepítése Windows rendszeren
Töltse le az AzCopyt (v8.1) Windows rendszeren.
AzCopy Windows 8.1 rendszeren kibocsátási megjegyzések
- 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-tel 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-as 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 a számítógépen az AzCopy telepítési könyvtárát – ahol a AzCopy.exe
végrehajtható fájl található. Ha szükséges, hozzáadhatja az AzCopy telepítési helyét a rendszerútvonalhoz. Az AzCopy alapértelmezés szerint a következőre %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy
van telepítve: vagy %ProgramFiles%\Microsoft SDKs\Azure\AzCopy
.
Az első AzCopy-parancs írása
Az AzCopy-parancsok alapszintaxisa a következő:
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 Parameters szakaszt.
Blobok letöltése a Blob Storage-ból
Nézzük meg, hogyan tölthet le blobokat az AzCopy használatával.
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élyezni kell az olvasási hozzáférésű georedundáns tárolást.
Az összes blob letöltése egy tárolóban
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
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT
Azt is megteheti, hogy kizárja a blobokat a letöltési műveletből az utolsó módosítás időpontja alapján. Ha például ki szeretné zárni azokat a blobokat, amelyek legutóbbi módosítási ideje megegyezik vagy újabb a célfájlná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 ideje megegyezik vagy régebbi a célfájlénál, adja meg 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
Nézzük meg, hogyan tölthet fel blobokat az AzCopy használatával.
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 a virtuális könyvtárat a nevében szerepeltesse (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
/S
A beállítás megadása rekurzív módon feltölti 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:\myfolder
talá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:\myfolder
talá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
Az AzCopy alapértelmezés szerint a célblob tartalomtípusát állítja be a következőre application/octet-stream
: . 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
Nézzük 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ókon belül másol egy blobot, a rendszer kiszolgálóoldali másolási műveletet hajt végre.
Egyetlen blob másolása egyik tárfiókból a 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
Ha 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élyezni kell az írásvédett georedundáns tárolást.
Egyetlen blob és pillanatképeinek másolása egyik tárfiókból a 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ő blobokat é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 az összes blob feltöltését egy mappában .
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 sebességét illetően, é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.
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, 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ő költséget eredményezhet, az ajánlott módszer az, hogy ezt a lehetőséget egy olyan Azure-beli virtuális gépen használja, amely ugyanabban a régióban található, mint a forrás tárfiókja a kimenő forgalom költségeinek elkerülése érdekében.
Fájlok letöltése a Fájltárolóból
Nézzük meg, hogyan tölthet le fájlokat az AzCopy használatával.
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 vagy meg kell adnia a pontos fájlnevet (például abc.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.
A címtá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
Nézzük meg, hogyan tölthet fel fájlokat az AzCopy használatával.
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
Nézzük meg, hogyan másolhat fájlokat egy Azure-fájlmegosztásban az AzCopy használatával.
Másolás egyik fájlmegosztásból a 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ásokra, 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 Fájltárolóba, a Fájltárolóból a Blob Storage-ba, a Blob Storage-ból pedig a Fájltárolóba szinkron módon másoljon adatokat. Az AzCopy ezt úgy teszi, hogy letölti a forrásadatokat a helyi memóriába, és újra feltölti a célhelyre. A normál kimenő költségek érvényesek.
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él blobtípus módosításának lehetőségét /BlobType:page
.
Vegye figyelembe, hogy az /SyncCopy
aszinkron másolathoz képest további kimenő költségekkel járhat. A kimenő költségek 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 Table Storage-ból
Tekintsük át az Adatok exportálását 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ájl az importálási folyamat során a szükséges adatfájlok megkeresésére és az adatérvényesítés végrehajtására szolgál. 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 egy kötetindexet használ a felosztott adatfájlnevekben több fájl megkülönböztetésére. A kötetindex két részből, egy partíciókulcstartomány-indexből és egy felosztott fájlindexből áll. Mindkét index nulla alapú.
A partíciókulcs tartományindexe 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 lehetőséget /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, amint mérete eléri 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
Az AzCopy alapértelmezés szerint 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 megadásakor az AzCopy létrehoz egy sémafájlt is, amely minden adatfájlhoz fájlkiterjesztéssel .schema.csv
rendelkezik.
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 /NC
is 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 – partíciókulcs-tartományokat és implicit vagy explicit módon megadott egyidejű műveleteket – használja az egyidejű műveletek számának meghatározásához. 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 JSON-adatfájlt hoz létre 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. Erről a hasznos adatformátumról további információt a Table Service-műveletek hasznos adatformátuma című témakörben talál.
Vegye figyelembe, hogy a táblák blobokra való exportálásakor 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 az alapértelmezett "%LocalAppData%\Microsoft\Azure\AzCopy
" elérési úttal 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 mappa 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 lemez ideiglenes adatfájlja azonnal törlődik, miután feltöltötte a blobba, 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
Tekintsük át az Adatok importálását az Azure Table Storage-ba 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. A lehetséges értékek a következők:
InsertOrSkip
: Kihagy egy meglévő entitást, vagy új entitást szúr be, ha az nem szerepel a táblában.InsertOrMerge
: Egyesít egy meglévő entitást, vagy beszúr egy új entitást, ha az nem szerepel a táblában.InsertOrReplace
: Lecserél egy meglévő entitást, vagy új entitást szúr be, ha az nem szerepel a táblában.
Vegye figyelembe, hogy az importálási forgatókönyvben nem adható meg beállítás /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 az alapprocesszorok számával; a beállítással /NC
azonban eltérő számú egyidejű beállítást is megadhat. 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-fájlokból és jegyzékfájlokból származó táblaimportálást. Mindkét fájlnak AzCopy-táblaexportálásbó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 a 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 képviselő 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 az adott 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 lehetővé /XN
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ájlban bármilyen AzCopy parancssori paraméter szerepelhet. 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
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, ahogy a /sourcekey
paraméternél látható:
http://myaccount.blob.core.windows.net/mycontainer
C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y
Parancssori paraméterek megadása több válaszfájl használatával
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, dest.txt
amely egy célmappát határoz meg a fájlrendszerben:
/Dest:C:\myfolder
És egy válaszfájl neve options.txt
, amely megadja az AzCopy beállításait:
/S /Y
Az AzCopy meghívásához használja az alábbi parancsot azokkal a válaszfájlokkal, amelyek mindegyike egy könyvtárban C:\responsefiles
talá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 paramétert a parancssorba foglalná:
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 mappa
Minden alkalommal, amikor parancsot ad ki az AzCopynak, ellenőrzi, hogy egy naplófájl létezik-e az alapértelmezett mappában, vagy az ebben a beállításban megadott mappában van-e. 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 beírt parancssor megfelel-e a naplófájl parancssorának. 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
, az AzCopy a naplófájlt az alapértelmezett helyen hozza létre, vagyis %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy
az . 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 akkor hozza létre 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 úgy adja meg a beállítást /V
, hogy nem adja meg a részletes napló elérési útját, 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 /V
ad meg , például /V:test/azcopy1.log
, akkor a részletes napló az aktuális munkakönyvtárban jön létre egy nevű test
almappában.
Az egyidejűleg indí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 a processzorok számának 8-szorosa. Ha alacsony sávszélességű hálózaton futtatja az AzCopyt, a /NC-hez alacsonyabb számot adhat meg az erőforrás-verseny okozta hibák elkerülése érdekében.
Az AzCopy futtatása az Azure Storage Emulatoron
Az AzCopyt az Azure Storage Emulatoron futtathatja blobokhoz:
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 blob tartalomtípusát határozza meg egy olyan JSON-fájl alapján, amely a tartalomtípust fájlkiterjesztés-leképezésre tárolja. 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 következő parancsok egyikét is beírhatja a parancssorból:
- 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"
Megadja azokat 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árfájlmegosztás, tárfájlkönyvtár vagy Azure-tábla.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/Dest:"cél"
Megadja a célhelyet, amelybe másolni szeretne. A cél lehet fájlrendszerkönyvtár, blobtároló, blob virtuális könyvtár, tárfájlmegosztás, tárfájlkönyvtár vagy Azure-tábla.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/Pattern:"file-pattern"
Megadja a másolandó fájlokat jelző fájlmintát. A /Pattern paraméter viselkedését a forrásadatok helye és a rekurzív mód jelenléte 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 standard helyettesítő karakterek érvényben vannak, é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 blobtároló vagy virtuális könyvtár, akkor a program nem alkalmaz helyettesítő karaktereket. Ha az /S lehetőség van megadva, akkor az AzCopy blobelőtagként értelmezi a megadott fájlmintát. Ha a /S lehetőség nincs megadva, akkor az AzCopy pontosan a blobnevekre egyezik a fájlmintával.
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 kis- és nagybetűk közötti egyeztetést használ, ha a /Source egy blobtároló vagy blob virtuális könyvtár, és a kis- és nagybetűk közötti egyeztetést használja az összes többi esetben.
Az alapértelmezett fájlminta, amelyet akkor használnak, 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 alkalmazható: Blobok, Fájlok
/DestKey:"storage-key"
Megadja a célerőforrás tárfiókkulcsát.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/DestSAS:"sas-token"
A célhoz (ha van) olvasási és írási engedélyekkel rendelkező közös hozzáférésű jogosultságkód (SAS) megadása. Vegye körül az SAS-t dupla 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 részeként megadhatja az SAS-t a beállítás nélkül.
Ha a forrás és a cél mindkét blob, akkor a célblobnak ugyanabban a tárfiókban kell lennie, mint a forrásblob.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/SourceKey:"storage-key"
Megadja a forráserőforrás tárfiókkulcsát.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/SourceSAS:"sas-token"
A forráshoz (ha van) olvasási és LIST-engedélyekkel rendelkező közös hozzáférésű jogosultságkódot ad meg. Vegye körül az SAS-t dupla idézőjelekkel, mivel speciális parancssori karaktereket tartalmazhat.
Ha a forráserőforrás 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, egy kulcsot vagy SAS-t kell megadni.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/S
A másolási műveletek rekurzív módját adja meg. 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 alkalmazható: Blobok, Fájlok
/BlobType:"block" | "page" | "hozzáfűzés"
Megadja, hogy a célblob blokkblob, lapblob vagy hozzáfűző blob-e. Ez a beállítás csak blob feltöltésekor alkalmazható. Ellenkező esetben hiba jön létre. 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: Blobok
/CheckMD5
Kiszámít egy MD5 kivonatot a letöltött adatokhoz, és ellenőrzi, hogy a blob vagy fájl Content-MD5 tulajdonságában tárolt MD5 kivonat megegyezik-e a számított kivonatmal. 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 az MD5 frissítése a blob vagy fájl módosításakor. 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 alkalmazható: Blobok, Fájlok
/Pillanatfelvétel
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 blob-pillanatképek a következő formátumban lesznek átnevezve: blobnév (pillanatkép-idő).extension
Alapértelmezés szerint a rendszer nem másolja a pillanatképeket.
A következőre vonatkozik: Blobok
/V:[részletes-naplófájl]
Részletes állapotüzeneteket ad ki egy naplófájlba.
Alapértelmezés szerint a részletes naplófájl neve AzCopyVerbose.log a fájlban %LocalAppData%\Microsoft\Azure\AzCopy
. Ha egy meglévő fájlhelyet ad meg ehhez a beállításhoz, a részletes napló hozzá lesz fűzve ehhez a fájlhoz.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/Z:[journal-file-folder]
Egy 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 mappa elérési útja 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 egy naplófájl létezik-e az alapértelmezett mappában, vagy az ebben a beállításban megadott mappában van-e. 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 beírt parancssor megfelel-e a naplófájl parancssorának. 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ése után 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 alkalmazható: 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 megadhat több paramétert 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 alkalmazható: Blobok, Fájlok, Táblák
/Y
Letiltja az Összes AzCopy-megerősítési kérést. Ezzel a beállítással írásvédett SAS-jogkivonatokat is használhat adatfeltöltési forgatókönyvekhez, ha a /XO és az /XN nincs megadva.
A következőre alkalmazható: Blobok, Fájlok, Táblák
/L
Csak lista műveletet ad meg; nincs adatmásolás.
Az AzCopy ezt a beállítást szimulációként értelmezi a parancssor /L lehetőség nélküli futtatásához, és megszámolja, hogy hány objektumot másol. A /V lehetőséget egyszerre megadva ellenőrizheti, hogy mely objektumokat másolja 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 AzCopy ennek a forráshelynek a LIST és a READ engedélyét igényli a beállítás használatakor.
A következőre alkalmazható: Blobok, Fájlok
/MT
Beállítja, hogy a letöltött fájl utolsó módosítási ideje megegyezik a forrásblob vagy fájléval.
A következőre alkalmazható: 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 ideje megegyezik vagy újabb a célnál.
A következőre alkalmazható: 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 ideje megegyezik vagy régebbi a célnál.
A következőre alkalmazható: Blobok, Fájlok
/Egy
Csak az Archív attribútumkészlettel rendelkező fájlokat tölti fel.
A következőre alkalmazható: 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 alkalmazható: Blobok, Fájlok
/XA:[RASHCNETOI]
Kizárja a megadott attribútumokkal rendelkező fájlokat.
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 alkalmazható: 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 jelöli.
Alapértelmezés szerint az AzCopy elválasztó karakterként / karaktert használ. Az AzCopy azonban bármilyen gyakori karaktert (például @, #vagy %) támogat elválasztóként. Ha ezen speciális karakterek egyikét is fel kell vennie a parancssorba, a fájlnevet idézőjelek közé kell foglalnia.
Ez a beállítás csak a blobok letöltésére használható.
A következőre vonatkozik: Blobok
/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 átviteli sebesség növelése érdekében. Vegye figyelembe, hogy nagy számú egyidejű művelet kis sávszélességű környezetben 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 alkalmazható: 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 alkalmazható: 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 alkalmazható: 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ál használatával exportálja a táblaentitásokat. Ha például a felhasználó a /PKRS:"aa#bb" értéket adja meg, az AzCopy három egyidejű műveletet indít el.
Minden művelet exportálja a három partíciókulcs-tartomány egyikét az alábbiak szerint:
[first-partition-key, aa)
[aa, bb)
[bb, last-partition-key]
A következőre alkalmazható: Táblák
/SplitSize:"fájlméret"
Az exportált fájl felosztási méretét adja meg MB-ban, az engedélyezett minimális é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éret 200 GB-os korlátját, 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 alkalmazható: Táblák
/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 szerepel a táblában.
- InsertOrMerge – Egyesít egy meglévő entitást, vagy új entitást szúr be, ha az nem szerepel a táblában.
- InsertOrReplace – Lecserél egy meglévő entitást, vagy új entitást szúr be, ha az nem szerepel a táblában.
A következőre alkalmazható: Táblák
/Jegyzék:"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, az AzCopy előre definiált névvel rendelkező jegyzékfájlt hoz létre, ha ez a beállítás nincs megadva.
Erre a beállításra az adatfájlok importálási művelete során van szükség.
A következőre alkalmazható: Táblák
/SyncCopy
Azt jelzi, hogy a blobokat vagy fájlokat szinkronizálja-e két Azure Storage-végpont között.
Az AzCopy alapértelmezés szerint kiszolgálóoldali aszinkron másolatot használ. Adja meg ezt a lehetőséget egy szinkron másolás végrehajtásához, 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 fájlokat másol a Blob Storage-ba, a Fájltárolóba vagy a Blob Storage-ból a Fájltárolóba, vagy fordítva.
A következőre alkalmazható: Blobok, Fájlok
/SetContentType:"content-type"
A célblobok vagy fájlok MIME-tartalomtípusát adja meg.
Az AzCopy alapértelmezés szerint alkalmazásra/oktet-streamre állítja 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, 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 alkalmazható: Blobok, Fájlok
/PayloadFormat:"JSON" | "CSV"
Az exportált tábla 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 alkalmazható: Táblák
Ismert problémák és ajánlott eljárások
Vessünk egy pillantást az ismert problémákra és ajánlott eljárásokra.
Egyidejű írások korlátozása adatok másolása közben
Amikor blobokat vagy fájlokat másol az AzCopy használatával, vegye figyelembe, hogy egy másik alkalmazás is módosíthatja az adatokat másolás közben. 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 a másolandó erőforrás bérbeadása. 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 vegye figyelembe, hogy a feladat befejezéséig a másolt erőforrások nem feltétlenül rendelkeznek teljes mértékben a forráserőforrásokkal.
Engedélyezze a FIPS-kompatibilis MD5-algoritmusokat az AzCopyhoz, ha "FIPS-kompatibilis algoritmusokat használ 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ásakor, de vannak olyan biztonsági követelmények, amelyek miatt az AzCopynak engedélyeznie kell a FIPS-kompatibilis MD5-beállítást.
Létrehozhat egy app.config fájlt AzCopy.exe.config
tulajdonsággal AzureStorageUseV1MD5
, é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 keresse meg a Biztonsági beállítások>helyi házirendek>biztonsági beállításai lehetőséget. 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ített é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:
- A Microsoft Azure Storage bemutatása
- A Blob Storage használata a .NET-ből
- Fájltároló használata a .NET-ből
- A Table Storage használata a .NET-ből
- Tárfiók létrehozása, kezelése vagy törlése
- Adatok áthelyezése az AzCopyval Linux rendszeren
Azure Storage-blogbejegyzések:
- Az Azure Storage adatáthelyezési kódtár előzetes verziójának bemutatása
- AzCopy: A szinkron másolás és a testre szabott tartalomtípus bemutatása
- AzCopy: Az AzCopy 3.0 általános elérhetőségének bejelentése, valamint az AzCopy 4.0 előzetes kiadása tábla- és fájltámogatással
- AzCopy: Nagy léptékű másolási forgatókönyvekhez optimalizálva
- AzCopy: Az olvasási hozzáférésű georedundáns tárolás támogatása
- AzCopy: Adatok átvitele újraindítható móddal és SAS-jogkivonattal
- AzCopy: Fiókközi másolási blob használata
- AzCopy: Fájlok feltöltése/letöltése azure-blobokhoz