Visualizar dados do Azure Data Explorer em RedashVisualize data from Azure Data Explorer in Redash

O Redash conecta e consulta as suas fontes de dados, constrói dashboards para visualizar dados e partilhá-los com os pares.Redash connects and queries your data sources, builds dashboards to visualize data and share them with peers. Neste artigo, aprende-se a configurar o Azure Data Explorer como fonte de dados para o Redash e, em seguida, visualizar dados.In this article, you learn how to set up Azure Data Explorer as a data source for Redash, and then visualize data.

Pré-requisitosPrerequisites

  1. Criar cluster e base de dados.Create cluster and database.
  2. Ingerir dados como explicado na ingestão de dados da amostra no Azure Data Explorer.Ingest data as explained in ingest sample data into Azure Data Explorer. Para obter mais opções de ingestão, consulte a visão geral da ingestão.For more ingestion options, see ingestion overview.

Configure a fonte de dadosConfigure the data source

Executa os seguintes passos para configurar o Azure Data Explorer como fonte de dados para a sua ferramenta de painel de instrumentos.You perform the following steps to configure Azure Data Explorer as a data source for your dashboard tool. Cobriremos estes passos mais detalhadamente nesta secção:We'll cover these steps in more detail in this section:

  1. Crie um diretor de serviço azure Ative Directory (Azure AD).Create an Azure Active Directory (Azure AD) service principal. O diretor de serviço é utilizado pela sua ferramenta de painel de instrumentos para aceder ao serviço Azure Data Explorer.The service principal is used by your dashboard tool to access the Azure Data Explorer service.

  2. Adicione o principal serviço azure AD ao papel dos espectadores na base de dados do Azure Data Explorer.Add the Azure AD service principal to the viewers role in the Azure Data Explorer database.

  3. Especifique as propriedades de ligação da ferramenta do painel de instrumentos com base em informações do diretor de serviço da AD Azure e, em seguida, teste a ligação.Specify your dashboard tool connection properties based on information from the Azure AD service principal, then test the connection.

Criar um principal de serviçoCreate a service principal

Pode criar o diretor de serviço no portal Azure ou utilizar a experiência da linha de comando Azure CLI.You can create the service principal in the Azure portal or using the Azure CLI command-line experience. Independentemente do método que utilizar, após a criação obtém valores para quatro propriedades de ligação que utilizará em etapas posteriores.Regardless of which method you use, after creation you get values for four connection properties that you'll use in later steps.

Portal do AzureAzure portal

  1. Para criar o diretor de serviço, siga as instruções na documentação do portal Azure.To create the service principal, follow the instructions in the Azure portal documentation.

    1. Na Atribuição da aplicação a uma secção de funções, atribua um tipo de papel de Leitor ao seu cluster Azure Data Explorer.In the Assign the application to a role section, assign a role type of Reader to your Azure Data Explorer cluster.

    2. Nos valores Get para a assinatura na secção, copie os três valores de propriedade abrangidos pelas etapas: ID do Diretório (ID do inquilino), ID de aplicaçãoe Palavra-passe.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. No portal Azure, selecione Subscrições e, em seguida, copie o ID para a subscrição em que criou o diretor de serviço.In the Azure portal, select Subscriptions then copy the ID for the subscription in which you created the service principal.

    ID de subscrição - portal

CLI do AzureAzure CLI

  1. Crie um diretor de serviço.Create a service principal. Definir um âmbito adequado e readerum tipo de função de .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}
    

    Para mais informações, consulte Criar um diretor de serviço Azure com o Azure CLI.For more information, see Create an Azure service principal with Azure CLI.

  2. O comando devolve um resultado definido como o seguinte.The command returns a result set like the following. Copie os três valores de propriedade: appID, password, e inquilino.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. Obtenha uma lista das suas assinaturas.Get a list of your subscriptions.

    az account list --output table
    

    Copie o ID de subscrição apropriado.Copy the appropriate subscription ID.

    ID de subscrição - CLI

Adicione o principal de serviço ao papel dos espectadoresAdd the service principal to the viewers role

Agora que tem um diretor de serviço, adicione-o ao papel dos espectadores na base de dados do Azure Data Explorer.Now that you have a service principal, you add it to the viewers role in the Azure Data Explorer database. Pode executar esta tarefa sob Permissões no portal Azure, ou sob consulta utilizando um comando de gestão.You can perform this task under Permissions in the Azure portal, or under Query by using a management command.

Portal Azure - PermissõesAzure portal - Permissions

  1. No portal Azure, vá ao seu cluster Azure Data Explorer.In the Azure portal, go to your Azure Data Explorer cluster.

  2. Na secção Visão Geral, selecione a base de dados com os dados da amostra StormEvents.In the Overview section, select the database with the StormEvents sample data.

    Selecionar base de dados

  3. Selecione Permissões e, em seguida, adicionar .Select Permissions then Add.

    Permissões de base de dados

  4. Em adicionar permissõesde base de dados, selecione a função 'Visualizar' e, em seguida, selecione os principais.Under Add database permissions, select the Viewer role then Select principals.

    Adicionar permissões de base de dados

  5. Procure o diretor de serviço que criou.Search for the service principal you created. Selecione o comitente e, em seguida, selecione.Select the principal, then Select.

    Gerir permissões no portal Azure

  6. Selecione Guardar.Select Save.

    Gerir permissões no portal Azure

Comando de gestão - ConsultaManagement command - Query

  1. No portal Azure, vá ao seu cluster Azure Data Explorer e selecione Query.In the Azure portal, go to your Azure Data Explorer cluster, and select Query.

    Consulta

  2. Executar o seguinte comando na janela de consulta.Run the following command in the query window. Utilize o ID de inscrição e identificação do inquilino do portal Azure ou CLI.Use the application ID and tenant ID from the Azure portal or CLI.

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

    O comando devolve um resultado definido como o seguinte.The command returns a result set like the following. Neste exemplo, a primeira linha é para um utilizador existente na base de dados, e a segunda linha é para o diretor de serviço que acabou de ser adicionado.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.

    Conjunto de resultados

Criar conector Azure Data Explorer em RedashCreate Azure Data Explorer Connector in Redash

  1. Inscreva-se no Redash.Sign in to Redash. Selecione Começar a criar uma conta.Select Get Started to create an account.

  2. Em 'Vamos começar ' começar), Selecione Conecte uma Fonte de Dados.Under Let's get started, Select Connect a Data Source.

    Ligar a uma origem de dados

  3. Em Criar uma nova janela de fonte de dados, selecione Azure Data Explorer (Kusto) e, em seguida, selecione Criar.In Create a New Data Source window, select Azure Data Explorer (Kusto), then select Create.

    Selecione fonte de dados do Azure Data Explorer

  4. Na janela Azure Data Explorer (Kusto), preencha o seguinte formulário e selecione Criar.In Azure Data Explorer (Kusto) window, complete the following form and select Create.

    Janela de definições do Azure Data Explorer (Kusto)

  5. Na janela Definições, selecione 'Ligar', guardar e testar a ligação de fonte de dados do Azure Data Explorer (Kusto).In Settings window, select Save and Test Connection to test your Azure Data Explorer (Kusto) data source connection.

Criar consultas em RedashCreate queries in Redash

  1. Em cima à esquerda Createde Redash, selecione > Create Consulta.On top left of Redash, select Create > Query. Clique em Nova Consulta e mude o nome da consulta.Click on New Query and rename the query.

    Criar consulta

  2. Digite a sua consulta no painel de edição superior e selecione Save and Execute.Type your query in the top editing pane and select Save and Execute. Selecione Publicar para publicar consulta para uso futuro.Select Publish to publish query for future use.

    Guardar e executar consulta

    No painel esquerdo, pode ver o nome da ligação à fonte de dados (conector Github no nosso fluxo) no menu suspenso e as tabelas na base de dados selecionada.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. Veja os resultados da consulta no painel central inferior.View the query results in the bottom central pane. Crie uma visualização para acompanhar a consulta selecionando o botão Nova Visualização.Create a visualization to go with the query by selecting the New Visualization button.

    Nova visualização

  4. No ecrã de visualização, selecione o Tipo de Visualização e os campos relevantes, tais como Coluna X e Coluna Y.In the visualization screen, select the Visualization Type and the relevant fields such as X Column and Y Column. Guarde a visualização.Save the visualization.

    Configurar e salvar a visualização

Criar uma consulta usando um parâmetroCreate a query using a parameter

  1. Criar > Consulta para criar uma nova consulta.Create > Query to create a new query. Adicione-lhe um parâmetro utilizando { {} } suportes encaracolados.Add a parameter to it using {{}} curly brackets. Selecione { {} } para abrir a janela 'Adicionar parâmetro'.Select {{}} to open Add Parameter window. Também pode selecionar o ícone de definições para modificar os atributos de um parâmetro existente e abrir a janela <parameter_name>.You can also select the settings icon to modify the attributes of an existing parameter and open the <parameter_name> window.

    inserir parâmetro

  2. Diga o seu parâmetro.Name your parameter. Selecione Tipo: Lista de dropdown baseada em consulta do menu suspenso.Select Type: Query Based Dropdown List from dropdown menu. Selecione OKSelect OK

    lista de dropdown baseada em consulta

    Nota

    A consulta utiliza vários valores, pelo que deve incluir a seguinte sintaxe | where Type in ((split('{{Type}}', ','))) .The query uses multiple values, therefore you must include the following syntax | where Type in ((split('{{Type}}', ','))). Para mais informações, consulte o operador.For more information, see in operator. Isto resulta em várias opções de parâmetros de consulta na aplicação redashThis results in multiple query parameter options in redash app

Criar um dashboard em RedashCreate a dashboard in Redash

  1. Para criar o seu painel de instrumentos, crie > dashboard.To create your dashboard, Create > Dashboard. Em alternativa, selecione o dashboard existente, os dashboards > selecionar um dashboard da lista.Alternatively, select existing dashboard, Dashboards > select a dashboard from the list.

    Criar painel de instrumentos

  2. Na janela New Dashboard, nomeie o seu painel de instrumentos e selecione Save.In New Dashboard window, name your dashboard and select Save. Na janela <Dashboard_name>, selecione Add Widget para criar um novo widget.In <Dashboard_name> window, select Add Widget to create a new widget.

  3. Na janela Add Widget, selecione o nome de consulta, escolha visualizaçãoe parâmetros.In Add Widget window, select query name, Choose Visualization, and Parameters. Selecione Adicionar ao Painel de InstrumentosSelect Add to Dashboard

    Escolha visualizações e adicione ao dashboard

  4. Selecione 'Editar' para completar a criação do painel de instrumentos.Select Done Editing to complete dashboard creation.

  5. No modo de edição do dashboard, selecione Use Dashboard Level Filters para utilizar o parâmetro tipo previamente definido.In the dashboard edit mode, select Use Dashboard Level Filters to use the Type parameter previously defined.

    Criação completa do painel de instrumentos

Passos seguintesNext steps