Introduzione ad AzCopy

AzCopy è un'utilità della riga di comando che è possibile usare per copiare i BLOB o i file da e verso un account di archiviazione. Questo articolo consente di scaricare AzCopy, connettersi all'account di archiviazione e di trasferire i dati.

Questo video illustra come scaricare ed eseguire l'utilità AzCopy.

I passaggi del video sono descritti anche nelle sezioni seguenti.

Casi d'uso per AzCopy

AzCopy può essere usato per copiare i dati in/da/tra account di archiviazione di Azure. I casi d'uso comuni in cui può verificarsi questa situazione includono:

• Copia di dati da un'origine locale in un account di archiviazione di Azure
• Copia di dati da un account di archiviazione di Azure a un'origine locale
• Copia di dati da un account di archiviazione a un altro account di archiviazione

Ognuno di questi casi d'uso ha opzioni univoche. Ad esempio, AzCopy include comandi nativi per la copia e/o la sincronizzazione dei dati. Pertanto, AzCopy è uno strumento flessibile che può essere usato per le attività di copia una tantum e scenari di sincronizzazione continua. AzCopy consente anche di specificare servizi di archiviazione specifici, ad esempio Archiviazione BLOB di Azure o File di Azure. Ciò consente di copiare dati da BLOB in file, da file in BLOB, da file in file e così via.

Per altre informazioni su questi scenari, vedere:

• Caricare file in Archiviazione BLOB di Azure usando AzCopy
• Scaricare BLOB da Archiviazione BLOB di Azure usando AzCopy
• Copiare BLOB tra account di Archiviazione di Azure usando AzCopy
• Eseguire la sincronizzazione con l'archivio BLOB di Azure mediante AzCopy

Installare AzCopy in Linux usando una gestione pacchetti

È possibile installare AzCopy usando un pacchetto Linux ospitato nel Repository software Linux per prodotti Microsoft.

sudo tdnf install azcopy

Scaricare il file binario portatile AzCopy

In alternativa all'installazione di un pacchetto, è possibile scaricare il file eseguibile AzCopy V10 in qualsiasi directory del computer.

• Windows 64 bit (zip)
• Windows 32 bit (zip)
• Linux x86-64 (tar)
• Linux ARM64 (tar)
• macOS (zip)
• macOS ARM64 Preview (zip)

Questi file vengono compressi come file ZIP (Windows e Mac) o come file tar (Linux). Per scaricare e decomprimere il file tar in Linux, vedere la documentazione per la distribuzione linux.

Per informazioni dettagliate sulle versioni di AzCopy, vedere la pagina relativa alla versione di AzCopy.

Eseguire Azcopy

Per praticità, è consigliabile aggiungere il percorso della directory del file eseguibile di AzCopy al percorso di sistema per facilitarne l'uso. In questo modo è possibile digitare azcopy da qualsiasi directory nel sistema.

Se si sceglie di non aggiungere la directory AzCopy al percorso, sarà necessario modificare le directory nel percorso del file eseguibile di AzCopy e digitare azcopy oppure .\azcopy nei prompt dei comandi di Windows PowerShell.

In quanto proprietario dell'account di Archiviazione di Azure, non si ricevono automaticamente le autorizzazioni per l'accesso ai dati. Prima di poter eseguire qualsiasi operazione significativa con AzCopy, è necessario decidere come fornire le credenziali di autorizzazione al servizio di archiviazione.

Autorizzare AzCopy

È possibile fornire le credenziali di autorizzazione usando Microsoft Entra ID o un token di firma di accesso condiviso (SAS).

Opzione 1: Usare Microsoft Entra ID

Usando Microsoft Entra ID, è possibile specificare le credenziali una sola volta invece di dover aggiungere un token di firma di accesso condiviso a ogni comando.

Opzione 2: Usare un token di firma di accesso condiviso

È possibile aggiungere un token di firma di accesso condiviso a ogni URL di origine o di destinazione usato nei comandi di AzCopy.

Questo comando di esempio copia in modo ricorsivo i dati da una directory locale a un contenitore BLOB. Alla fine dell'URL del contenitore viene aggiunto un token di firma di accesso condiviso fittizio.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Per altre informazioni sui token di firma di accesso condiviso e su come ottenerne uno, vedere Informazioni sulle firme di accesso condiviso (SAS).

Trasferire i dati

Dopo aver autorizzato l'identità o ottenuto un token di firma di accesso condiviso, è possibile iniziare a trasferire i dati.

Per trovare comandi di esempio, vedere uno di questi articoli.

Ottenere la guida per i comandi

Per vedere un elenco di comandi, digitare azcopy -h, quindi premere il tasto INVIO.

per informazioni su un comando specifico, è sufficiente includere il nome del comando (ad esempio: azcopy list -h).

Elenco dei comandi

Nella tabella seguente sono elencati tutti i comandi azCopy v10. Ogni comando è collegato a un articolo di riferimento.

Usare in uno script

Ottenere un link di download statico

Nel corso del tempo, il link al download di AzCopy punterà alle nuove versioni di AzCopy. Se lo script scarica AzCopy, lo script potrebbe smettere di funzionare se una versione più recente di AzCopy modifica le funzionalità da cui dipende lo script.

Per evitare questi problemi, ottenere un collegamento statico (non modificabile) alla versione corrente di AzCopy. In questo modo, lo script scarica la stessa versione esatta di AzCopy ogni volta che viene eseguita.

Per ottenere il link, eseguire questo comando:

L'URL viene visualizzato nell'output di questo comando. Lo script può quindi scaricare AzCopy usando tale URL.

Linux

wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1

Windows PowerShell

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\'
$AzCopy = (Get-ChildItem -path '.\' -Recurse -File -Filter 'azcopy.exe').FullName
# Invoke AzCopy 
& $AzCopy

PowerShell 6.1+

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
$AzCopy = (Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\' -PassThru | where-object {$_.Name -eq 'azcopy.exe'}).FullName
# Invoke AzCopy
& $AzCopy

Caratteri speciali di escape nei token di firma di accesso condiviso

Nei file batch con estensione .cmd è necessario eseguire l'escape dei caratteri % visualizzati nei token di firma di accesso condiviso. A tale scopo, aggiungere un carattere aggiuntivo % accanto ai caratteri esistenti % nella stringa del token di firma di accesso condiviso. La sequenza di caratteri risultante viene visualizzata come %%. Assicurarsi di aggiungere un ^ aggiuntivo prima di ogni carattere & per creare la sequenza di caratteri ^&.

Eseguire script con Jenkins

Se si prevede di usare Jenkins per eseguire gli script, assicurarsi di inserire il comando seguente all'inizio dello script.

/usr/bin/keyctl new_session

Usar in Azure Storage Explorer

Storage Explorer usa AzCopy per eseguire tutte le operazioni di trasferimento dei dati. È possibile usare Storage Explorer se si vogliono applicare i vantaggi delle prestazioni di AzCopy, ma si preferisce usare un'interfaccia utente grafica anziché la riga di comando per interagire con i file.

Storage Explorer usa la chiave dell'account per eseguire operazioni, quindi dopo l'accesso a Storage Explorer non è necessario fornire credenziali di autorizzazione aggiuntive.

Configurare, ottimizzare e correggere

Vedere una delle risorse seguenti:

• 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

Usare una versione precedente (deprecata)

Se è necessario usare la versione precedente di AzCopy, vedere uno dei link seguenti:

• AzCopy in Windows (v8)

• AzCopy in Linux (v7)

Passaggi successivi

Eventuali domande, problemi o commenti di carattere generale devono essere inoltrati alla pagina GitHub.