Blobok letöltése az Azure Blob Storage-ból az AzCopy használatával
A blobokat és könyvtárakat az AzCopy v10 parancssori segédprogrammal töltheti le a Blob Storage-ból.
Más típusú feladatokra, például fájlok feltöltésére, blobtárolóval való szinkronizálásra vagy blobok fiókok közötti másolására vonatkozó példákért tekintse meg a cikk Következő lépések szakaszában található hivatkozásokat.
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.
Megjegyzé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.
Ha inkább SAS-jogkivonatot használ a blobadatokhoz való hozzáférés engedélyezéséhez, akkor ezt a jogkivonatot az egyes AzCopy-parancsok erőforrás-URL-címéhez fűzheti. For example: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.
Blob letöltése
Töltse le a blobot az azcopy copy paranccsal.
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows command Shell (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://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' '<local-file-path>'
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'
Példa (Data Lake Storage-végpont)
azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'
Megjegyzés:
Ha egy Content-md5 blob tulajdonságértéke kivonatot tartalmaz, az AzCopy kiszámít egy MD5 kivonatot a letöltött adatokhoz, és ellenőrzi, hogy a blob Content-md5 tulajdonságában tárolt MD5 kivonat megegyezik-e a számított kivonatéval. Ha ezek az értékek nem egyeznek, a letöltés sikertelen lesz, hacsak nem bírálja felül ezt a viselkedést a hozzáfűzési --check-md5=NoCheck vagy --check-md5=LogOnly másolási paranccsal.
Könyvtár letöltése
Töltse le a könyvtárat az azcopy copy paranccsal.
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows command Shell (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://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' '<local-directory-path>' --recursive
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory' --recursive
Példa (Data Lake Storage-végpont)
azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory' --recursive
Ez a példa egy olyan könyvtárat C:\myDirectory\myBlobDirectory eredményez, amely az összes letöltött blobot tartalmazza.
Könyvtár tartalmának letöltése
You can download the contents of a directory without copying the containing directory itself by using the wildcard symbol (*).
Tipp.
Ez a példa az elérési utak argumentumait egyetlen idézőjelekkel ('') foglalja össze. A Windows command Shell (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.
Megjegyzés:
Ez a forgatókönyv jelenleg csak hierarchikus névtérrel nem rendelkező fiókok esetében támogatott.
Szintaxis
azcopy copy 'https://<storage-account-name>.blob.core.windows.net/<container-name>/*' '<local-directory-path>/'
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory/*' 'C:\myDirectory'
Fűzze hozzá a jelölőt --recursive az összes alkönyvtár fájljainak letöltéséhez.
Adott blobok letöltése
Adott blobokat teljes fájlnevek, helyettesítő karaktereket (*) tartalmazó részleges nevek, illetve dátumok és időpontok használatával tölthet le.
Tipp.
Ezek a példák az elérésiút-argumentumokat egyetlen idézőjelekkel ('') foglalja össze. A Windows command Shell (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.
Több teljes blobnév megadása
Használja az azcopy copy parancsot a --include-path beállítással. Az egyes blobneveket pontosvesszővel (pontosvesszővel); különítse el.
Szintaxis
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' '<local-directory-path>' --include-path <semicolon-separated-file-list>
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory' --include-path 'photos;documents\myFile.txt' --recursive
Példa (Data Lake Storage-végpont)
azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory' --include-path 'photos;documents\myFile.txt'--recursive
Ebben a példában az AzCopy átviszi a https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos könyvtárat és a https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/documents/myFile.txt fájlt. Adja meg a --recursive címtárban lévő összes blob átvitelének https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos lehetőségét.
A lehetőséggel kizárhatja a --exclude-path blobokat is. További információ: azcopy copy reference docs.
Helyettesítő karakterek használata
Használja az azcopy copy parancsot a --include-pattern beállítással. Adja meg a helyettesítő karaktereket tartalmazó részleges neveket. Különítse el a neveket szemikolin (;) használatával.
Szintaxis
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' '<local-directory-path>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory' --include-pattern 'myFile*.txt;*.pdf*'
Példa (hierarchikus névtér)
azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory' --include-pattern 'myFile*.txt;*.pdf*'
A lehetőséggel kizárhatja a --exclude-pattern blobokat is. További információ: azcopy copy reference docs.
A --include-pattern beállítások csak --exclude-pattern a blobnevekre vonatkoznak, az elérési útra nem. Ha a könyvtárfában található összes szövegfájlt (blobot) át szeretné másolni, akkor a -recursive beállítással lekérheti a teljes könyvtárfát, majd a -include-pattern beállítással *.txt lekérheti az összes szövegfájlt.
Dátum és idő előtt vagy után módosított blobok letöltése
Használja az azcopy copy parancsot a vagy --include-after a --include-before beállítással. Adjon meg egy dátumot és időt ISO-8601 formátumban (például: 2020-08-19T15:04:00Z).
Az alábbi példák a megadott dátumon vagy után módosított fájlokat töltik le.
Szintaxis
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>/*' '<local-directory-path>' --include-after <Date-Time-in-ISO-8601-format>
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/*' 'C:\myDirectory' --include-after '2020-08-19T15:04:00Z'
Példa (Data Lake Storage-végpont)
azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory/*' 'C:\myDirectory' --include-after '2020-08-19T15:04:00Z'
Részletes referencia: az azcopy copy reference docs.
Blob korábbi verzióinak letöltése
Ha engedélyezte a blobok verziószámozását, letöltheti a blob egy vagy több korábbi verzióját.
Először hozzon létre egy szöveges fájlt, amely tartalmazza a verzióazonosítók listáját. Minden verzióazonosítónak külön sorban kell megjelennie. Például:
2020-08-17T05:50:34.2199403Z
2020-08-17T05:50:34.5041365Z
2020-08-17T05:50:36.7607103Z
Ezután használja az azcopy copy parancsot a --list-of-versions beállítással. Adja meg a verziólistát tartalmazó szövegfájl helyét (például: D:\\list-of-versions.txt).
Blob-pillanatkép letöltése
A blob pillanatképét a Blob-pillanatkép DateTime értékére való hivatkozással töltheti le.
Szintaxis
azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>?sharesnapshot=<DateTime-of-snapshot>' '<local-file-path>'
Példa
azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt?sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt'
Példa (Data Lake Storage-végpont)
azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt?sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt'
Megjegyzés:
Ha SAS-jogkivonatot használ a blobadatokhoz való hozzáférés engedélyezéséhez, akkor az SAS-jogkivonat után fűzze hozzá a pillanatkép DateTime-ját . For example: 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z'.
Letöltés választható jelzőkkel
A letöltési műveletet tetszés szerinti jelzőkkel módosíthatja. Íme néhány példa.
| Eset | Jelölő |
|---|---|
| Fájlok automatikus felbontása. | --Kibontására |
| Adja meg, hogy a másolással kapcsolatos naplóbejegyzések milyen részletesek legyenek. | --log-level=[FIGYELMEZTETÉS|HIBA|INFO|NINCS] |
| Adja meg, hogy felülírja-e és hogyan írja felül az ütköző fájlokat és blobokat a célhelyen. | --overwrite=[true|false|ifSourceNewer|prompt] |
A teljes listát a beállítások között találja.
További lépések
További példákat az alábbi cikkekben talál:
- Példák: Feltöltés
- Példák: Másolás a fiók között
- 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: