Introdução ao Azure Data Lake Storage Gen1 com Azure PowerShell

Nota

Azure Data Lake Storage Gen1 foi descontinuada. Veja o anúncio de descontinuação aqui. Data Lake Storage Gen1 recursos já não estão acessíveis. Se precisar de assistência especial, contacte-nos.

Saiba como utilizar Azure PowerShell para criar uma conta Azure Data Lake Storage Gen1 e realizar operações básicas, como criar pastas, carregar e transferir ficheiros de dados, eliminar a sua conta, etc. Para obter mais informações sobre Data Lake Storage Gen1, consulte Descrição geral do Data Lake Storage Gen1.

Pré-requisitos

Nota

Recomendamos que utilize o módulo do Azure Az PowerShell para interagir com o Azure. Veja Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.

Autenticação

Este artigo utiliza uma abordagem de autenticação mais simples com Data Lake Storage Gen1 em que lhe é pedido que introduza as credenciais da sua conta do Azure. O nível de acesso para Data Lake Storage Gen1 conta e sistema de ficheiros é então regido pelo nível de acesso do utilizador com sessão iniciada. No entanto, existem outras abordagens para autenticar com Data Lake Storage Gen1, que são autenticação do utilizador final ou autenticação serviço a serviço. Para obter instruções e obter mais informações sobre como autenticar, veja End-user authentication (Autenticação de utilizador final) ou Service-to-service authentication (Autenticação de serviço a serviço).

Criar uma conta do Data Lake Storage Gen1

  1. No ambiente de trabalho, abra uma nova janela do Windows PowerShell. Introduza o fragmento seguinte para iniciar sessão na sua conta do Azure, definir a subscrição e registar o fornecedor de Data Lake Storage Gen1. Quando lhe for pedido para iniciar sessão, certifique-se de que inicia sessão como um dos administradores/proprietário da subscrição:

    # Log in to your Azure account
    Connect-AzAccount
    
    # List all the subscriptions associated to your account
    Get-AzSubscription
    
    # Select a subscription
    Set-AzContext -SubscriptionId <subscription ID>
    
    # Register for Azure Data Lake Storage Gen1
    Register-AzResourceProvider -ProviderNamespace "Microsoft.DataLakeStore"
    
  2. Uma conta Data Lake Storage Gen1 está associada a um grupo de recursos do Azure. Comece por criar um grupo de recursos.

    $resourceGroupName = "<your new resource group name>"
    New-AzResourceGroup -Name $resourceGroupName -Location "East US 2"
    

    Criar um Grupo de Recursos do Azure

  3. Criar uma conta Data Lake Storage Gen1. O nome que especificar só pode conter minúsculas e números.

    $dataLakeStorageGen1Name = "<your new Data Lake Storage Gen1 account name>"
    New-AzDataLakeStoreAccount -ResourceGroupName $resourceGroupName -Name $dataLakeStorageGen1Name -Location "East US 2"
    

    Criar uma conta Data Lake Storage Gen1

  4. Certifique-se de que a conta foi criada com êxito.

    Test-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name
    

    O resultado do cmdlet deve ser Verdadeiro.

Criar estruturas de diretórios

Pode criar diretórios na sua conta Data Lake Storage Gen1 para gerir e armazenar dados.

  1. Especifique um diretório de raiz.

    $myrootdir = "/"
    
  2. Crie um novo diretório denominado mynewdirectory na raiz especificada.

    New-AzDataLakeStoreItem -Folder -AccountName $dataLakeStorageGen1Name -Path $myrootdir/mynewdirectory
    
  3. Certifique-se de que o novo diretório foi criado com êxito.

    Get-AzDataLakeStoreChildItem -AccountName $dataLakeStorageGen1Name -Path $myrootdir
    

    Deve ser apresentado como uma saída, conforme mostrado na captura de ecrã seguinte:

    Verificar Diretório

Carregar dados

Pode carregar os dados para Data Lake Storage Gen1 diretamente ao nível da raiz ou para um diretório que criou na conta. Os fragmentos nesta secção demonstram como carregar alguns dados de exemplo para o diretório (mynewdirectory) que criou na secção anterior.

Se estiver à procura de alguns dados de exemplo para carregar, pode obter a pasta Ambulance Data a partir do Repositório de Git do Azure Data Lake. Transfira o ficheiro e armazene-o num diretório local no seu computador, como C:\sampledata.

Import-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
   -Path "C:\sampledata\vehicle1_09142014.csv" `
   -Destination $myrootdir\mynewdirectory\vehicle1_09142014.csv

Mudar o nome, transferir e eliminar dados

Para mudar o nome de um ficheiro, utilize o seguinte comando:

Move-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Path $myrootdir\mynewdirectory\vehicle1_09142014.csv `
    -Destination $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv

Para transferir um ficheiro, utilize o seguinte comando:

Export-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Path $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv `
    -Destination "C:\sampledata\vehicle1_09142014_Copy.csv"

Para eliminar um ficheiro, utilize o seguinte comando:

Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Paths $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv

Quando lhe for pedido, introduza S para eliminar o item. Se tiver mais de um ficheiro a eliminar, pode fornecer todos os caminhos separados por vírgula.

Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Paths $myrootdir\mynewdirectory\vehicle1_09142014.csv, $myrootdir\mynewdirectoryvehicle1_09142014_Copy.csv

Eliminar a sua conta

Utilize o seguinte comando para eliminar a sua conta Data Lake Storage Gen1.

Remove-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name

Quando lhe for pedido, introduza S para eliminar a conta.

Passos seguintes