Introdução ao AzCopy

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

O AzCopy v10 é a versão atualmente suportada do AzCopy. É suportado 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:

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

AzCopy suporta cada caso de uso com comandos e opções. Por exemplo, 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 o Armazenamento de Blob do Azure ou Arquivos do Azure, e também pode copiar entre eles. Por exemplo, você pode copiar dados de contêineres do Armazenamento de Blobs do Azure 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 uma máquina Linux, poderá usar um gerenciador de pacotes. Para todos os outros sistemas operativos, descarregue um ficheiro binário portátil. Para obter informações detalhadas sobre as versões do AzCopy, consulte a página da versão do AzCopy.

Usar um gerenciador de pacotes (somente Linux)

Instalar o AzCopy através do gerenciador de pacotes da sua distribuição Linux é a maneira mais conveniente e fácil de manter para 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 seu sistema. Para obter orientação 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 operativos, pode descarregar o ficheiro executável do AzCopy v10 para qualquer diretório do seu computador.

• Windows de 64 bits (zip)
• Windows de 32 bits (zip)
• Windows ARM64 (zip)
• Linux x86-64 (alcatrão)
• Linux ARM64 (alcatrão)
• macOS (zip)
• macOS ARM64 (zip)

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

Adicionar AzCopy ao caminho do sistema

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

Autorizar AzCopy

Como proprietário da sua conta de Armazenamento do Azure, não lhe são atribuídas automaticamente permissões para aceder a dados. Antes de poder fazer qualquer coisa significativa com o AzCopy, você precisa decidir como fornecerá credenciais de autorização para o serviço de armazenamento. Você pode fornecer credenciais usando o ID do Microsoft Entra ou usando um token SAS.

Autorizar com o Microsoft Entra ID

Usando o Microsoft Entra ID, você pode fornecer credenciais uma vez, em vez de ter que acrescentar um token SAS a cada comando. Comece por escolher qual o tipo de entidade de segurança que 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 destino que você usa em seus comandos AzCopy. Este comando de exemplo copia recursivamente dados de um diretório local para um contêiner de blob. Um token SAS fictício é anexado ao final da 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 Usando assinaturas de acesso compartilhado (SAS).

Transferir dados

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

Para exemplos de comandos, consulte um dos seguintes artigos.

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

Obter ajuda para comandos

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 vincula-se a um artigo de referência.

Configurar, otimizar e corrigir

Consulte qualquer um dos seguintes recursos:

• Definições de configuração do AzCopy

• Otimize o desempenho do AzCopy

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

• Solucionar problemas com o AzCopy v10

Próximos passos

Se você tiver dúvidas, problemas ou feedback geral, envie-os no GitHub.