Gerir diretórios e ficheiros 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 em 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 usam autorização Microsoft Entra (--auth-mode login).

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 2.6.0 da CLI do Azure ou posterior.

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

  1. Abra o Azure Cloud Shell ou, se instalou o CLI do Azure localmente, abra uma aplicação de consola 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 a sua versão do CLI do Azure for anterior a 2.6.0, instale uma versão mais recente. Para obter mais informações, consulte Instalar a CLI do Azure.

Inicie sessão na conta

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

    az login

    Se a CLI conseguir abrir o seu navegador predefinido, abre o navegador e carrega uma página de início de sessão no Azure.

    Caso contrário, abra uma página no navegador em https://aka.ms/devicelogin e introduza o código de autorização apresentado no 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 blobs ou filas com o CLI do Azure.

  2. Se a sua identidade estiver associada a mais do que uma subscrição e não for solicitado a 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 marcador de posição <subscription-id> pelo ID da sua subscrição.

    az account set --subscription <subscription-id>

    Substitua o valor do marcador de posição <subscription-id> pelo ID da sua subscrição.

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 blobs ou filas com a CLI do Azure.

Criar um contentor

Um contêiner atua como um sistema de arquivos para seus arquivos. Crie um utilizando 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 contentor existe, execute o comando az storage fs show .

Mostrar propriedades do contêiner

Usa o comando az storage fs show para imprimir as propriedades de um contentor na consola.

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

Listar conteúdo do contêiner

Usa o comando de lista de ficheiros fs do az storage para listar o conteúdo de um contentor.

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

Usa o comando fs delete do az storage para eliminar um contentor.

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 para um diretório.

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

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

Mostrar propriedades do diretório

Imprima as propriedades de um diretório na consola 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 contentor, utilizando 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

Usa o comando de lista de ficheiros 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 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

Para verificar se o ficheiro foi carregado, execute o comando de lista de ficheiros do az storage fs .

Mostrar propriedades do ficheiro

Imprima as propriedades de um ficheiro na consola utilizando 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 elimina um ficheiro 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

  • Last updated on