Operações de gestão de contas no Azure Data Lake Storage Gen1 com o SDK .NET

  • Artigo

Neste artigo, irá aprender a realizar operações de gestão de contas no Azure Data Lake Storage Gen1 com o SDK .NET. As operações de gestão de contas incluem criar uma conta Data Lake Storage Gen1, listar as contas numa subscrição do Azure, eliminar as contas, etc.

Para obter instruções sobre como realizar operações de gestão de dados em Data Lake Storage Gen1 com o SDK .NET, veja Operações do sistema de ficheiros em Data Lake Storage Gen1 com o SDK .NET.

Pré-requisitos

Criar uma aplicação .NET

  1. No Visual Studio, selecione o menu Ficheiro , Novo e, em seguida , Projeto.

  2. Selecione Aplicação de Consola (.NET Framework) e, em seguida, selecione Seguinte.

  3. Em Nome do projeto, introduza CreateADLApplicatione, em seguida, selecione Criar.

  4. Adicione os pacotes NuGet ao seu projeto.

    1. Clique com o botão direito do rato no nome do projeto no Explorador de Soluções e clique em Gerir Pacotes NuGet.

    2. No separador Gestor de Pacotes NuGet, certifique-se de que a Origem do pacote está definida como nuget.org e que a caixa de verificação Incluir pré-lançamento está selecionada.

    3. Procure e instale os seguintes pacotes NuGet:

      • Microsoft.Azure.Management.DataLake.Store - Este tutorial utiliza a v2.1.3-preview.

      • Microsoft.Rest.ClientRuntime.Azure.Authentication - Este tutorial utiliza a v2.2.12.

        Adicionar uma origem NuGet

    4. Feche o Gestor de Pacotes NuGet.

  5. Abra Program.cs, elimine o código existente e, em seguida, inclua as seguintes instruções para adicionar referências aos espaços de nomes.

    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 marcadores de posição. Além disso, certifique-se de que o caminho local e o nome de ficheiro fornecidos 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 restantes secções do artigo, pode ver como utilizar os métodos .NET disponíveis para executar operações, como a autenticação, carregamento de ficheiros, etc.

Autenticação

Criar o objeto de cliente

O fragmento seguinte cria o objeto de cliente de conta Data Lake Storage Gen1, que é utilizado para emitir pedidos de gestão de conta para o serviço, como criar conta, eliminar 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 fragmento seguinte cria uma conta Data Lake Storage Gen1 na subscrição do Azure que forneceu ao criar o objeto de cliente da conta 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 Data Lake Storage Gen1 numa subscrição

Adicione o método seguinte à definição da classe. O fragmento seguinte lista todas as contas Data Lake Storage Gen1 numa determinada subscrição 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;
}

Eliminar uma conta Data Lake Storage Gen1

O fragmento seguinte elimina a conta Data Lake Storage Gen1 que criou anteriormente.

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

Ver também

Passos seguintes