Visualizza i dati da Esplora dati di Azure in DashVisualize data from Azure Data Explorer in Redash

Il Ritrattino connette ed esegue query sulle origini dati, compila i dashboard per visualizzare i dati e condividerli con i peer.Redash connects and queries your data sources, builds dashboards to visualize data and share them with peers. Questo articolo illustra come configurare Esplora dati di Azure come origine dati per il Ritrattino e quindi visualizzare i dati.In this article, you learn how to set up Azure Data Explorer as a data source for Redash, and then visualize data.

PrerequisitiPrerequisites

  1. Creare un cluster e un database.Create cluster and database.
  2. Inserire i dati come illustrato in inserire i dati di esempio in Esplora dati di Azure.Ingest data as explained in ingest sample data into Azure Data Explorer. Per altre opzioni di inserimento, vedere Cenni preliminari sull'inserimento.For more ingestion options, see ingestion overview.

Configurare l'origine datiConfigure the data source

Eseguire la procedura seguente per configurare Azure Data Explorer come origine dati per lo strumento dashboard.You perform the following steps to configure Azure Data Explorer as a data source for your dashboard tool. In questa sezione verranno illustrati in dettaglio questi passaggi:We'll cover these steps in more detail in this section:

  1. Creare un'entità servizio di Azure Active Directory (Azure AD).Create an Azure Active Directory (Azure AD) service principal. L'entità servizio viene usata dallo strumento dashboard per accedere al servizio Azure Data Explorer.The service principal is used by your dashboard tool to access the Azure Data Explorer service.The service principal is used by your dashboard tool to access the Azure Data Explorer service.

  2. Aggiungere l'entità servizio di Azure AD al ruolo di visualizzatori nel database di Esplora dati di Azure.Add the Azure AD service principal to the viewers role in the Azure Data Explorer database.

  3. Specificare le proprietà di connessione dello strumento dashboard in base alle informazioni dell'entità servizio di Azure AD, quindi testare la connessione.Specify your dashboard tool connection properties based on information from the Azure AD service principal, then test the connection.

Creare un'entità servizioCreate a service principal

È possibile creare l'entità servizio nel portale di Azure o tramite l'interfaccia della riga di comando di Azure.You can create the service principal in the Azure portal or using the Azure CLI command-line experience. Indipendentemente dal metodo usato, dopo la creazione si ottengono i valori per quattro proprietà di connessione da usare nei passaggi successivi.Regardless of which method you use, after creation you get values for four connection properties that you'll use in later steps.

Portale di AzureAzure portal

  1. Per creare l'entità servizio, seguire le istruzioni riportate nella documentazione del portale di Azure.To create the service principal, follow the instructions in the Azure portal documentation.

    1. Nella sezione Assegnare l'applicazione a un ruolo assegnare il tipo di ruolo di Lettore al cluster di Esplora dati di Azure.In the Assign the application to a role section, assign a role type of Reader to your Azure Data Explorer cluster.

    2. Nella sezione Ottieni valori per l'accesso copiare i tre valori di proprietà illustrati nei passaggi: ID directory (ID tenant), ID applicazionee Password.In the Get values for signing in section, copy the three property values covered in the steps: Directory ID (tenant ID), Application ID, and Password.

  2. Nel portale di Azure selezionare Sottoscrizioni e quindi copiare l'ID della sottoscrizione in cui è stata creata l'entità servizio.In the Azure portal, select Subscriptions then copy the ID for the subscription in which you created the service principal.

    ID sottoscrizione - Portale

Interfaccia della riga di comando di AzureAzure CLI

  1. Creare un'entità servizio.Create a service principal. Impostare un ambito appropriato e il tipo di ruolo di reader.Set an appropriate scope and a role type of reader.

    az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                             --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
    

    Per altre informazioni, vedere Creare un'entità servizio di Azure con l'interfaccia della riga di comando di Azure.For more information, see Create an Azure service principal with Azure CLI.

  2. Il comando restituisce un set di risultati simile al seguente.The command returns a result set like the following. Copiare i valori delle tre proprietà: appID, password e tenant.Copy the three property values: appID, password, and tenant.

    {
      "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "displayName": "{UrlToYourDashboard}:{PortNumber}",
      "name": "https://{UrlToYourDashboard}:{PortNumber}",
      "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
      "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
    
  3. Ottenere un elenco delle sottoscrizioni.Get a list of your subscriptions.

    az account list --output table
    

    Copiare l'ID sottoscrizione appropriato.Copy the appropriate subscription ID.

    ID sottoscrizione - Interfaccia della riga di comando

Aggiungere l'entità servizio al ruolo di visualizzatoriAdd the service principal to the viewers role

Dopo aver creato l'entità servizio, aggiungerla al ruolo di visualizzatori nel database di Esplora dati di Azure.Now that you have a service principal, you add it to the viewers role in the Azure Data Explorer database. È possibile eseguire questa attività in Autorizzazioni nel portale di Azure o in Query usando un comando di gestione.You can perform this task under Permissions in the Azure portal, or under Query by using a management command.

Portale di Azure - AutorizzazioniAzure portal - Permissions

  1. Nel portale di Azure passare a cluster di Esplora dati di Azure.In the Azure portal, go to your Azure Data Explorer cluster.

  2. Nella sezione Panoramica selezionare il database con i dati di esempio StormEvents.In the Overview section, select the database with the StormEvents sample data.

    Seleziona database

  3. Selezionare Autorizzazioni quindiAggiungi.Select Permissions then Add.

    Autorizzazioni per il database

  4. In Aggiungere autorizzazioni database selezionare il ruolo Visualizzatore e quindi Selezionare entità di sicurezza.Under Add database permissions, select the Viewer role then Select principals.

    Aggiungere autorizzazioni database

  5. Cercare l'entità servizio creata.Search for the service principal you created. Selezionare l'entità di sicurezza e quindi Seleziona.Select the principal, then Select.

    Gestire le autorizzazioni nel portale di Azure

  6. Selezionare Salva.Select Save.

    Gestire le autorizzazioni nel portale di Azure

Comando di gestione - QueryManagement command - Query

  1. Nel portale di Azure passare a cluster di Esplora dati di Azure e selezionare Query.In the Azure portal, go to your Azure Data Explorer cluster, and select Query.

    Query

  2. Eseguire il comando seguente nella finestra di query.Run the following command in the query window. Usare l'ID applicazione e l'ID tenant nel portale di Azure o nell'interfaccia della riga di comando.Use the application ID and tenant ID from the Azure portal or CLI.

    .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
    

    Il comando restituisce un set di risultati simile al seguente.The command returns a result set like the following. In questo esempio, la prima riga è per un utente esistente nel database e la seconda riga è per l'entità servizio appena aggiunta.In this example, the first row is for an existing user in the database, and the second row is for the service principal that was just added.

    Set di risultati

Creare un connettore Azure Esplora dati in DashCreate Azure Data Explorer Connector in Redash

  1. Accedere per ritrattere.Sign in to Redash. Selezionare inizia a creare un account.Select Get Started to create an account.

  2. In Introduzioneselezionare Connetti un'origine dati.Under Let's get started, Select Connect a Data Source.

    Connettere un'origine dati

  3. Nella finestra Crea una nuova origine dati selezionare Azure Esplora dati (kusto), quindi selezionare Crea.In Create a New Data Source window, select Azure Data Explorer (Kusto), then select Create.

    Selezionare l'origine dati Esplora dati di Azure

  4. Nella finestra di Esplora dati di Azure (kusto) completare il modulo seguente e selezionare Crea.In Azure Data Explorer (Kusto) window, complete the following form and select Create.

    Finestra impostazioni di Azure Esplora dati (kusto)

  5. Nella finestra Impostazioni selezionare Salva e Test connessione per testare la connessione all'origine dati di Azure Esplora dati (kusto) .In Settings window, select Save and Test Connection to test your Azure Data Explorer (Kusto) data source connection.

Crea query in DashCreate queries in Redash

  1. Nella parte superiore sinistra di Ritrattino selezionare Crea > query.On top left of Redash, select Create > Query. Fare clic su nuova query e rinominare la query.Click on New Query and rename the query.

    Crea query

  2. Digitare la query nel riquadro di modifica superiore e selezionare Salva ed Esegui.Type your query in the top editing pane and select Save and Execute. Selezionare pubblica per pubblicare la query per un uso futuro.Select Publish to publish query for future use.

    Salva ed Esegui query

    Nel riquadro sinistro è possibile visualizzare il nome della connessione all'origine dati (connettore GitHub nel flusso) nel menu a discesa e le tabelle del database selezionato.In the left pane, you can see the data source connection name (Github connector in our flow) in the drop-down menu, and the tables in the selected database.

  3. Visualizzare i risultati della query nel riquadro centrale inferiore.View the query results in the bottom central pane. Creare una visualizzazione da usare con la query selezionando il pulsante nuova visualizzazione .Create a visualization to go with the query by selecting the New Visualization button.

    Nuova visualizzazione

  4. Nella schermata di visualizzazione selezionare il tipo di visualizzazione e i campi pertinenti, ad esempio colonna X e colonna Y.In the visualization screen, select the Visualization Type and the relevant fields such as X Column and Y Column. Salvare la visualizzazione.Save the visualization.

    Configurare e salvare la visualizzazione

Creare una query usando un parametroCreate a query using a parameter

  1. Crea > Eseguire una query per creare una nuova query.Create > Query to create a new query. Aggiungere un parametro all'oggetto usando le {} parentesi graffe {}.Add a parameter to it using {{}} curly brackets. Selezionare { {} } per aprire la finestra Aggiungi parametro .Select {{}} to open Add Parameter window. È anche possibile selezionare l' icona Impostazioni per modificare gli attributi di un parametro esistente e aprire la finestra di <parameter_name> .You can also select the settings icon to modify the attributes of an existing parameter and open the <parameter_name> window.

    Inserisci parametro

  2. Assegnare un nome al parametro.Name your parameter. Selezionare tipo: elenco a discesa basato su query dal menu a discesa.Select Type: Query Based Dropdown List from dropdown menu. Selezionare OK.Select OK

    elenco a discesa basato su query

    Nota

    La query utilizza più valori, pertanto è necessario includere la sintassi seguente | where Type in ((split('{{Type}}', ','))) .The query uses multiple values, therefore you must include the following syntax | where Type in ((split('{{Type}}', ','))). Per ulteriori informazioni, vedere l' operatore in.For more information, see in operator. Questo comporta più opzioni per i parametri di query nell'app DashThis results in multiple query parameter options in redash app

Creare un dashboard in DashCreate a dashboard in Redash

  1. Per creare il dashboard, creareil > Dashboard.To create your dashboard, Create > Dashboard. In alternativa, selezionare dashboard esistente, dashboard > selezionare un dashboard dall'elenco.Alternatively, select existing dashboard, Dashboards > select a dashboard from the list.

    Creare un dashboard

  2. Nella finestra nuovo dashboard assegnare un nome al dashboard e selezionare Salva.In New Dashboard window, name your dashboard and select Save. In <Dashboard_name finestra> selezionare Aggiungi widget per creare un nuovo widget.In <Dashboard_name> window, select Add Widget to create a new widget.

  3. Nella finestra Aggiungi widget selezionare nome query, scegliere visualizzazionee parametri.In Add Widget window, select query name, Choose Visualization, and Parameters. Selezionare Aggiungi al dashboardSelect Add to Dashboard

    Scegliere visualizzazioni e Aggiungi al dashboard

  4. Selezionare modifica completata per completare la creazione del dashboard.Select Done Editing to complete dashboard creation.

  5. Nella modalità di modifica del Dashboard selezionare Usa filtri a livello di dashboard per usare il parametro di tipo definito in precedenza.In the dashboard edit mode, select Use Dashboard Level Filters to use the Type parameter previously defined.

    Creazione Dashboard completa

Passaggi successiviNext steps