Erstellen eines Azure Data Explorer-Clusters und einer Datenbank

  • Artikel

Azure Data Explorer ist ein schneller, vollständig verwalteter Datenanalysedienst für die Echtzeitanalyse großer Datenmengen, die von Anwendungen, Websites, IoT-Geräten usw. gestreamt werden. Um den Azure Data Explorer zu verwenden, erstellen Sie zuerst einen Cluster und anschließend eine oder mehrere Datenbanken in diesem Cluster. Anschließend können Sie Daten in eine Datenbank erfassen (laden) und Abfragen dafür ausführen.

In diesem Artikel erfahren Sie, wie Sie ein Cluster und eine Datenbank mit C#, Python, Go, Azure CLI, PowerShell oder einer ARM-Vorlage (Azure Resource Manager) erstellen. Informationen zum Erstellen eines Clusters und einer Datenbank mithilfe des Azure-Portals finden Sie in der Schnellstartanleitung: Erstellen eines Azure Data Explorer-Clusters und einer Datenbank.

Voraussetzungen

Voraussetzungen nach Methode der Cluster- und Datenbankerstellung:

Erstellen eines Azure Data Explorer-Clusters

Dieser Abschnitt führt Sie durch den Prozess der Erstellung eines Azure Data Explorer-Clusters. Wählen Sie die relevante Registerkarte für Ihre bevorzugte Methode aus, um das Cluster zu erstellen.

  1. Erstellen Sie Ihren Cluster mit dem folgenden 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);
    Einstellung Empfohlener Wert Feldbeschreibung
    clusterName mykustocluster Der gewünschte Name Ihres Clusters.
    skuName Standard_E8ads_v5 Die SKU, die für Ihren Cluster verwendet wird.
    Schicht Standard Die SKU-Ebene.
    Kapazität Zahl Die Anzahl der Instanzen des Clusters.
    resourceGroupName testrg Der Name der Ressourcengruppe, in der der Cluster erstellt werden soll

    Hinweis

    Das Erstellen eines Clusters ist ein zeitintensiver Vorgang. Daher wird dringend empfohlen, anstelle von CreateOrUpdate die Option CreateOrUpdateAsync zu verwenden.

  2. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihr Cluster erfolgreich erstellt wurde:

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

  3. Bestätigen Sie die erfolgreiche Erstellung des Clusters, indem Sie überprüfen, ob das Ergebnis provisioningState als Succeeded enthält.

Azure Data Explorer-Datenbank erstellen

In diesem Abschnitt erstellen Sie eine Datenbank innerhalb des im vorherigen Abschnitt erstellten Clusters.

  1. Erstellen Sie Ihre Datenbank mit dem folgenden 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);

    Hinweis

    Wenn Sie C#-Version 2.0.0 oder eine niedrigere Version nutzen, verwenden Sie „Database“ anstelle von „ReadWriteDatabase“.

    Einstellung Empfohlener Wert Feldbeschreibung
    clusterName mykustocluster Der Name Ihres Clusters, in dem die Datenbank erstellt werden soll.
    databaseName mykustodatabase Der Name Ihrer Datenbank.
    resourceGroupName testrg Der Name der Ressourcengruppe, in der der Cluster erstellt werden soll
    softDeletePeriod 3650:00:00:00 Der Zeitraum, für den Daten für Abfragen verfügbar sein sollen.
    hotCachePeriod 3650:00:00:00 Der Zeitraum, für den Daten im Cache verfügbar sein sollen.

  2. Führen Sie den folgenden Befehl aus, um die erstellte Datenbank anzuzeigen:

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

Nächste Schritte