Criar um cluster do Azure Data Explorer e o banco de dados

O Azure Data Explorer é um serviço de análise de dados rápido e totalmente gerenciado para análise em tempo real de grandes volumes de streaming de dados de aplicativos, sites, dispositivos IoT e muito mais. Para usar o Azure Data Explorer, primeiro crie um cluster e um ou mais bancos de dados nesse cluster. Em seguida, você pode ingerir (carregar) dados em um banco de dados e executar consultas nele.

Neste artigo, você aprenderá a criar um cluster e um banco de dados usando C#, Python, Go, a CLI do Azure, o PowerShell ou um modelo do Azure Resource Manager (ARM). Para saber como criar um cluster e um banco de dados usando o portal do Azure, consulte Início Rápido: Criar um cluster e um banco de dados do Azure Data Explorer.

Para obter amostras de código baseadas em versões anteriores do SDK, consulte o artigo arquivado .

Pré-requisitos

Pré-requisitos por método de criação de cluster e banco de dados:

Criar um cluster do Azure Data Explorer

Esta seção orienta você no processo de criação de um cluster do Azure Data Explorer. Escolha a guia relevante para seu método preferido de criar o cluster.

  1. Crie o cluster usando o código a seguir:

    var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
    var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
    var clientSecret = "PlaceholderClientSecret"; //Client Secret
    var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
    var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
    var resourceManagementClient = new ArmClient(credentials, subscriptionId);
    var resourceGroupName = "testrg";
    var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
    var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value;
    var clusters = resourceGroup.GetKustoClusters();    
    var clusterName = "mykustocluster";
    var skuName = KustoSkuName.StandardE8adsV5;
    var skuTier = KustoSkuTier.Standard;
    var capacity = 5;
    var clusterData = new KustoClusterData(
        location: AzureLocation.CentralUS,
        sku: new KustoSku(skuName, skuTier) { Capacity = capacity }
    );
    await clusters.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, clusterData);
    
    Configuração Valor sugerido Descrição do campo
    clusterName mykustocluster O nome desejado do cluster.
    skuName Standard_E8ads_v5 O SKU que será usado para o cluster.
    nível Standard A camada da SKU.
    capacidade number O número de instâncias do cluster.
    resourceGroupName testrg O nome do grupo de recursos em que o cluster será criado.

    Observação

    Criar um cluster é uma operação de execução prolongada, portanto, é altamente recomendável usar CreateOrUpdateAsync, em vez de CreateOrUpdate.

  2. Execute o comando a seguir para verificar se o cluster foi criado com êxito:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Confirme a criação bem-sucedida do cluster verificando se o resultado contém provisioningState como Succeeded.

Criar um banco de dados do Azure Data Explorer

Nesta seção, você criará um banco de dados dentro do cluster criado na seção anterior.

  1. Crie o banco de dados usando o código a seguir:

    var cluster = (await clusters.GetAsync(clusterName)).Value;
    var databases = cluster.GetKustoDatabases();
    var databaseName = "mykustodatabase";
    var softDeletePeriod = TimeSpan.FromDays(3650);
    var hotCachePeriod = TimeSpan.FromDays(3650);
    var databaseData = new KustoReadWriteDatabase
    {
        Location = clusterData.Location, SoftDeletePeriod = softDeletePeriod, HotCachePeriod = hotCachePeriod
    };
    await databases.CreateOrUpdateAsync(WaitUntil.Completed, databaseName, databaseData);
    

    Observação

    Caso você esteja usando o C# versão 2.0.0 ou inferior, use o banco de dados em vez de ReadWriteDatabase.

    Configuração Valor sugerido Descrição do campo
    clusterName mykustocluster O nome do cluster em que o banco de dados será criado.
    databaseName mykustodatabase O nome do banco de dados.
    resourceGroupName testrg O nome do grupo de recursos em que o cluster será criado.
    softDeletePeriod 3650:00:00:00 O tempo durante o qual os dados serão mantidos disponíveis para consulta.
    hotCachePeriod 3650:00:00:00 O tempo durante o qual os dados serão mantidos no cache.
  2. Execute o seguinte comando para ver o banco de dados criado:

    databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
    

Próxima etapa