Exercício: Criar um parâmetro de painel

Concluído

Nesta unidade, você cria um parâmetro para filtrar visualizações de painel.

Criar um parâmetro

Primeiro, você precisa mudar do modo de visualização para o modo de edição.

  1. Selecione Visualização e alterne o modo para Edição.

    Screenshot of switching to editing mode.

  2. Na barra de menu superior, selecione [@] Parâmetros. O painel Parâmetros é aberto.

  3. Selecionar + Novo parâmetro

  4. Preencha as opções de parâmetro no painel Adicionar parâmetro da seguinte maneira:

    Screenshot of parameter options.

    Campo Descrição Valor sugerido
    Etiqueta O nome do parâmetro mostrado no painel ou no cartão de edição. Estado
    Tipo de parâmetro Seleção única: Apenas um valor pode ser selecionado no filtro como entrada para o parâmetro.
    Seleção múltipla: Um ou mais valores podem ser selecionados no filtro como entrada(s) para o parâmetro.
    Intervalo de tempo: filtre as consultas e painéis com base no tempo.
    Texto livre: O usuário pode digitar um valor ou copiar/colar um valor no campo de texto.
    Seleção múltipla
    Nome da variável O nome do parâmetro a ser usado na consulta. _state
    Tipo de dados O tipo de dados dos valores dos parâmetros. string
    Mostrar nas páginas Selecione as páginas onde esse parâmetro é exibido. Selecionar tudo
    Source Valores fixos: Introduzidos manualmente valores de filtro estático.
    Consulta: Valores introduzidos dinamicamente usando uma consulta KQL.
    Consulta
    Data source A origem de um parâmetro baseado em consulta. Consulte Editar consulta.

Editar consulta de origem de parâmetro

Você precisa criar uma lista de valores possíveis para esse parâmetro. O parâmetro que você está criando é chamado Estado. Você deseja usá-lo para filtrar os resultados com base no estado em que o evento ocorreu. Você pode inserir manualmente uma lista de todos os estados possíveis, no entanto, é mais simples usar uma consulta que retorna essa lista dinamicamente.

  1. Em Fonte de dados, selecione o banco de dados Exemplos.

  2. No campo Resultados da consulta, selecione Editar consulta.

  3. Copie/cole a seguinte consulta no editor:

    StormEvents
    | distinct (State)
    
  4. Selecione Executar. Esta consulta retorna uma lista de todos os valores diferentes na coluna Estado.

    Screenshot of editing query for parameter.

  5. Selecione Adicionar para retornar à caixa de diálogo Adicionar parâmetro.

  6. Selecione a lista suspensa Valor padrão e selecione um dos estados (por exemplo, Minnesota).

    Screenshot of source to add query.

  7. Selecione Concluído.

Editar ambas as consultas de bloco para incluir um parâmetro

Você criou um parâmetro, mas seu painel tem a mesma aparência. Você precisa usar o parâmetro na consulta que gera um visual.

Eventos por data

  1. No bloco Eventos por data, selecione o ícone de lápis.

    Screenshot of editing the query in the tile.

  2. Use o nome da variável definido nas opções de parâmetro como um filtro na consulta. Neste caso, o nome da variável é estado. Edite a consulta para incluir a seguinte linha:

    | where State has_any (_state)
    

    Sua consulta deve se parecer com a seguinte imagem:

    Screenshot of editing the query to add parameter.

  3. Selecione Aplicar alterações.

Contagem de eventos por estado

  1. No bloco Contagem de eventos por estado, selecione o ícone de lápis.

  2. Edite a consulta para incluir a seguinte linha:

    | where State has_any (_state)
    

    Sua consulta deve se parecer com a seguinte imagem:

    Screenshot of query in dashboard visual including parameter.

  3. Selecione Aplicar alterações.

Use o parâmetro

Selecione o parâmetro State e, em seguida, selecione uma das opções no menu suspenso, por exemplo, TEXAS. Certifique-se e desmarque o valor padrão, para que apenas um estado seja selecionado. Observe como as visualizações mudam para exibir apenas os dados associados ao estado selecionado.

Animated gif showing how to use the parameter picker.