Gerenciar diretórios e arquivos no Azure Data Lake Storage Gen2 com a CLI do Azure

  • Artigo

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.

Para saber mais sobre como obter, definir e atualizar as ACLs (listas de controle de acesso) de diretórios e arquivos, veja Usar a CLI do Azure para gerenciar ACLs no Azure Data Lake Storage Gen2.

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 precisa ter o namespace hierárquico habilitado. Siga estas instruções para criar um.

  • CLI do Azure versão 2.6.0 ou superior

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 comando, como Windows PowerShell.

  2. Verifique se a versão da CLI do Azure instalada é 2.6.0 ou superior usando o comando a seguir.

     az --version

    Se sua versão da CLI do Azure for inferior 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 puder abrir o navegador padrão, ela o fará e carregará uma página de entrada do 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, confira Autorizar acesso a dados de BLOB ou fila com a CLI do Azure.

  2. Se sua identidade estiver associada a mais de uma assinatura, defina sua assinatura ativa para a assinatura da conta de armazenamento que hospedará seu site estático.

    az account set --subscription <subscription-id>

    Substitua o valor de espaço reservado <subscription-id> pela ID da sua assinatura.

Observação

O exemplo apresentado neste artigo mostra a autorização do Microsoft Entra. Para saber mais sobre os métodos de autorização, confira Autorizar o acesso a dados de blob ou fila com a CLI do Azure.

Criar um contêiner

Um contêiner atua como um sistema de arquivos para os arquivos. Você pode criar 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

Obter propriedades de contêiner

Você pode imprimir as propriedades de um contêiner no console usando o comando az storage fs show.

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

Listar conteúdo do contêiner

Liste o conteúdo de um diretório usando o comando az storage fs file list.

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

Exclua um contêiner usando o comando az storage fs delete.

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

Crie uma referência de diretório usando o comando az storage fs directory create.

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

Obter propriedades do diretório

Você pode imprimir as propriedades de um diretório no console do 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

Exclui 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

Determine se um diretório específico existe 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

Liste o conteúdo de um diretório usando o comando az storage fs file list.

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

Mostrar propriedades do arquivo

Você pode imprimir as propriedades de um arquivo no console do 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