Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Az AzCopy v10 parancssori segédprogrammal blobokat, könyvtárakat és tárolókat másolhat 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 a Blob Storage-tárterülettel való szinkronizálásra vonatkozó példákért tekintse meg a cikk Következő lépések szakaszának hivatkozásait .
Az AzCopy kiszolgálóról kiszolgálóratö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 adja 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.
Másik lehetőségként hozzáfűzhet 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 a Microsoft Entra-hitelesítést a forráshoz és a célhoz is használja, 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.
A fiókok közötti másolás során támogatott hálózati topológiákról a blobok másolása hozzáférés-korlátozással rendelkező tárfiókok között 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-tierfalsekö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. Amikor a parancs visszatér, az azt jelzi, hogy az összes fájl másolása történik.
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. Amikor a parancs visszatér, a program az összes fájlt átmásolja.
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. Amikor a parancs visszatér, a program az összes fájlt átmásolja.
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. Amikor a parancs visszatér, az azt jelzi, hogy az összes fájl másolása történik.
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-engedélyezést használ, rendelje hozzá a Storage Blob Data Owner szerepkört a biztonsági taghoz, vagy adjon engedélyt az Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure-erőforrás-szolgáltatói műveletnek 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.
A kulcs my tag és az érték my tag valuehozzáadásához például adja hozzá --blob-tags='my%20tag=my%20tag%20value' a célparamétert.
Több indexcímkét különítse el egy ampersand (&) jellel. Ha például hozzá szeretné adni a kulcsot my second tag és az értéket my second tag value, 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. Amikor a parancs visszatér, a program az összes fájlt átmásolja.
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 tartalmazza, 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.
Forrás- és céltípusok megadása
Az AzCopy a --from-to paraméter használatával explicit módon határozza meg a forrás- és célerőforrás-típusokat, ha az automatikus észlelés meghiúsulhat, például a csővezeték-forgatókönyvekben vagy az emulátorokban. Ez a paraméter segít az AzCopynak megérteni az átvitel kontextusát, és ennek megfelelően optimalizálni.
| FromTo érték | Description |
|---|---|
BlobBlob |
Másolás két Azure Blob Storage-hely között |
BlobBlobFS |
Másolás az Azure Blob Storage-ból az Azure Data Lake Gen2-be (BlobFS) |
BlobFSBlob |
Másolás az Azure Data Lake Gen2-ből (BlobFS) az Azure Blob Storage-ba |
BlobFSBlobFS |
Másolás két Azure Data Lake Gen2 (BlobFS) hely között |
BlobFSFile |
Másolás az Azure Data Lake Gen2-ből (BlobFS) az Azure File Storage-ba |
BlobFile |
Másolás az Azure Blob Storage-ból az Azure File Storage-ba |
FileBlob |
Másolás az Azure File Storage-ból az Azure Blob Storage-ba |
FileBlobFS |
Másolás az Azure File Storage-ból az Azure Data Lake Gen2-be (BlobFS) |
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
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