Erstellen eines Azure Data Explorer-Clusters und einer Datenbank
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 eine Datenbank erfassen (laden) und Abfragen dafür ausführen.
In diesem Artikel erfahren Sie, wie Sie einen Cluster und eine Datenbank 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 des Azure-Portal finden Sie unter Schnellstart: Erstellen eines Azure Data Explorer-Clusters und einer Datenbank.
Codebeispiele, die auf früheren SDK-Versionen basieren, finden Sie im archivierten Artikel.
Voraussetzungen
Voraussetzungen nach Methode der Cluster- und Datenbankerstellung:
- Ein Azure-Abonnement. Erstellen Sie ein kostenloses Azure-Konto.
- Visual Studio 2022 Community Edition. Aktivieren Sie die Azure-Entwicklung während des Visual Studio-Setups.
- Installieren Sie das NuGet-Paket Microsoft.Azure.Management.Kusto.
- Eine Microsoft Entra Anwendung und Dienstprinzipal, die auf Ressourcen zugreifen können. Speichern Sie die Verzeichnis- (Mandanten-)ID, die Anwendungs-ID und den geheimen Clientschlüssel.
Erstellen eines Azure Data Explorer-Clusters
In diesem Abschnitt erfahren Sie, wie Sie einen Azure Data Explorer-Cluster erstellen. Wählen Sie die relevante Registerkarte für Ihre bevorzugte Methode aus, um den Cluster zu erstellen.
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 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);
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.
Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihr Cluster erfolgreich erstellt wurde:
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
Bestätigen Sie die erfolgreiche Erstellung des Clusters, indem Sie überprüfen, ob das Ergebnis enthält
provisioningState
alsSucceeded
enthält.
Erstellen einer Azure Data Explorer-Datenbank
In diesem Abschnitt erstellen Sie eine Datenbank innerhalb des Clusters, der im vorherigen Abschnitt erstellt wurde.
Erstellen Sie Ihre Datenbank mit dem folgenden Code:
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);
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. Führen Sie den folgenden Befehl aus, um die erstellte Datenbank anzuzeigen:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
Nächster Schritt
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für