Operações de gerenciamento de conta no Armazenamento de Data Lake do Azure Gen1 usando o .NET SDK

  • Artigo

Neste artigo, você aprenderá a executar operações de gerenciamento de conta no Armazenamento de Dados do Azure Data Lake usando o .NET SDK. As operações de gerenciamento de conta incluem a criação de uma conta Gen1 do Data Lake Storage, listando as contas em uma assinatura do Azure, excluindo as contas etc.

Para obter instruções sobre como executar operações de gerenciamento de dados no Data Lake Storage Gen1 usando o .NET SDK, consulte Operações do sistema de arquivos no Data Lake Storage Gen1 usando o .NET SDK.

Pré-requisitos

Criar um aplicativo .NET

  1. No Visual Studio, selecione o menu Arquivo, Novo e Projeto.

  2. Selecione Aplicativo de Console (.NET Framework) e Avançar.

  3. Em Nome do projeto, digite CreateADLApplication e, em seguida, selecione Criar.

  4. Adicione os pacotes NuGet ao seu projeto.

    1. Clique com o botão direito do mouse no nome do projeto no Gerenciador de Soluções e clique em Gerenciar Pacotes NuGet.

    2. Na guia Gerenciador de Pacotes NuGet, verifique se a Origem do pacote está definida como nuget.org e se a caixa de seleção Incluir pré-lançamento está marcada.

    3. Procure e instale os seguintes pacotes NuGet:

      • Microsoft.Azure.Management.DataLake.Store - este tutorial usa a versão 2.1.3-preview.

      • Microsoft.Rest.ClientRuntime.Azure.Authentication - este tutorial usa a versão v2.2.12.

        Adicionar uma origem de NuGet

    4. Feche o Gerenciador de Pacotes NuGet.

  5. Abra Program.cs, exclua o código existente e inclua as instruções a seguir para adicionar referências aos namespaces.

    using System;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading;
using System.Collections.Generic;
using System.Security.Cryptography.X509Certificates; // Required only if you are using an Azure AD application created with certificates

using Microsoft.Rest;
using Microsoft.Rest.Azure.Authentication;
using Microsoft.Azure.Management.DataLake.Store;
using Microsoft.Azure.Management.DataLake.Store.Models;
using Microsoft.IdentityModel.Clients.ActiveDirectory;

  6. Declare as variáveis e forneça os valores para os espaços reservados. Além disso, verifique se o caminho local e o nome de arquivo fornecidos aqui existem no computador.

    namespace SdkSample
{
    class Program
    {
        private static DataLakeStoreAccountManagementClient _adlsClient;

        private static string _adlsAccountName;
        private static string _resourceGroupName;
        private static string _location;
        private static string _subId;

        private static void Main(string[] args)
        {
            _adlsAccountName = "<DATA-LAKE-STORAGE-GEN1-NAME>.azuredatalakestore.net"; 
            _resourceGroupName = "<RESOURCE-GROUP-NAME>"; 
            _location = "East US 2";
            _subId = "<SUBSCRIPTION-ID>";                    
        }
    }
}

Nas seções restantes do artigo, você pode ver como usar o métodos do .NET disponíveis para executar operações como autenticação, carregamento de arquivos, etc.

Autenticação

Criar objeto de cliente

O snippet a seguir cria o objeto cliente da conta Data Lake Storage Gen1, que é usado para emitir solicitações de gerenciamento de conta para o serviço, como criar conta, excluir conta etc.

// Create client objects and set the subscription ID
_adlsClient = new DataLakeStoreAccountManagementClient(armCreds) { SubscriptionId = _subId };

Criar uma conta do Data Lake Storage Gen1

O snippet a seguir cria uma conta do Data Lake Storage Gen1 na assinatura do Azure que você forneceu ao criar o objeto de cliente da conta do Data Lake Storage Gen1.

// Create Data Lake Storage Gen1 account
var adlsParameters = new DataLakeStoreAccount(location: _location);
_adlsClient.Account.Create(_resourceGroupName, _adlsAccountName, adlsParameters);

Listar todas as contas do Data Lake armazenamento Gen1 dentro de uma assinatura

Adicione o seguinte método à sua definição de classe. O snippet a seguir lista todas as contas do Data Lake Storage Gen1 em uma determinada assinatura do Azure.

// List all Data Lake Storage Gen1 accounts within the subscription
public static List<DataLakeStoreAccountBasic> ListAdlStoreAccounts()
{
    var response = _adlsClient.Account.List(_adlsAccountName);
    var accounts = new List<DataLakeStoreAccountBasic>(response);

    while (response.NextPageLink != null)
    {
        response = _adlsClient.Account.ListNext(response.NextPageLink);
        accounts.AddRange(response);
    }

    return accounts;
}

Excluir uma conta do Data Lake Storage Gen1

O snippet a seguir exclui a conta do Data Lake Storage Gen1 criada anteriormente.

// Delete Data Lake Storage Gen1 account
_adlsClient.Account.Delete(_resourceGroupName, _adlsAccountName);

Confira também

Próximas etapas