Gerencie diretórios e arquivos no Azure Data Lake Storage usando o CLI do Azure

Este artigo mostra como usar a CLI do Azure para criar e gerenciar diretórios e arquivos nas contas de armazenamento que têm um namespace hierárquico.

Todos os exemplos neste artigo assumem uma conta de armazenamento que tem um namespace hierárquico ativado, e eles usam a autorização Microsoft Entra (--auth-mode login).

Exemplos | Fazer comentários

Pré-requisitos

• Uma assinatura do Azure. Para obter mais informações, confira Obter a avaliação gratuita do Azure.

• Uma conta de armazenamento com o namespace hierárquico habilitado. Siga estas instruções para criar um.

• CLI do Azure versão 2.6.0 ou posterior.

Certifique-se de ter a versão correta da CLI do Azure instalada

1. Abra o Azure Cloud Shell ou, se você instalou a CLI do Azure localmente, abra um aplicativo de console de comandos como o PowerShell do Windows.

2. Verifique se a versão instalada do CLI do Azure é 2.6.0 ou posterior usando o seguinte comando.

    az --version
   

   Se sua versão do CLI do Azure for anterior a 2.6.0, instale uma versão posterior. Para obter mais informações, consulte Instalar a CLI do Azure.

Conectar à conta

1. Se você estiver usando a CLI do Azure localmente, execute o comando de logon.

   az login
   

   Se a CLI conseguir abrir seu navegador padrão, ela abre o navegador e carrega uma página de login no Azure.

   Caso contrário, abra uma página de navegador em https://aka.ms/devicelogin e insira o código de autorização exibido no terminal. Em seguida, entre com suas credenciais de conta no navegador.

   Para saber mais sobre os diferentes métodos de autenticação, consulte Autorizar o acesso a dados de blob ou fila com a CLI do Azure.

2. Se sua identidade estiver associada a mais de uma assinatura e você não for solicitado a selecionar a assinatura, defina sua assinatura ativa para a assinatura da conta de armazenamento na qual deseja operar. Neste exemplo, substitua o valor do espaço reservado <subscription-id> pela ID da sua assinatura.

   az account set --subscription <subscription-id>
   

   Substitua o valor do marcador <subscription-id> pelo ID da sua assinatura.

Criar um contêiner

Um contêiner atua como um sistema de arquivos para seus arquivos. Crie um usando o comando az storage fs create.

Este exemplo cria um contêiner chamado my-file-system.

az storage fs create -n my-file-system --account-name mystorageaccount --auth-mode login

Para verificar se o container existe, execute o comando az storage fs show .

Mostrar propriedades do contêiner

Use o comando az storage fs show para imprimir as propriedades de um container no console.

az storage fs show -n my-file-system --account-name mystorageaccount --auth-mode login

Listar conteúdo do contêiner

Use o comando de lista de arquivos fs do az storage para listar o conteúdo de um contêiner.

Este exemplo lista o conteúdo de um contêiner chamado my-file-system.

az storage fs file list -f my-file-system --account-name mystorageaccount --auth-mode login

Excluir um contêiner

Use o comando az storage fs delete para excluir um contêiner.

Este exemplo exclui um contêiner chamado my-file-system.

az storage fs delete -n my-file-system --account-name mystorageaccount --auth-mode login

Criar um diretório

Use o comando az storage fs directory create para criar uma referência a diretório.

Este exemplo adiciona um diretório chamado my-directory a um contêiner chamado my-file-system que está localizado em uma conta chamada mystorageaccount.

az storage fs directory create -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

Para verificar se o diretório existe, execute o comando az storage fs directory exists .

Mostrar propriedades do diretório

Exiba as propriedades de um diretório no console usando o comando az storage fs directory show.

az storage fs directory show -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

Renomear ou mover um diretório

Renomeie ou mova um diretório usando o comando az storage fs directory move.

Este exemplo renomeia um diretório do nome my-directory para o nome my-new-directory no mesmo contêiner.

az storage fs directory move -n my-directory -f my-file-system --new-directory "my-file-system/my-new-directory" --account-name mystorageaccount --auth-mode login

Este exemplo move um diretório para um contêiner chamado my-second-file-system.

az storage fs directory move -n my-directory -f my-file-system --new-directory "my-second-file-system/my-new-directory" --account-name mystorageaccount --auth-mode login

Excluir um diretório

Exclua um diretório usando o comando az storage fs directory delete.

Este exemplo exclui um diretório chamado my-directory.

az storage fs directory delete -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

Verificar se há um diretório

Verifique se existe um diretório específico no contêiner usando o comando az storage fs directory exists.

Este exemplo revela se um diretório chamado my-directory existe no contêiner my-file-system.

az storage fs directory exists -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login

Baixar de um diretório

Baixe um arquivo de um diretório usando o comando az storage fs file download.

Este exemplo baixa um arquivo chamado upload.txt de um diretório chamado my-directory.

az storage fs file download -p my-directory/upload.txt -f my-file-system -d "C:\myFolder\download.txt" --account-name mystorageaccount --auth-mode login

Listar conteúdo do diretório

Use o comando de lista de arquivos fs do az storage para listar o conteúdo de um diretório.

Este exemplo lista o conteúdo de um diretório chamado my-directory que está localizado no contêiner my-file-system de uma conta de armazenamento chamada mystorageaccount.

az storage fs file list -f my-file-system --path my-directory --account-name mystorageaccount --auth-mode login

Carregar um arquivo em um diretório

Carregue um arquivo em um diretório usando o comando az storage fs file upload.

Este exemplo carrega um arquivo chamado upload.txt em um diretório chamado my-directory.

az storage fs file upload -s "C:\myFolder\upload.txt" -p my-directory/upload.txt -f my-file-system --account-name mystorageaccount --auth-mode login

Para verificar se o arquivo foi enviado, execute o comando de lista de arquivos do az storage fs .

Mostrar propriedades do arquivo

Imprima as propriedades de um arquivo no console usando o comando az storage fs file show.

az storage fs file show -p my-file.txt -f my-file-system --account-name mystorageaccount --auth-mode login

Renomear ou mover um arquivo

Renomeie ou mova um arquivo usando o comando az storage fs file move.

Este exemplo renomeia um arquivo do nome my-file.txt para o nome my-file-renamed.txt.

az storage fs file move -p my-file.txt -f my-file-system --new-path my-file-system/my-file-renamed.txt --account-name mystorageaccount --auth-mode login

Excluir um arquivo

Exclua um arquivo usando o comando az storage fs file delete.

Este exemplo exclui um arquivo chamado my-file.txt.

az storage fs file delete -p my-directory/my-file.txt -f my-file-system --account-name mystorageaccount --auth-mode login

Confira também

• Amostras
• Fornecer feedback
• Problemas conhecidos
• Usar a CLI do Azure para gerenciar ACLs no Azure Data Lake Storage