Partilhar via

Gerenciar diretórios e arquivos no Armazenamento do Azure Data Lake por meio da CLI do Azure

  • Artigo

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

Para saber como obter, definir e atualizar as listas de controle de acesso (ACL) de diretórios e arquivos, consulte Usar a CLI do Azure para gerenciar ACLs no Armazenamento do Azure Data Lake.

Exemplos | Dar feedback

Pré-requisitos

  • Uma subscrição do Azure. Para obter mais informações, consulte Obter avaliação gratuita do Azure.

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

  • Versão da CLI 2.6.0 do Azure ou superior.

Verifique se você tem a versão correta da CLI do Azure instalada

  1. Abra o Azure Cloud Shell ou, se tiver instalado a CLI do Azure localmente, abra um aplicativo de console de comando, como o Windows PowerShell.

  2. Verifique se a versão da CLI do Azure que você instalou é 2.6.0 ou superior usando o comando a seguir.

     az --version

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

Conecte-se à conta

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

    az login

    Se a CLI puder abrir seu navegador padrão, ela fará isso e carregará uma página de entrada do Azure.

    Caso contrário, abra uma página do navegador e https://aka.ms/devicelogin insira o código de autorização exibido no seu terminal. Em seguida, inicie sessão com as credenciais da sua conta no browser.

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

  2. Se a sua identidade estiver associada a mais do que uma subscrição e não lhe for pedido para selecionar a subscrição, defina a sua subscrição ativa para a subscrição da conta de armazenamento em que pretende operar. Neste exemplo, substitua o valor do <subscription-id> espaço reservado pela ID da sua assinatura.

    az account set --subscription <subscription-id>

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

Nota

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

Criar um contentor

Um contêiner atua como um sistema de arquivos para seus 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

Mostrar propriedades do 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

Eliminar um contentor

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 nomeado 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

Mostrar propriedades do diretório

Você pode imprimir 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

Eliminar 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 existe um diretório

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

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

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

Download de um diretório

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

Este exemplo baixa um arquivo nomeado 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 my-file-system contêiner 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 ficheiro para um diretório

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

Este exemplo carrega um arquivo nomeado upload.txt para 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 ficheiro

Você pode imprimir 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

Eliminar um ficheiro

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

Consulte também