Introdução ao AzCopy

O AzCopy é um utilitário de linha de comando que você pode usar para copiar dados de, para ou entre contas de armazenamento. Este artigo ajuda você a baixar o AzCopy, conectar-se à sua conta de armazenamento e, em seguida, transferir os dados.

O AzCopy v10 é a versão atualmente com suporte do AzCopy. Ele tem suporte apenas em versões do Windows, Linux ou macOS que são oficialmente mantidas. Se você precisar usar uma versão anterior do AzCopy, consulte a seção Usar a versão anterior do AzCopy deste artigo.

Casos de uso do AzCopy

Use o AzCopy para copiar seus dados para, de ou entre contas de armazenamento do Azure. Os casos de uso comuns incluem:

• Copiar dados de uma fonte local para uma conta de armazenamento do Azure
• Copiar dados de uma conta de armazenamento do Azure para uma fonte local
• Copiar dados de uma conta de armazenamento para outra conta de armazenamento

O AzCopy dá suporte a cada caso de uso com comandos e opções. Por exemplo, o AzCopy tem comandos nativos para copiar ou sincronizar dados. Esse suporte torna o AzCopy uma ferramenta flexível que você pode usar para atividades de cópia única e cenários de sincronização contínua. Você pode direcionar serviços de armazenamento específicos, como Armazenamento de Blobs do Azure ou Arquivos do Azure, e também pode copiar entre eles. Por exemplo, você pode copiar dados de contêineres do Azure Blob Storage para compartilhamentos de arquivos do Azure ou vice-versa.

Para obter uma lista completa de guias de transferência de dados, consulte a seção Transferir dados deste artigo.

Obter AzCopy

Se você estiver usando o AzCopy em um computador Linux, poderá usar um gerenciador de pacotes. Para todos os outros sistemas operacionais, baixe um arquivo binário portátil. Para obter informações detalhadas sobre as versões do AzCopy, consulte a página de lançamento do AzCopy.

Usar um gerenciador de pacotes (somente Linux)

Instalar o AzCopy por meio do gerenciador de pacotes da distribuição do Linux é a maneira mais conveniente e mantenedível de obter essa ferramenta. A instalação do gerenciador de pacotes inclui resolução automática de dependência, atualizações simplificadas e integração com o gerenciamento de software do sistema. Para obter diretrizes passo a passo, consulte Instalar o AzCopy no Linux usando um gerenciador de pacotes.

Baixar um binário portátil

Um pacote de instalação está disponível apenas para Linux. Para todos os outros sistemas operacionais, você pode baixar o arquivo executável do AzCopy v10 para qualquer diretório em seu computador.

• Windows de 64 bits (zip)
• Windows de 32 bits (zip)
• Windows ARM64 (zip)
• Linux x86-64 (tar)
• Linux ARM64 (tar)
• macOS (zip)
• macOS ARM64 (zip)

Esses arquivos são compactados como um arquivo zip (Windows e Mac) ou tar (Linux). Para baixar e descompactar o arquivo tar no Linux, confira a documentação da distribuição do Linux.

Adicionar AzCopy ao caminho do sistema

Para conveniência, considere adicionar o local do diretório do executável do AzCopy à variável de ambiente PATH do sistema. Dessa forma, você pode digitar azcopy de qualquer diretório no seu sistema. Se você não adicionar o diretório do AzCopy ao seu caminho, precisará alterar os diretórios para o local do executável do AzCopy e digitar azcopy ou .\azcopy em um shell de comando.

Autorizar o AzCopy

Como proprietário da conta do Armazenamento do Microsoft Azure, você não recebe permissões automaticamente para acessar dados. Antes de realizar qualquer trabalho significativo com o AzCopy, você precisa decidir como oferecerá credenciais de autorização ao serviço de armazenamento. Você pode fornecer credenciais usando a ID do Microsoft Entra ou usando um token SAS.

Autorizar com a ID do Microsoft Entra

Ao usar o Microsoft Entra ID, você pode fornecer credenciais uma vez, em vez de ter que acrescentar um token SAS a cada comando. Comece escolhendo qual tipo de entidade de segurança você deseja autorizar. Use a tabela a seguir como guia.

Autorizar com um token SAS

Você pode acrescentar um token SAS a cada URL de origem ou de destino que você usa em seus comandos do AzCopy. Esse exemplo de comando copia recursivamente os dados de um diretório local para um contêiner de blobs. Um token SAS fictício é acrescentado ao final do URL do contêiner.

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 tokens SAS e como obter um, consulte Como usar sas (assinaturas de acesso compartilhado).

Transferir dados

Depois de autorizar sua identidade ou obter um token SAS, você poderá começar a transferir dados.

Para obter comandos de exemplo, consulte qualquer um desses artigos.

Você pode executar comandos do AzCopy interativamente. Você também pode incorporar o AzCopy em scripts automatizados para operações em lotes, transferências de dados agendadas ou pipelines de integração contínua. Para obter mais informações, confira Usar o AzCopy em scripts e transferências agendadas.

Obter ajuda de comando

Para ver uma lista de comandos, digite azcopy -h e pressione a tecla ENTER.

Para saber mais sobre um comando específico, inclua o nome do comando (por exemplo: azcopy list -h).

Lista de comandos

A tabela a seguir lista todos os comandos AzCopy v10. Cada comando é vinculado a um artigo de referência.

Configurar, otimizar e corrigir

Confira qualquer dos recursos a seguir:

• Configurações do AzCopy

• Otimizar o desempenho do AzCopy

• Localizar erros e retomar trabalhos usando arquivos de log e de plano no AzCopy

• Solucionar problemas com o AzCopy v10

Próximas etapas

Se você tiver dúvidas, problemas ou comentários gerais, envie-os no GitHub.