Creare un database e un cluster di Esplora dati di Azure
Esplora dati di Azure: servizio di analisi dei dati veloce e completamente gestito per l'analisi in tempo reale di volumi elevati di flussi di dati provenienti da applicazioni, siti Web, dispositivi IoT e altro ancora. Per usare Esplora dati di Azure, è necessario prima creare un cluster e quindi uno o più database al suo interno. È quindi possibile inserire (caricare) dati in un database ed eseguire query su di esso.
Questo articolo illustra come creare un cluster e un database usando C#, Python, Go, l'interfaccia della riga di comando di Azure, PowerShell o un modello di Azure Resource Manager (ARM). Per informazioni su come creare un cluster e un database usando il portale di Azure, vedere Avvio rapido: Creare un cluster e un database di Azure Esplora dati.
Per esempi di codice basati sulle versioni precedenti dell'SDK, vedere l'articolo archiviato.
Prerequisiti
Prerequisiti per metodo di creazione di cluster e database:
- Una sottoscrizione di Azure. Creare un account Azure gratuito.
- Visual Studio 2022 Community Edition. Attivare lo sviluppo di Azure durante la configurazione di Visual Studio.
- Installare il pacchetto Microsoft.Azure.Management.Kusto NuGet.
- Un'applicazione Microsoft Entra e un'entità servizio che possono accedere alle risorse. Salvare l'ID directory (tenant), l'ID applicazione e il segreto client.
Creare un cluster Esplora dati di Azure
Questa sezione illustra il processo di creazione di un cluster Esplora dati di Azure. Scegliere la scheda pertinente per il metodo preferito per creare il cluster.
Creare il cluster usando il codice seguente:
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);
Impostazione Valore consigliato Descrizione campo clusterName mykustocluster Nome del cluster. skuName Standard_E8ads_v5 SKU usato per il cluster. livello Standard Livello SKU. capacità number Numero di istanze del cluster. resourceGroupName testrg Il nome del gruppo di risorse in cui verrà creato il cluster. Nota
Creare un cluster è un'operazione a esecuzione prolungata, pertanto è consigliabile usare CreateOrUpdateAsync anziché CreateOrUpdate.
Per verificare se il cluster è stato creato correttamente, eseguire il comando seguente:
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
Verificare la corretta creazione del cluster verificando che il risultato contenga
provisioningState
comeSucceeded
.
Creare un database Esplora dati di Azure
In questa sezione verrà creato un database all'interno del cluster creato nella sezione precedente.
Creare il database usando il codice seguente:
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);
Nota
Se si usa C# versione 2.0.0 o successiva, usare Database anziché ReadWriteDatabase.
Impostazione Valore consigliato Descrizione campo clusterName mykustocluster Nome del cluster in cui verrà creato il database. databaseName mykustodatabase Il nome del database. resourceGroupName testrg Il nome del gruppo di risorse in cui verrà creato il cluster. softDeletePeriod 3650:00:00:00 Periodo di tempo in cui i dati verranno mantenuti disponibili in modo che sia possibile eseguire una query. hotCachePeriod 3650:00:00:00 Periodo di tempo in cui i dati verranno conservati nella cache. Eseguire il comando seguente per vedere il database creato:
databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;