Créer un cluster et une base de données Azure Data Explorer

Azure Data Explorer est un service d’analytique données rapide et complètement managé permettant une analyse en temps réel de gros volumes de données diffusées en continu par des applications, des sites web, des appareils IoT, etc. Pour utiliser Azure Data Explorer, créez tout d’abord un cluster et une ou plusieurs bases de données dans ce cluster. Ensuite, vous pouvez ingérer (charger) des données dans une base de données et exécuter des requêtes dessus.

Dans cet article, vous allez apprendre à créer un cluster et une base de données à l’aide de C#, Python, Go, l’interface Azure CLI, PowerShell ou d’un modèle Azure Resource Manager (ARM). Pour savoir comment créer un cluster et une base de données à l’aide du portail Azure, consultez Démarrage rapide : Créer un cluster et une base de données Azure Data Explorer.

Pour obtenir des exemples de code basés sur les versions précédentes du SDK, consultez l’article archivé.

Prérequis

Prérequis par méthode de création de cluster et de base de données :

Créez un cluster Azure Data Explorer.

Cette section vous guide tout au long du processus de création d’un cluster Azure Data Explorer. Choisissez l’onglet correspondant à votre méthode préférée pour créer le cluster.

  1. Créez votre cluster en utilisant le code suivant :

    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);
    
    Paramètre Valeur suggérée Description du champ
    clusterName mykustocluster Nom souhaité de votre cluster.
    skuName Standard_E8ads_v5 Référence SKU utilisée pour votre cluster.
    tier Standard Niveau de référence SKU.
    capacité numéro Nombre d’instances du cluster.
    resourceGroupName testrg Nom du groupe de ressources dans lequel sera créé le cluster.

    Remarque

    Créer un cluster étant une opération à long terme, il est fortement recommandé d’utiliser CreateOrUpdateAsync à la place de CreateOrUpdate.

  2. Exécutez la commande suivante pour vérifier si votre cluster a bien été créé :

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Confirmez la création réussie du cluster en vérifiant que le résultat contient provisioningState comme Succeeded.

Créer une base de données Azure Data Explorer

Dans cette section, vous allez créer une base de données dans le cluster créé dans la section précédente.

  1. Créez votre base de données en utilisant le code suivant :

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

    Remarque

    Si vous utilisez C# version 2.0.0 ou antérieure, utilisez Database au lieu de ReadWriteDatabase.

    Paramètre Valeur suggérée Description du champ
    clusterName mykustocluster Nom du cluster dans lequel la base de données est créée.
    databaseName mykustodatabase Nom de votre base de données.
    resourceGroupName testrg Nom du groupe de ressources dans lequel sera créé le cluster.
    softDeletePeriod 3650:00:00:00 Durée pendant laquelle les données restent disponibles pour les requêtes.
    hotCachePeriod 3650:00:00:00 Durée pendant laquelle les données sont conservées dans le cache.
  2. Exécutez la commande suivante pour voir la base de données que vous avez créée :

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

Étape suivante