Compartilhar via


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

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

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

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 fonte do NuGet

    4. Feche o Gerenciador NuGet de Pacotes.

  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 espaços reservados. Além disso, verifique se o caminho local e o nome do arquivo que você fornece 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 os métodos .NET disponíveis para executar operações como autenticação, upload de arquivo etc.

Autenticação

Criar objeto cliente

O snippet a seguir cria o objeto de cliente da conta do 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 fornecida durante a criação do objeto 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 Storage Gen1 em uma assinatura

Adicione o método a seguir à 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);

Consulte também

Próximas etapas