Blobok másolása Azure-tárfiókok között az AzCopy használatával
A blobokat, könyvtárakat és tárolókat az AzCopy v10 parancssori segédprogrammal másolhatja a tárfiókok között.
Más típusú feladatokra, például fájlok feltöltésére, blobok letöltésére és blobtárolóval való szinkronizálásra vonatkozó példákért tekintse meg a cikk Következő lépések szakaszában található hivatkozásokat.
Az AzCopy kiszolgálóról kiszolgálóra történő API-kat használ, így az adatok közvetlenül a tárolókiszolgálók között lesznek átmásolva.
Első lépések
Tekintse meg az AzCopy használatának első lépéseit ismertető cikket az AzCopy letöltéséhez, és ismerje meg, hogyan adhat meg hitelesítési hitelesítő adatokat a tárolási szolgáltatásnak.
Feljegyzés
A cikkben szereplő példák feltételezik, hogy a Microsoft Entra ID használatával adta meg az engedélyezési hitelesítő adatokat, és hogy a Microsoft Entra-identitása megfelelő szerepkör-hozzárendelésekkel rendelkezik a forrás- és célfiókokhoz is.
Azt is megteheti, hogy hozzáfűz egy SAS-jogkivonatot az egyes AzCopy-parancsok forrás- vagy cél URL-címéhez. Például: azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>'
Irányelvek
Alkalmazza az alábbi irányelveket az AzCopy-parancsokra.
Ha Microsoft Entra-hitelesítést használ a forráshoz és a célhoz is, akkor mindkét fióknak ugyanahhoz a Microsoft Entra-bérlőhöz kell tartoznia.
Az ügyfélnek hálózati hozzáféréssel kell rendelkeznie a forrás- és céltárfiókokhoz is. Az egyes tárfiókok hálózati beállításainak konfigurálásáról az Azure Storage-tűzfalak és virtuális hálózatok konfigurálása című témakörben olvashat.
Ha prémium szintű blokkblobtároló-fiókba másol, hagyja ki a blob hozzáférési szintjét a másolási műveletből a
s2s-preserve-access-tier
false
következő beállítással (például:--s2s-preserve-access-tier=false
). A prémium szintű blokkblobtárfiókok nem támogatják a hozzáférési szinteket.A környezeti változó értékének beállításával növelheti a másolási műveletek átviteli sebességét
AZCOPY_CONCURRENCY_VALUE
. További információ: Egyidejűség növelése.Ha a forrásblobok indexcímkéket tartalmaznak, és meg szeretné őrizni ezeket a címkéket, újra kell alkalmaznia őket a célblobokban. További információ az indexcímkék beállításáról: A blobok másolása egy másik tárfiókba a jelen cikk indexcímkéivel foglalkozó szakaszában.
Blob másolása
Másolja a blobot egy másik tárfiókba az azcopy copy paranccsal.
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows parancshéj (cmd.exe) kivételével minden parancshéjban használjon egyetlen idézőjelet. Ha Windows Command Shellt (cmd.exe) használ, az elérésiút-argumentumokat idézőjelek ("") helyett dupla idézőjelekkel ("") foglalja össze.
Szintaxis
azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>'
Példa
azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt'
Példa (Data Lake Storage-végpontok)
azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'
A másolási művelet szinkron módon megy végbe, ezért a parancs visszatérése azt jelzi, hogy a fájlok másolása megtörtént.
Könyvtár másolása
Másolja a könyvtárat egy másik tárfiókba az azcopy copy paranccsal.
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows parancshéj (cmd.exe) kivételével minden parancshéjban használjon egyetlen idézőjelet. Ha Windows Command Shellt (cmd.exe) használ, az elérésiút-argumentumokat idézőjelek ("") helyett dupla idézőjelekkel ("") foglalja össze.
Szintaxis
azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive
Példa
azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive
Példa (Data Lake Storage-végpontok)
azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive
A másolási művelet szinkron. A parancs visszatérésekor az összes fájl ki lett másolva.
Tároló másolása
Másolja a tárolót egy másik tárfiókba az azcopy copy paranccsal.
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows parancshéj (cmd.exe) kivételével minden parancshéjban használjon egyetlen idézőjelet. Ha Windows Command Shellt (cmd.exe) használ, az elérésiút-argumentumokat idézőjelek ("") helyett dupla idézőjelekkel ("") foglalja össze.
Szintaxis
azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive
Példa
azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive
Példa (Data Lake Storage-végpontok)
azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive
A másolási művelet szinkron. A parancs visszatérésekor az összes fájl ki lett másolva.
Tárolók, könyvtárak és blobok másolása
Másolja az összes tárolót, könyvtárat és blobot egy másik tárfiókba az azcopy copy paranccsal.
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows parancshéj (cmd.exe) kivételével minden parancshéjban használjon egyetlen idézőjelet. Ha Windows Command Shellt (cmd.exe) használ, az elérésiút-argumentumokat idézőjelek ("") helyett dupla idézőjelekkel ("") foglalja össze.
Szintaxis
azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/' --recursive
Példa
azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive
Példa (Data Lake Storage-végpontok)
azcopy copy 'https://mysourceaccount.dfs.core.windows.net/' 'https://mydestinationaccount.dfs.core.windows.net' --recursive
A másolási művelet szinkron módon megy végbe, ezért a parancs visszatérése azt jelzi, hogy a fájlok másolása megtörtént.
Blobok másolása és indexcímkék hozzáadása
Másolja a blobokat egy másik tárfiókba, és adja hozzá a blobindexcímkéket a célblobhoz.
Ha Microsoft Entra-hitelesítést használ, a biztonsági taghoz hozzá kell rendelni a Storage Blob Data Owner szerepkört, vagy engedélyt kell adni az Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write
Azure-erőforrás-szolgáltatói műveletre egy egyéni Azure-szerepkörön keresztül. Ha SAS-jogkivonatot használ, a jogkivonatnak hozzáférést kell biztosítania a blob címkéihez az t
SAS-engedélyen keresztül.
Címkék hozzáadásához használja a --blob-tags
lehetőséget egy URL-kódolt kulcs-érték párral együtt.
A kulcs my tag
és egy érték my tag value
hozzáadásához például hozzá kell adnia --blob-tags='my%20tag=my%20tag%20value'
a célparamétert.
Több indexcímke elkülönítése ampersand (&
) használatával. Ha például egy kulcsot my second tag
és egy értéket my second tag value
szeretne hozzáadni, a teljes beállítási sztring az lenne --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'
.
Az alábbi példák bemutatják a --blob-tags
beállítás használatát.
Tipp.
Ezek a példák az elérésiút-argumentumokat egyetlen idézőjelekkel ('') foglalja össze. A Windows parancshéj (cmd.exe) kivételével minden parancshéjban használjon egyetlen idézőjelet. Ha Windows Command Shellt (cmd.exe) használ, az elérésiút-argumentumokat idézőjelek ("") helyett dupla idézőjelekkel ("") foglalja össze.
Példa blobra
azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'
Példa könyvtárra
azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'
Példa tárolóra
azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'
Példa fiókra
azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'
A másolási művelet szinkron. A parancs visszatérésekor az összes fájl ki lett másolva.
Feljegyzés
Ha megad egy könyvtárat, tárolót vagy fiókot a forráshoz, a célhelyre másolt összes blob ugyanazokat a címkéket fogja tartalmazni, amelyeket a parancsban megadott.
Másolás választható jelzőkkel
A másolási műveletet tetszés szerinti jelölőkkel módosíthatja. Íme néhány példa.
Eset | Jelölő |
---|---|
Blobok másolása blokkként, lapként vagy hozzáfűző blobként. | --blob-type=[BlockBlob|PageBlob|AppendBlob] |
Másolás egy adott hozzáférési szintre (például az archív szintre). | --block-blob-tier=[Nincs|Gyakori|Menő|Archívum] |
Fájlok automatikus felbontása. | --decompress=[gzip|deflate] |
A teljes listát a beállítások között találja.
Következő lépések
További példákat az alábbi cikkekben talál:
- Példák: Feltöltés
- Példák: Letöltés
- Példák: Szinkronizálás
- Példák: Amazon S3-gyűjtők
- Példák: Google Cloud Storage
- Példák: Azure Files
- Oktatóanyag: Helyszíni adatok migrálása felhőbeli tárolóba az AzCopy használatával
A beállítások konfigurálásához, a teljesítmény optimalizálásához és a problémák elhárításához tekintse meg ezeket a cikkeket:
- AzCopy konfigurációs beállításai
- Az AzCopy teljesítményének optimalizálása
- Hibák keresése és feladatok folytatása napló- és csomagfájlok használatával az AzCopyban
- Az AzCopy 10-zel kapcsolatos problémák elhárítása
- Blobok másolása az Azure Storage-fiókok között az AzCopy használatával hálózati korlátozásokkal