Partager via


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.

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 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);
    
    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 kustoManagementClient.Clusters.GetAsync(resourceGroupName, clusterName);
    
  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 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);
    

    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 kustoManagementClient.Databases.GetAsync(resourceGroupName, clusterName, databaseName) as ReadWriteDatabase;
    

Étapes suivantes