Compartilhar via

Carregar arquivos no Armazenamento de Blobs do Azure usando o AzCopy

Você pode carregar arquivos e diretórios no Armazenamento de Blobs usando o utilitário de linha de comando AzCopy v10.

Para ver exemplos de outros tipos de tarefas, como baixar blobs, sincronizar com o Armazenamento de Blobs ou copiar blobs entre contas, confira os links apresentados na seção Próximas etapas deste artigo.

Introdução

Confira o artigo Introdução ao AzCopy para baixar o AzCopy e aprender sobre as maneiras em que você pode fornecer credenciais de autorização para o serviço de armazenamento.

Observação

Os exemplos neste artigo pressupõem que você forneça credenciais de autorização usando a ID do Microsoft Entra.

Se você quiser usar um token SAS para autorizar o acesso aos dados de blob, acrescente esse token à URL do recurso em cada comando do AzCopy. Por exemplo: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Criar um contêiner

Use o comando azcopy make para criar um contêiner.

Dica

Esses exemplos incluem argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto pelo shell de comando do Windows (cmd.exe). Se você usar um Shell de Comando do Windows (cmd.exe), inclua argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy make 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>'

Exemplo

azcopy make 'https://mystorageaccount.blob.core.windows.net/mycontainer'

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy make 'https://mystorageaccount.dfs.core.windows.net/mycontainer'

Para obter documentos de referência detalhados, confira azcopy make.

Carregar um arquivo

Carregue um arquivo usando o comando azcopy copy.

Dica

Esses exemplos incluem argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto pelo shell de comando do Windows (cmd.exe). Se você usar um Shell de Comando do Windows (cmd.exe), inclua argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

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

Exemplo

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt'

Você também pode carregar um arquivo usando um símbolo curinga (*) em qualquer lugar no caminho do arquivo ou nome do arquivo. Por exemplo: 'C:\myDirectory\*.txt' ou C:\my*\*.txt.

Carregar um diretório

Carregue um diretório usando o comando azcopy copy.

Este exemplo copia um diretório (e todos os arquivos nesse diretório) para um contêiner de blob. O resultado é um diretório no contêiner com o mesmo nome.

Dica

Esses exemplos incluem argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto pelo shell de comando do Windows (cmd.exe). Se você usar um Shell de Comando do Windows (cmd.exe), inclua argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

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

Exemplo

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --recursive

Para copiar para um diretório dentro do contêiner, basta especificar o nome desse diretório na cadeia de caracteres do comando.

Exemplo

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' --recursive

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' --recursive

Se você especificar o nome de um diretório que não existe no contêiner, o AzCopy criará um novo diretório com esse nome.

Carregar conteúdo do diretório

Carregue o conteúdo de um diretório usando o comando azcopy copy. Use o símbolo curinga (*) para carregar o conteúdo sem copiar o diretório recipiente propriamente dito.

Dica

Esses exemplos incluem argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto pelo shell de comando do Windows (cmd.exe). Se você usar um Shell de Comando do Windows (cmd.exe), inclua argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>'

Exemplo

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory'

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory'

Acrescente o sinalizador --recursive para carregar arquivos em todos os subdiretórios.

Carregar arquivos específicos

Você pode carregar arquivos específicos usando nomes de arquivo completos, nomes parciais com caracteres curinga (*) ou usando datas e horas.

Dica

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

Especificar vários nomes de arquivo completos

Use o comando azcopy copy com a opção --include-path. Separe os nomes de arquivo individuais usando um ponto e vírgula (;).

Sintaxe

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --include-path <semicolon-separated-file-list>

Exemplo

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive'

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive'

Neste exemplo, AzCopy transfere o diretório C:\myDirectory\photos e o arquivo C:\myDirectory\documents\myFile.txt. Inclua a opção --recursive para transferir todos os arquivos no diretório C:\myDirectory\photos.

Você também pode excluir arquivos usando a opção --exclude-path. Para saber mais, confira a documentação de referência do azcopy copy.

Usar caracteres curingas

Use o comando azcopy copy com a opção --include-pattern. Especifique nomes parciais que incluam os caracteres curinga. Separe os nomes usando ponto e vírgula (;).

Sintaxe

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

Exemplo

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.windows.net/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'

Você também pode excluir arquivos usando a opção --exclude-pattern. Para saber mais, confira a documentação de referência do azcopy copy.

As opções --include-pattern e --exclude-pattern aplicam-se somente a nomes de arquivo e não ao caminho. Se você quiser copiar todos os arquivos de texto que existem em uma árvore de diretório, use a opção -recursive para obter a árvore de diretórios inteira e, depois, use o -include-pattern e especifique *.txt para obter todos os arquivos de texto.

Carregar arquivos que foram modificados antes ou depois de uma determinada data e hora

Use o comando azcopy copy com a opção --include-before ou --include-after. Especifique uma data e hora no formato ISO-8601 (por exemplo: 2020-08-19T15:04:00Z).

Os exemplos a seguir carregam arquivos que foram modificados na data especificada ou após.

Sintaxe

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' --include-after <Date-Time-in-ISO-8601-format>

Exemplo

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory'  --include-after '2020-08-19T15:04:00Z'

Exemplo (ponto de extremidade do Data Lake Storage)

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory'   --include-after '2020-08-19T15:04:00Z'

Para referência detalhada, confira a documentação de referência do azcopy copy.

Carregar com marcas de índice

Você pode carregar um arquivo e adicionar marcas de índice de blob ao blob de destino.

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

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, inclua --blob-tags='my%20tag=my%20tag%20value' no parâmetro de destino.

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

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

Dica

Esses exemplos incluem argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto pelo shell de comando do Windows (cmd.exe). Se você usar um Shell de Comando do Windows (cmd.exe), inclua argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Carregar um arquivo

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

Carregar um diretório

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.windows.net/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Carregar conteúdo do diretório

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Observação

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

Carregar com sinalizadores opcionais

Você pode ajustar sua operação de upload usando sinalizadores opcionais. Alguns exemplos são mostrados a seguir.

Cenário Sinalizador
Carregue arquivos como blobs de acréscimo ou blobs de páginas. --blob-type=[BlockBlob|PageBlob|AppendBlob]
Carregue para uma camada de acesso específica (como a camada de arquivo). --block-blob-tier=[None|Hot|Cool|Archive]

Para obter uma lista completa, confira as opções.

Especificar tipos de origem e destino

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

Valor FromTo Description
LocalBlob Carregar do sistema de arquivos local para o Armazenamento de Blobs do Azure
LocalBlobFS Carregar do sistema de arquivos local para o Azure Data Lake Gen2 (BlobFS)
PipeBlob Transmitir dados de um pipe para o Armazenamento de Blobs do Azure
PipeFile Transmitir dados de um pipe para o Armazenamento de Arquivos do Azure

Próximas etapas

Encontre mais exemplos nestes artigos:

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

  • Last updated on