Partilhar via

Copiar blobs entre contas de armazenamento do Azure usando AzCopy

Você pode usar o utilitário de linha de comando AzCopy v10 para copiar blobs, diretórios e contêineres entre contas de armazenamento.

Para obter exemplos de outros tipos de tarefas, como carregar arquivos, baixar blobs e sincronizar com o armazenamento de Blobs, consulte os links na seção Próximas etapas deste artigo.

O AzCopy usa APIs de servidor para servidor, portanto, os dados são copiados diretamente entre os servidores de armazenamento.

Introdução

Consulte o artigo Introdução ao AzCopy para baixar o AzCopy e saber mais sobre as maneiras de fornecer credenciais de autorização para o serviço de armazenamento.

Nota

Os exemplos neste artigo pressupõem que você forneça credenciais de autorização usando a ID do Microsoft Entra e que sua identidade do Microsoft Entra tenha as atribuições de função adequadas para contas de origem e de destino.

Como alternativa, você pode acrescentar um token SAS à URL de origem ou de destino em cada comando AzCopy. Por exemplo: azcopy copy 'https://<source-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>' 'https://<destination-storage-account-name>.blob.core.windows.net/<container-name>/<blob-path><SAS-token>'.

Diretrizes

Aplique as seguintes diretrizes aos comandos do AzCopy.

  • Se você usar a autorização do Microsoft Entra para origem e destino, ambas as contas deverão pertencer ao mesmo locatário do Microsoft Entra.

  • Seu cliente deve ter acesso à rede para as contas de armazenamento de origem e de destino.

    Para saber como definir as configurações de rede para cada conta de armazenamento, consulte Configurar firewalls de armazenamento do Azure e redes virtuais.

    Para saber mais sobre topologias de rede suportadas ao copiar entre contas, consulte Copiar blobs entre contas de armazenamento com restrição de acesso.

  • Se você copiar para uma conta de armazenamento de blob de bloco premium, omita a camada de acesso de um blob da operação de cópia definindo como s2s-preserve-access-tierfalse (Por exemplo: --s2s-preserve-access-tier=false). As contas de armazenamento de blob de bloco premium não suportam camadas de acesso.

  • Você pode aumentar a taxa de transferência das operações de cópia definindo o valor da variável de AZCOPY_CONCURRENCY_VALUE ambiente. Para saber mais, consulte Aumentar simultaneidade.

  • Se os blobs de origem tiverem tags de índice e você quiser retê-las, será necessário reaplicá-las aos blobs de destino. Para obter informações sobre como definir marcas de índice, consulte a seção Copiar blobs para outra conta de armazenamento com marcas de índice deste artigo.

Copiar um blob

Copie um blob para outra conta de armazenamento usando o comando azcopy copy .

Gorjeta

Este exemplo inclui argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto no Shell de Comando do Windows (cmd.exe). Se você estiver usando um Shell de Comando do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>'

Exemplo

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

Exemplo (pontos de extremidade de armazenamento Data Lake)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'

A operação de cópia é síncrona. Quando o comando retorna, indica que todos os arquivos foram copiados.

Copiar um diretório

Copie um diretório para outra conta de armazenamento usando o comando azcopy copy .

Gorjeta

Este exemplo inclui argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto no Shell de Comando do Windows (cmd.exe). Se você estiver usando um Shell de Comando do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

Exemplo

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

Exemplo (pontos de extremidade de armazenamento Data Lake)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive

A operação de cópia é síncrona. Quando o comando retorna, todos os arquivos são copiados.

Copiar um recipiente

Copie um contêiner para outra conta de armazenamento usando o comando azcopy copy .

Gorjeta

Este exemplo inclui argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto no Shell de Comando do Windows (cmd.exe). Se você estiver usando um Shell de Comando do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --recursive

Exemplo

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive

Exemplo (pontos de extremidade de armazenamento Data Lake)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/mycontainer' 'https://mydestinationaccount.dfs.core.windows.net/mycontainer' --recursive

A operação de cópia é síncrona. Quando o comando retorna, todos os arquivos são copiados.

Copiar contêineres, diretórios e blobs

Copie todos os contêineres, diretórios e blobs para outra conta de armazenamento usando o comando azcopy copy .

Gorjeta

Este exemplo inclui argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto no Shell de Comando do Windows (cmd.exe). Se você estiver usando um Shell de Comando do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.windows.net/' 'https://<destination-storage-account-name>.<blob or dfs>.core.windows.net/' --recursive

Exemplo

azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive

Exemplo (pontos de extremidade de armazenamento Data Lake)

azcopy copy 'https://mysourceaccount.dfs.core.windows.net/' 'https://mydestinationaccount.dfs.core.windows.net' --recursive

A operação de cópia é síncrona. Quando o comando retorna, indica que todos os arquivos foram copiados.

Copiar blobs e adicionar tags de índice

Copie blobs para outra conta de armazenamento e adicione tags de índice de blob ao blob de destino.

Se estiver a utilizar a autorização do Microsoft Entra, atribua a função de Proprietário de Dados do Blob de Armazenamento à sua entidade de segurança ou conceda-lhe permissão à Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write através de uma função personalizada do Azure. Se você estiver usando um token SAS (Assinatura de Acesso Compartilhado), o token deverá fornecer acesso às tags do blob por meio da t permissão SAS.

Para adicionar tags, use a opção --blob-tags com um par chave-valor codificado por URL.

Por exemplo, para adicionar a chave my tag e o valor my tag value, adicione --blob-tags='my%20tag=my%20tag%20value' ao parâmetro de destino.

Separe várias tags de índice com um e comercial (&). Por exemplo, se você quiser adicionar a chave my second tag e o valor my second tag value, a cadeia de caracteres de opção completa será --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'.

Os exemplos a seguir mostram como usar a --blob-tags opção.

Gorjeta

Estes exemplos incluem argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto no Shell de Comando do Windows (cmd.exe). Se você estiver usando um Shell de Comando do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Exemplo de Blob


azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Exemplo de diretório

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Exemplo de contêiner

azcopy copy 'https://mysourceaccount.blob.core.windows.net/mycontainer' 'https://mydestinationaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Exemplo de conta

azcopy copy 'https://mysourceaccount.blob.core.windows.net/' 'https://mydestinationaccount.blob.core.windows.net' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

A operação de cópia é síncrona. Quando o comando retorna, todos os arquivos são copiados.

Nota

Se você especificar um diretório, contêiner ou conta para a origem, todos os blobs copiados para o destino terão as mesmas tags especificadas no comando.

Cópia com sinalizadores opcionais

Você pode ajustar sua operação de cópia usando sinalizadores opcionais. Aqui estão alguns exemplos.

Cenário Sinalizador
Copie blobs como Blobs de Bloco, Página ou Acréscimo. --blob-type=[BlockBlob|PageBlob|AppendBlob]
Copie para uma camada de acesso específica (como a camada de arquivamento). --block-blob-tier=[Nenhum|Quente|Legal|Arquivo]
Descomprima automaticamente os ficheiros. --descomprimir=[gzip|esvaziar]

Para obter uma lista completa, consulte opções.

Especificar tipos de origem e destino

AzCopy usa o --from-to parâmetro para definir explicitamente os tipos de recursos de origem e destino quando a deteção automática pode falhar, como em cenários de tubulação ou emuladores. Este parâmetro ajuda o AzCopy a entender o contexto da transferência e otimizar de acordo.

Valor FromTo Description
BlobBlob Copiar entre dois locais de Armazenamento de Blobs do Azure
BlobBlobFS Copiar do Armazenamento de Blobs do Azure para o Azure Data Lake Gen2 (BlobFS)
BlobFSBlob Copiar do Azure Data Lake Gen2 (BlobFS) para o Armazenamento de Blobs do Azure
BlobFSBlobFS Copiar entre dois locais do Azure Data Lake Gen2 (BlobFS)
BlobFSFile Copiar do Azure Data Lake Gen2 (BlobFS) para o Armazenamento de Arquivos do Azure
BlobFile Copiar do Armazenamento de Blobs do Azure para o Armazenamento de Arquivos do Azure
FileBlob Copiar do Armazenamento de Arquivos do Azure para o Armazenamento de Blobs do Azure
FileBlobFS Copiar do Armazenamento de Arquivos do Azure para o Azure Data Lake Gen2 (BlobFS)

Próximos passos

Encontre mais exemplos nestes artigos:

Consulte estes artigos para definir configurações, otimizar o desempenho e solucionar problemas:

  • Last updated on