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

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 el Azure Portal, consulte Inicio rápido: Creación de un clúster y una base de datos de Azure Data Explorer.

Para obtener ejemplos de código basados en versiones anteriores del SDK, consulte el artículo archivado.

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 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);
    
    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.
    capacity número 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 clusters.GetAsync(clusterName)).Value.Data;
    
  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 dentro del clúster creado en la sección anterior.

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

    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);
    

    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 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 databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
    

Paso siguiente