Compartir a través de

Creación de un clúster y de la base de datos de Azure Data Explorer

  • Artículo

Azure Data Explorer es un servicio de análisis de datos rápido y totalmente administrado para analizar en tiempo real grandes volúmenes de datos de que se transmiten desde aplicaciones, sitios web, dispositivos IoT, etc. Para usar Azure Data Explorer, cree primero un clúster y una o varias bases de datos en ese clúster. A continuación, puede ingerir (cargar) datos en una base de datos y ejecutar consultas en ella.

En este artículo, aprenderá a crear un clúster y una base de datos mediante C#, Python, Go, la CLI de Azure, PowerShell o una plantilla de Azure Resource Manager (ARM). Para aprender a crear un clúster y una base de datos mediante Azure Portal, consulte Inicio rápido: Creación de un clúster y una base de datos de Azure Data Explorer.

Requisitos previos

Requisitos previos por método de creación de clústeres y bases de datos:

Creación de un clúster de Azure Data Explorer

Esta sección le guía por el proceso de creación de un clúster de Azure Data Explorer. Elija la pestaña correspondiente para el método preferido para crear el clúster.

  1. Cree el clúster mediante el siguiente código:

    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 authClient = ConfidentialClientApplicationBuilder.Create(clientId)
    .WithAuthority($"https://login.microsoftonline.com/{tenantId}")
    .WithClientSecret(clientSecret)
    .Build();
var result = authClient.AcquireTokenForClient(new[] { "https://management.core.windows.net/" }).ExecuteAsync().Result;
var credentials = new TokenCredentials(result.AccessToken, result.TokenType);
var kustoManagementClient = new KustoManagementClient(credentials) { SubscriptionId = subscriptionId };
var resourceGroupName = "testrg";
var clusterName = "mykustocluster";
var skuName = KustoSkuName.StandardE8adsV5;
var skuTier = KustoSkuTier.Standard;
var capacity = 5;
var clusterData = new Cluster(
    location: "Central US",
    sku: new AzureSku(skuName, skuTier, capacity)
);
await kustoManagementClient.Clusters.CreateOrUpdateAsync(resourceGroupName, clusterName, clusterData);
    Configuración Valor sugerido Descripción del campo
    clusterName mykustocluster Nombre que quiere para el clúster.
    skuName Standard_E8ads_v5 La SKU que se usará para el clúster.
    nivel Estándar Nivel de SKU.
    capacidad number Número de instancias del clúster.
    resourceGroupName testrg Nombre del grupo de recursos en el que se creará el clúster.

    Nota:

    La creación de un clúster es una operación de larga duración, por lo que se recomienda encarecidamente utilizar CreateOrUpdateAsync en lugar de CreateOrUpdate.

  2. Ejecute el siguiente comando para comprobar si el clúster se creó correctamente:

    clusterData = await kustoManagementClient.Clusters.GetAsync(resourceGroupName, clusterName);

  3. Confirme la creación correcta del clúster comprobando que el resultado contiene provisioningState como Succeeded.

Creación de una base de datos de Azure Data Explorer

En esta sección, creará una base de datos en el clúster creado en la sección anterior.

  1. Cree la base de datos mediante el siguiente código:

    var databaseName = "mykustodatabase";
var softDeletePeriod = TimeSpan.FromDays(3650);
var hotCachePeriod = TimeSpan.FromDays(3650);
var databaseData = new ReadWriteDatabase(
    location: clusterData.Location, softDeletePeriod: softDeletePeriod, hotCachePeriod: hotCachePeriod
);
await kustoManagementClient.Databases.CreateOrUpdateAsync(resourceGroupName, clusterName, databaseName, databaseData);

    Nota:

    Si usa la versión 2.0.0 de C#, o cualquier versión inferior, use Database en lugar de ReadWriteDatabase.

    Configuración Valor sugerido Descripción del campo
    clusterName mykustocluster Nombre del clúster donde se creará la base de datos.
    databaseName mykustodatabase El nombre de la base de datos.
    resourceGroupName testrg Nombre del grupo de recursos en el que se creará el clúster.
    softDeletePeriod 3650:00:00:00 Cantidad de tiempo que los datos estarán disponibles para consulta.
    hotCachePeriod 3650:00:00:00 Cantidad de tiempo que los datos se conservarán en la caché.

  2. Ejecute el siguiente comando para ver la base de datos que ha creado:

    databaseData = await kustoManagementClient.Databases.GetAsync(resourceGroupName, clusterName, databaseName) as ReadWriteDatabase;

Pasos siguientes