Scaricare BLOB da Archiviazione BLOB di Azure usando AzCopy

È possibile scaricare BLOB e directory dall'archivio BLOB usando l'utilità della riga di comando AzCopy v10.

Per visualizzare esempi per altri tipi di attività, ad esempio il caricamento di file, la sincronizzazione con l'archiviazione BLOB o la copia di BLOB tra account, vedere i collegamenti presentati nella sezione Passaggi successivi di questo articolo.

Operazioni preliminari

Vedere l'articolo Introduzione ad AzCopy per scaricare AzCopy e scoprire informazioni sui modi in cui è possibile fornire le credenziali di autorizzazione al servizio di archiviazione.

Nota

Gli esempi in questo articolo presuppongono che siano state fornite le credenziali di autorizzazione usando l'ID Microsoft Entra.

Se si preferisce usare un token di firma di accesso condiviso per autorizzare l'accesso ai dati BLOB, è possibile aggiungere tale token all'URL della risorsa in ogni comando AzCopy. Ad esempio: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Scaricare un BLOB

Scaricare un BLOB usando il comando azcopy copy.

Suggerimento

In questo esempio vengono racchiusi gli argomenti path con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della shell dei comandi di Windows (cmd.exe). Se si usa una shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti di percorso con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' '<local-file-path>'

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'

Esempio (endpoint Data Lake Storage)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'

Nota

Se il valore della proprietà Content-md5 di un BLOB contiene un hash, AzCopy calcola un hash MD5 per i dati scaricati e verifica che l'hash MD5 archiviato nella proprietà Content-md5 del BLOB corrisponda all'hash calcolato. Se questi valori non corrispondono, il download non riesce a meno che non si esegua l'override di questo comportamento aggiungendo --check-md5=NoCheck o --check-md5=LogOnly al comando di copia.

Scaricare una directory

Scaricare una directory usando il comando azcopy copy.

Suggerimento

In questo esempio vengono racchiusi gli argomenti path con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della shell dei comandi di Windows (cmd.exe). Se si usa una shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti di percorso con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' '<local-directory-path>' --recursive

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory'  --recursive

Esempio (endpoint Data Lake Storage)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory'  --recursive

In questo esempio viene restituita una directory denominata C:\myDirectory\myBlobDirectory che contiene tutti i BLOB scaricati.

Scaricare il contenuto della directory

È possibile scaricare il contenuto di una directory senza copiare la directory che lo contiene usando il carattere jolly (*).

Suggerimento

In questo esempio vengono racchiusi gli argomenti path con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della shell dei comandi di Windows (cmd.exe). Se si usa una shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti di percorso con virgolette doppie ("") anziché virgolette singole ('').

Nota

Attualmente, questo scenario è supportato solo per gli account che non hanno uno spazio dei nomi gerarchico.

Sintassi

azcopy copy 'https://<storage-account-name>.blob.core.windows.net/<container-name>/*' '<local-directory-path>/'

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory/*' 'C:\myDirectory'

Aggiungere il flag --recursive per scaricare i file in tutte le sottodirectory.

Scaricare BLOB specifici

È possibile scaricare BLOB specifici usando nomi di file completi, nomi parziali con caratteri jolly (*) o usando date e ore.

Suggerimento

In questi esempi gli argomenti path vengono racchiusi con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della shell dei comandi di Windows (cmd.exe). Se si usa una shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti di percorso con virgolette doppie ("") anziché virgolette singole ('').

Specificare più nomi di BLOB completi

Usare il comando azcopy copy con l'opzione --include-path. Separare i singoli nomi di BLOB usando un punto e virgola (;).

Sintassi

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>

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt' --recursive

Esempio (endpoint Data Lake Storage)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt'--recursive

In questo esempio AzCopy trasferisce la directory https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos e il file https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/documents/myFile.txt. Includere l'opzione --recursive per trasferire tutti i BLOB nella directory https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos.

È anche possibile escludere i BLOB usando l'opzione --exclude-path. Per altre informazioni, vedere la documentazione di riferimento di azcopy copy.

Usare caratteri jolly

Usare il comando azcopy copy con l'opzione --include-pattern. Specificare nomi parziali che includono i caratteri jolly. Separare i nomi usando un punto e virgola (;).

Sintassi

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>

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*'

Esempio (spazio dei nomi gerarchico)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*'

È anche possibile escludere i BLOB usando l'opzione --exclude-pattern. Per altre informazioni, vedere la documentazione di riferimento di azcopy copy.

Le opzioni --include-pattern e --exclude-pattern si applicano solo ai nomi dei BLOB e non al percorso. Se si desidera copiare tutti i file di testo (BLOB) presenti in un albero di directory, usare l'opzione -recursive per ottenere l'intero albero di directory e quindi usare -include-pattern e specificare *.txt per ottenere tutti i file di testo.

Scaricare i BLOB modificati prima o dopo una data e un'ora

Usare il comando azcopy copy con l'opzione --include-before o --include-after. Specificare una data e un'ora in formato ISO-8601 (ad esempio: 2020-08-19T15:04:00Z).

Gli esempi seguenti scaricano i file modificati nella data specificata o in seguito.

Sintassi

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>

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/*' 'C:\myDirectory'  --include-after '2020-08-19T15:04:00Z'

Esempio (endpoint Data Lake Storage)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory/*' 'C:\myDirectory'  --include-after '2020-08-19T15:04:00Z'

Per informazioni dettagliate, vedere la documentazione di riferimento di azcopy copy.

Scaricare le versioni precedenti di un BLOB

Se è stato abilitato il controllo delle versioni BLOB, è possibile scaricare una o più versioni precedenti di un BLOB.

Creare prima di tutto un file di testo contenente un elenco di ID versione. Ogni ID versione deve essere visualizzato in una riga separata. Ad esempio:

2020-08-17T05:50:34.2199403Z
2020-08-17T05:50:34.5041365Z
2020-08-17T05:50:36.7607103Z

Quindi, usare il comando azcopy copy con l'opzione --list-of-versions. Specificare il percorso del file di testo che contiene l'elenco delle versioni , ad esempio D:\\list-of-versions.txt.

Scaricare uno snapshot del BLOB

È possibile scaricare uno snapshot del BLOB facendo riferimento al valore DateTime relativo.

Sintassi

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>?sharesnapshot=<DateTime-of-snapshot>' '<local-file-path>'

Esempio

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt?sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt'

Esempio (endpoint Data Lake Storage)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt?sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt'

Nota

Se si usa un token di firma di accesso condiviso per autorizzare l'accesso ai dati BLOB, aggiungere lo snapshot DateTime dopo il token di firma di accesso condiviso. Ad esempio: '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'.

Scaricare con flag facoltativi

È possibile modificare l'operazione di download usando flag facoltativi. Ecco alcuni esempi.

Scenario	Flag
Decomprimere automaticamente i file.	--decompress
Specificare quanto si desidera che le voci di log correlate alla copia siano dettagliate.	--log-level=[WARNING|ERROR|INFO|NONE]
Specificare se e come sovrascrivere i file e i BLOB in conflitto nella destinazione.	--overwrite=[true|false|ifSourceNewer|prompt]

Per un elenco completo, vedere le opzioni.

Passaggi successivi

Altri esempi sono disponibili in questi articoli:

• Esempi: Caricamento
• Esempi: Copiare tra account
• Esempi: Sincronizzare
• Esempi: Bucket di Amazon S3
• Esempi: Google Cloud Storage
• Esempi: File di Azure
• Esercitazione: Eseguire la migrazione di dati locali in una risorsa di archiviazione cloud tramite AzCopy

Vedere questi articoli per configurare le impostazioni, ottimizzare le prestazioni e risolvere i problemi:

• Impostazioni di configurazione di AzCopy
• Ottimizzare le prestazioni di AzCopy
• Trovare gli errori e riprendere i processi usando i file di log e di piano in AzCopy
• Risolvere i problemi relativi ad AzCopy v10