Introdução ao AzCopy

O AzCopy é um utilitário da linha de comando que pode utilizar para copiar blobs ou ficheiros de/para uma conta de armazenamento. Este artigo ajuda-o a transferir o AzCopy, a ligar-se à conta de armazenamento e a transferir ficheiros.

Nota

AzCopy V10 é a versão atualmente suportada do AzCopy.

Se precisar de utilizar uma versão anterior do AzCopy, consulte a versão anterior da secção AzCopy deste artigo.

Transferir o AzCopy

Em primeiro lugar, descarregue o ficheiro executável AzCopy V10 para qualquer diretório do seu computador. O AzCopy V10 é apenas um ficheiro executável, por isso não há nada para instalar.

Estes ficheiros são comprimidos como um ficheiro zip (Windows e Mac) ou um ficheiro de alcatrão (Linux). Para descarregar e descomprimir o ficheiro de alcatrão no Linux, consulte a documentação para a sua distribuição Linux.

Nota

Se pretender copiar dados de e para o seu serviço de armazenamento Azure Table, instale a versão AzCopy 7.3.

Executar o AzCopy

Para sua comodidade, considere adicionar a localização do diretório do AzCopy executável ao caminho do sistema para facilitar a utilização. Assim pode escrever azcopy de qualquer diretório no seu sistema.

Se optar por não adicionar o diretório AzCopy ao seu caminho, terá de alterar os diretórios para a localização do seu AzCopy executável e digitar ou nas indicações de azcopy comando Do Windows .\azcopy PowerShell.

Como proprietário da sua conta de Armazenamento Azure, não lhe são atribuídas automaticamente permissões de acesso aos dados. Antes de poder fazer algo significativo com a AzCopy, tem de decidir como irá fornecer credenciais de autorização ao serviço de armazenamento.

Autorizar a AzCopy

Pode fornecer credenciais de autorização utilizando o Azure Ative Directory (AD), ou utilizando um token de Assinatura de Acesso Partilhado (SAS).

Use esta tabela como guia:

Tipo de armazenamento Método de autorização atualmente suportado
Armazenamento de blobs Azure Active Directory e SAS
Armazenamento de bolhas (espaço hierárquico) Azure Active Directory e SAS
Armazenamento de ficheiros Apenas SAS

Opção 1: Utilizar o Diretório Ativo Azure

Esta opção está disponível apenas para armazenamento de bolhas. Ao utilizar o Azure Ative Directory, pode fornecer credenciais uma vez em vez de ter de anexar um token SAS a cada comando.

Nota

Na versão atual, se planeia copiar bolhas entre contas de armazenamento, terá de anexar um token SAS a cada URL de origem. Você pode omitir o token SAS apenas a partir do URL de destino. Por exemplo, consulte bolhas de cópia entre contas de armazenamento.

Para autorizar o acesso utilizando a Azure AD, consulte o Acesso Autorizado a bolhas com AzCopy e Azure Ative Directory (Azure AD).

Opção 2: Use um token SAS

Pode anexar um token SAS a cada URL de origem ou destino que utilize nos comandos AzCopy.

Este exemplo de comando copia novamente dados de um diretório local para um recipiente de bolhas. Um símbolo SAS fictício é anexado ao final do URL do recipiente.

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

Para saber mais sobre fichas SAS e como obter um, consulte Usando assinaturas de acesso partilhado (SAS).

Nota

A configuração necessária da transferência Secure de uma conta de armazenamento determina se a ligação a uma conta de armazenamento é assegurada com a Segurança da Camada de Transporte (TLS). Esta definição está ativada por predefinição.

Transferir dados

Depois de ter autorizado a sua identidade ou obtido um token SAS, pode começar a transferir dados.

Para encontrar comandos de exemplo, consulte qualquer um destes artigos.

Serviço Artigo
Armazenamento de Blobs do Azure Faça upload de ficheiros para o armazenamento de Azure Blob
Armazenamento de Blobs do Azure Baixar bolhas do Azure Blob Storage
Armazenamento de Blobs do Azure Bolhas de cópia entre contas de armazenamento Azure
Armazenamento de Blobs do Azure Sincronizar com o armazenamento da bolha Azure
Ficheiros do Azure Transferir dados com o AzCopy e armazenamento de ficheiros
Amazon S3 Copiar dados do Amazon S3 para o Azure Storage
Google Cloud Storage Copiar dados do Google Cloud Storage para Azure Storage (pré-visualização)
Armazenamento Azure Stack Transferir dados com armazenamento AzCopy e Azure Stack

Obter ajuda de comando

Para ver uma lista de comandos, escreva azcopy -h e, em seguida, prima a tecla ENTER.

Para conhecer um comando específico, basta incluir o nome do comando (por exemplo: azcopy list -h ).

Ajuda inline

Lista de comandos

A tabela a seguir lista todos os comandos AzCopy v10. Cada comando liga-se a um artigo de referência.

Comando Descrição
azcopy bench Executa um benchmark de desempenho carregando ou descarregando dados de teste para ou a partir de um local especificado.
azcopy copy Copia dados de origem para um local de destino
azcopy doc Gera documentação para a ferramenta no formato Markdown.
azcopy env Mostra as variáveis ambientais que podem configurar o comportamento da AzCopy.
azcopy jobs Subcommandes relacionados com a gestão de empregos.
azcopy jobs clean Remova todos os registos e planeie ficheiros para todos os trabalhos.
azcopy jobs list Exibe informações sobre todos os trabalhos.
azcopy jobs remove Remova todos os ficheiros associados à identificação de trabalho dada.
azcopy jobs resume Retoma o trabalho existente com a identificação de emprego dada.
azcopy jobs show Mostra informações detalhadas para a identificação do trabalho.
azcopy load Subcommandes relacionados com a transferência de dados em formatos específicos.
azcopy load clfs Transfere dados locais para um Contentor e armazena-os no formato Avere Cloud FileSystem (CLFS) da Microsoft.
azcopy list Lista as entidades num dado recurso.
azcopy login Entra no Azure Ative Directory para aceder aos recursos de Armazenamento Azure.
azcopy logout Regista o utilizador e termina o acesso aos recursos de Armazenamento Azure.
azcopy make Cria um recipiente ou partilha de ficheiros.
azcopy remove Elimine as bolhas ou ficheiros de uma conta de armazenamento Azure.
azcopy sync Replica a localização da fonte para o local do destino.

Use em um script

Com o tempo, o link de descarregamento AzCopy irá apontar para novas versões do AzCopy. Se o seu script descarregar AzCopy, o script pode parar de funcionar se uma versão mais recente do AzCopy modificar as funcionalidades de que o seu script depende.

Para evitar estes problemas, obtenha uma ligação estática (imutável) à versão atual do AzCopy. Dessa forma, o seu script descarrega a mesma versão exata do AzCopy cada vez que é executado.

Para obter o link, executar este comando:

Sistema operativo Comando
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
Windows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

Nota

Para o Linux, --strip-components=1 no comando remove a pasta de tar nível superior que contém o nome da versão e, em vez disso, extrai o binário diretamente para a pasta atual. Isto permite que o script seja atualizado com uma nova versão de azcopy apenas atualizar o wget URL.

A URL aparece na saída deste comando. O seu script pode então descarregar AzCopy usando esse URL.

Sistema operativo Comando
Linux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
Windows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

Escape personagens especiais em fichas SAS

Nos ficheiros de lote que têm a .cmd extensão, terás de escapar aos % caracteres que aparecem em fichas SAS. Pode fazê-lo adicionando um carácter adicional ao lado dos % % caracteres existentes na cadeia de fichas SAS.

Executar scripts usando Jenkins

Se planeias usar o Jenkins para executar scripts, certifica-te de que colocas o seguinte comando no início do script.

/usr/bin/keyctl new_session

Utilização no Explorador de Armazenamento Azure

O Storage Explorer utiliza a AzCopy para executar todas as suas operações de transferência de dados. Pode utilizar o Storage Explorer se quiser aproveitar as vantagens de desempenho do AzCopy, mas prefere utilizar uma interface gráfica do utilizador em vez da linha de comando para interagir com os seus ficheiros.

O Storage Explorer utiliza a chave da sua conta para realizar operações, por isso, depois de assinar no Storage Explorer, não necessitará de fornecer credenciais de autorização adicionais.

Configurar, otimizar e corrigir

Consulte qualquer um dos seguintes recursos:

Use uma versão anterior

Se precisar de utilizar a versão anterior do AzCopy, consulte qualquer uma das seguintes ligações:

Passos seguintes

Se tiver dúvidas, problemas ou feedback geral, envie-os na página do GitHub.