Blobok letöltése az Azure Blob Storage-ból az AzCopy használatával

  • Cikk

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:

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: