Eseguire la sincronizzazione con l'archivio BLOB di Azure mediante AzCopy

  • Articolo

È possibile sincronizzare l'archiviazione locale con l'archiviazione BLOB di Azure usando l'utilità della riga di comando AzCopy v10.

È possibile sincronizzare il contenuto di un file system locale con un contenitore BLOB. È anche possibile sincronizzare contenitori e directory virtuali tra loro. La sincronizzazione è un modo. In altre parole, si sceglie quale di questi due endpoint è l'origine e quale è la destinazione. La sincronizzazione usa anche le API server per server. Gli esempi presentati in questa sezione funzionano anche con gli account con uno spazio dei nomi gerarchico.

Nota

La versione corrente di AzCopy non viene sincronizzata tra altre origini e destinazioni (ad esempio: archiviazione file o bucket amazon Web Services (AWS) S3).

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

Introduzione

Vedere l'articolo Introduzione ad AzCopy per scaricare AzCopy e 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>'.

Linee guida

Per impostazione predefinita, il comando di sincronizzazione confronta i nomi dei file e i timestamp dell'ultima modifica. È possibile eseguire l'override di tale comportamento per usare hash MD5 anziché i timestamp dell'ultima modifica usando il --compare-hash flag . Impostare il --delete-destination flag facoltativo su un valore di o prompt per eliminare i file nella directory di true destinazione se tali file non esistono più nella directory di origine.

  • Se si imposta il --delete-destination flag su true, AzCopy elimina i file senza fornire un prompt. Se si vuole che venga visualizzata una richiesta prima che AzCopy elimini un file, impostare il --delete-destination flag su prompt.

  • Se si prevede di impostare il --delete-destination flag su prompt o false, è consigliabile usare il comando di copia anziché il comando di sincronizzazione e impostare il --overwrite parametro su ifSourceNewer. Il comando di copia utilizza meno memoria e comporta costi di fatturazione inferiori perché non è necessario indicizzare l'origine o la destinazione prima dello spostamento dei file.

  • Se non si prevede di usare il --compare-hash flag, il computer in cui si esegue il comando di sincronizzazione deve avere un orologio di sistema accurato perché le ore dell'ultima modifica sono fondamentali per determinare se un file deve essere trasferito. Se il sistema ha un'asimmetria di clock significativa, evitare di modificare i file nella destinazione troppo vicino al momento in cui si prevede di eseguire un comando di sincronizzazione.

  • AzCopy usa le API da server a server per sincronizzare i dati tra gli account di archiviazione. Ciò significa che i dati vengano copiati direttamente tra i server di archiviazione. Tuttavia, AzCopy configura e monitora ogni trasferimento e per account di archiviazione di dimensioni maggiori (ad esempio, account che contengono milioni di BLOB), AzCopy potrebbe richiedere una notevole quantità di risorse di calcolo per eseguire queste attività. Pertanto, se si esegue AzCopy dalla macchina virtuale,assicurarsi che la macchina virtuale disponga di core/memoria sufficienti per gestire il carico.

  • Per evitare eliminazioni accidentali, assicurarsi di abilitare la funzionalità di eliminazione temporanea prima di usare il --delete-destination=prompt|true flag .

Aggiornare un contenitore con le modifiche apportate a un file system locale

In questo caso, il contenitore è la destinazione e il file system locale è l'origine.

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 path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

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

Esempio

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

Aggiornare un file system locale con le modifiche apportate a un contenitore

In questo caso, il file system locale è la destinazione e il contenitore è l'origine.

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 path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

azcopy sync 'https://<storage-account-name>.blob.core.windows.net/<container-name>' 'C:\myDirectory' --recursive

Esempio

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

Aggiornare un contenitore con modifiche in un altro contenitore

Il primo contenitore visualizzato in questo comando è l'origine. Il secondo è la destinazione.

Se si forniscono le credenziali di autorizzazione usando Microsoft Entra ID, assicurarsi di aver configurato i ruoli appropriati nell'account di origine e di destinazione. Vedere Opzione 1: Usare Microsoft Entra ID.

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 path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

azcopy sync 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>' --recursive

Esempio

azcopy sync 'https://mysourceaccount.blob.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

Aggiornare una directory con le modifiche apportate a una directory in un altro contenitore

La prima directory visualizzata in questo comando è l'origine. Il secondo è la destinazione.

Se si forniscono le credenziali di autorizzazione usando Microsoft Entra ID, assicurarsi di aver configurato i ruoli appropriati nell'account di origine e di destinazione. Vedere Opzione 1: Usare Microsoft Entra ID.

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 path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

azcopy sync 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<directory-name>/<SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<directory-name>' --recursive

Esempio

azcopy sync 'https://mysourceaccount.blob.core.windows.net/<container-name>/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myDirectory' --recursive

Sincronizzare con i flag facoltativi

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

Scenario Contrassegno
Specificare in che modo gli hash MD5 devono essere convalidati rigorosamente durante il download. --check-md5=[NoCheck|LogOnly |FailIfDifferent |FailIfDifferentOrMissing]
Escludere i file in base a un modello. --exclude-path
Specificare la modalità di dettaglio delle voci di log correlate alla sincronizzazione. --log-level=[WARNING|ERROR|INFO|NONE]

Per un elenco completo dei flag, vedere opzioni.

Nota

Il --recursive flag è impostato su true per impostazione predefinita. I --exclude-pattern flag e --include-pattern si applicano solo ai nomi di file e non ad altre parti del percorso del file.

Passaggi successivi

Altri esempi sono disponibili in questi articoli:

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