Erstellen eines Azure Data Explorer-Clusters und einer Datenbank

  • Artikel

Azure Data Explorer ist ein schneller, vollständig verwalteter Datenanalysedienst für Echtzeitanalysen 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 einer Datenbank erfassen (laden) und Abfragen dafür ausführen.

In diesem Artikel erfahren Sie, wie Sie einen Cluster und eine Datenbank entweder mit C#, Python, Go, der Azure CLI, PowerShell oder einer Arm-Vorlage (Azure Resource Manager) erstellen. Informationen zum Erstellen eines Clusters und einer Datenbank mithilfe der Azure-Portal finden Sie unter Schnellstart: Erstellen eines Azure Data Explorer-Clusters und einer Datenbank.

Voraussetzungen

Voraussetzungen nach Methode der Cluster- und Datenbankerstellung:

Erstellen eines Azure Data Explorer-Clusters

In diesem Abschnitt werden Sie durch den Prozess zum Erstellen eines Azure Data Explorer-Clusters geleitet. Wählen Sie die relevante Registerkarte für Ihre bevorzugte Methode aus, um den 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.
    Ebene 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 als SucceededenthältprovisioningState.

Erstellen einer Azure Data Explorer-Datenbank

In diesem Abschnitt erstellen Sie eine Datenbank innerhalb des Clusters, der im vorherigen Abschnitt erstellt wurde.

  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