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:

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.

  1. 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.

  2. Per verificare se il cluster è stato creato correttamente, eseguire il comando seguente:

    clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
    
  3. Verificare la corretta creazione del cluster verificando che il risultato contenga provisioningState come Succeeded.

Creare un database Esplora dati di Azure

In questa sezione verrà creato un database all'interno del cluster creato nella sezione precedente.

  1. 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.
  2. Eseguire il comando seguente per vedere il database creato:

    databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;
    

Passaggio successivo