Creare un database e un cluster di Esplora dati di Azure tramite PowerShellCreate an Azure Data Explorer cluster and database by using PowerShell

Esplora dati di Azure è un servizio di analisi dei dati veloce e completamente gestito per l'analisi in tempo reale di volumi elevati di dati in streaming provenienti da applicazioni, siti Web, dispositivi IoT e altro ancora.Azure Data Explorer is a fast, fully managed data analytics service for real-time analysis on large volumes of data streaming from applications, websites, IoT devices, and more. Per usare Esplora dati di Azure, è necessario prima creare un cluster e quindi uno o più database al suo interno.To use Azure Data Explorer, you first create a cluster, and create one or more databases in that cluster. Quindi si inseriscono (caricano) i dati in un database per poter eseguire query.Then you ingest (load) data into a database so that you can run queries against it. In questo articolo vengono creati un cluster e un database usando PowerShell.In this article, you create a cluster and a database by using Powershell. È possibile eseguire i cmdlet e gli script di PowerShell in Windows, Linux o Azure Cloud Shell con Az.Kusto per creare e configurare cluster e database di Esplora dati di Azure.You can run PowerShell cmdlets and scripts on Windows, Linux, or in Azure Cloud Shell with Az.Kusto to create and configure Azure Data Explorer clusters and databases.

PrerequisitiPrerequisites

Nota

Questo articolo è stato aggiornato per usare il nuovo modulo Az di Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. È comunque possibile usare il modulo AzureRM, che continuerà a ricevere correzioni di bug almeno fino a dicembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Per altre informazioni sul nuovo modulo Az e sulla compatibilità di AzureRM, vedere Introduzione del nuovo modulo Az di Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Per istruzioni sull'installazione del modulo Az, vedere Installare Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Usare Azure Cloud ShellUse Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Per avviare Azure Cloud Shell:To start Azure Cloud Shell:

OpzioneOption Esempio/CollegamentoExample/Link
Selezionare Prova nell'angolo superiore destro di un blocco di codice.Select Try It in the upper-right corner of a code block. La selezione di Prova non comporta la copia automatica del codice in Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Esempio di Prova per Azure Cloud Shell
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Avviare Cloud Shell in una nuova finestraLaunch Cloud Shell in a new window
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Pulsante Cloud Shell nel portale di Azure

Per eseguire il codice di questo articolo in Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Avviare Cloud Shell.Start Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice per copiare il codice.Select the Copy button on a code block to copy the code.

  3. Incollare il codice nella sessione di Cloud Shell premendo CTRL+MAIUSC+V in Windows e Linux o CMD+MAIUSC+V in macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Premere INVIO per eseguire il codice.Select Enter to run the code.

Se si sceglie di installare e usare l'interfaccia della riga di comando di Azure localmente, questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.0.4 o successiva.If you choose to install and use the Azure CLI locally, this article requires the Azure CLI version 2.0.4 or later. Eseguire az --version per controllare la versione.Run az --version to check your version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.If you need to install or upgrade, see Install the Azure CLI.

Configurare i parametriConfigure parameters

I passaggi seguenti non sono necessari se si eseguono i comandi in Azure Cloud Shell.The following steps are not required if you're running commands in Azure Cloud Shell. Se si esegue l'interfaccia della riga di comando in locale, seguire i passaggi 1 e 2 per accedere ad Azure e impostare la sottoscrizione corrente:If you're running the CLI locally, follow steps 1 & 2 to sign in to Azure and to set your current subscription:

  1. Eseguire questo comando per accedere ad Azure:Run the following command to sign in to Azure:

    Connect-AzAccount
    
  2. Impostare la sottoscrizione in cui si vuole creare il cluster:Set the subscription where you want your cluster to be created:

     Set-AzContext -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    
  3. Quando si esegue l'interfaccia della riga di comando di Azure in locale o in Azure Cloud Shell, è necessario installare il modulo Az.Kusto nel proprio dispositivo:When running Azure CLI locally or in the Azure Cloud Shell, you need to install the Az.Kusto module on your device:

     Install-Module -Name Az.Kusto
    

Creare il cluster di Esplora dati di AzureCreate the Azure Data Explorer cluster

  1. Creare il cluster tramite il comando seguente:Create your cluster by using the following command:

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location 'Central US' -Sku D13_v2 -Capacity 10
    
    ImpostazioneSetting Valore consigliatoSuggested value Descrizione campoField description
    NomeName mykustoclustermykustocluster Nome del cluster.The desired name of your cluster.
    SkuSku D13_v2D13_v2 SKU usato per il cluster.The SKU that will be used for your cluster.
    ResourceGroupNameResourceGroupName testrgtestrg Il nome del gruppo di risorse in cui verrà creato il cluster.The resource group name where the cluster will be created.

    Sono disponibili altri parametri facoltativi che è possibile usare, ad esempio la capacità del cluster.There are additional optional parameters that you can use, such as the capacity of the cluster.

  2. Per verificare se il cluster è stato creato correttamente, eseguire il comando seguente:Run the following command to check whether your cluster was successfully created:

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
    

Se il risultato contiene provisioningState con il valore Succeeded, il cluster è stato creato correttamente.If the result contains provisioningState with the Succeeded value, then the cluster was successfully created.

Creare il database nel cluster di Esplora dati di AzureCreate the database in the Azure Data Explorer cluster

  1. Creare il database tramite il comando seguente:Create your database by using the following command:

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    
    ImpostazioneSetting Valore consigliatoSuggested value Descrizione campoField description
    ClusterNameClusterName mykustoclustermykustocluster Nome del cluster in cui verrà creato il database.The name of your cluster where the database will be created.
    NomeName mykustodatabasemykustodatabase Nome del database.The name of your database.
    ResourceGroupNameResourceGroupName testrgtestrg Il nome del gruppo di risorse in cui verrà creato il cluster.The resource group name where the cluster will be created.
    SoftDeletePeriodSoftDeletePeriod 3650:00:00:003650:00:00:00 Periodo di tempo in cui i dati verranno mantenuti disponibili in modo che sia possibile eseguire una query.The amount of time that data will be kept available to query.
    HotCachePeriodHotCachePeriod 3650:00:00:003650:00:00:00 Periodo di tempo in cui i dati verranno conservati nella cache.The amount of time that data will be kept in cache.
  2. Eseguire il comando seguente per vedere il database creato:Run the following command to see the database that you created:

    Get-AzKustoDatabase -ClusterName mykustocluster -ResourceGroupName testrg -Name mykustodatabase
    

A questo punto sono disponibili un cluster e un database.You now have a cluster and a database.

Pulizia delle risorseClean up resources

  • Se si prevede di seguire gli altri articoli, è necessario salvare le risorse create.If you plan to follow our other articles, keep the resources you created.

  • Per pulire le risorse, eliminare il cluster.To clean up resources, delete the cluster. Quando si elimina un cluster, vengono eliminati anche tutti i database al suo interno.When you delete a cluster, it also deletes all the databases in it. Usare il comando seguente per eliminare il cluster:Use the following command to delete your cluster:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster
    

Passaggi successiviNext steps