Delen via

Een Azure Data Explorer-cluster en -database maken

  • Artikel

Azure Data Explorer is een snelle, volledig beheerde service voor gegevensanalyses waarmee grote hoeveelheden gegevens van toepassingen, websites, IoT-apparaten en dergelijke in real-time kunnen worden geanalyseerd. Als u Azure Data Explorer wilt gebruiken, maakt u eerst een cluster. Daarna maakt u een of meer databases in het cluster. Vervolgens kunt u gegevens opnemen (laden) in een database en er query's op uitvoeren.

In dit artikel leert u hoe u een cluster en een database maakt met C#, Python, Go, De Azure CLI, PowerShell of een ARM-sjabloon (Azure Resource Manager). Zie de quickstart: Een Azure Data Explorer-cluster en -database maken voor meer informatie over het maken van een cluster en database met behulp van Azure Portal.

Vereisten

Vereisten op basis van de methode voor het maken van clusters en databases:

Een Azure Data Explorer-cluster maken

In deze sectie wordt u begeleid bij het maken van een Azure Data Explorer-cluster. Kies het relevante tabblad voor de gewenste methode om het cluster te maken.

  1. Maak uw cluster met behulp van de volgende code:

    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);
    Instelling Voorgestelde waarde Veldomschrijving
    clusterName mykustocluster De gewenste naam van uw cluster.
    skuName Standard_E8ads_v5 De SKU die wordt gebruikt voor uw cluster.
    tier Standaard De SKU-laag.
    capacity getal Het aantal exemplaren van het cluster.
    resourceGroupName testrg Naam van de resourcegroep waar het cluster wordt gemaakt.

    Notitie

    Een cluster maken is een langdurige bewerking, dus het wordt ten zeerste aanbevolen om CreateOrUpdateAsync te gebruiken in plaats van CreateOrUpdate.

  2. Voer de volgende opdracht uit om te controleren of het cluster is gemaakt:

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

  3. Bevestig dat het cluster is gemaakt door te controleren of het resultaat het bevat provisioningState als Succeeded.

Een Azure Data Explorer-database maken

In deze sectie maakt u een database in het cluster dat in de vorige sectie is gemaakt.

  1. Maak uw database met behulp van de volgende code:

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

    Notitie

    Als u C#-versie 2.0.0 of lager gebruikt, gebruikt u Database in plaats van ReadWriteDatabase.

    Instelling Voorgestelde waarde Veldomschrijving
    clusterName mykustocluster De naam van het cluster waar de database wordt gemaakt.
    databaseName mykustodatabase De naam van uw database.
    resourceGroupName testrg Naam van de resourcegroep waar het cluster wordt gemaakt.
    softDeletePeriod 3650:00:00:00 Hoe lang gegevens worden opgeslagen om query's erop te kunnen uitvoeren.
    hotCachePeriod 3650:00:00:00 Hoe lang gegevens worden opgeslagen in de cache.

  2. Voer de volgende opdracht uit om de database te bekijken die u hebt gemaakt:

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

Volgende stappen