Criar uma consulta de base para painéis

As consultas base são snippets de consulta reutilizáveis que podem ser usados como blocos de construção para todos os componentes de consulta do painel, como parâmetros, blocos e outras consultas base. Uma única consulta base é gerenciada no contexto de um painel específico. Cada painel pode ter uma ou mais consultas base. As consultas base facilitam a manutenção de consultas em painéis, pois as consultas podem ser gerenciadas em um local central.

Para explorar interativamente as amostras de painel de controle, confira Início Rápido: Visualizar amostras de painel de controle.

Observação

A criação e o gerenciamento de consultas base estão disponíveis no modo de edição para editores de painéis.

Importante

Ao usar consultas base, você não pode se referir a uma fonte de dados diferente da que já é usada em um bloco ou parâmetro específico.

Pré-requisitos

  • Uma conta Microsoft ou uma identidade de usuário do Microsoft Entra. Uma assinatura do Azure não é necessária.
  • Permissões de edição de painel em um painel do Azure Data Explorer

Criar uma consulta base

  1. Alterne o modo do painel de Visualização para Edição.

    Captura de tela da home page do Painel.

  2. Na parte superior do painel, selecione Consultas base.

    Captura de tela do menu do painel no Azure Data Explorer com a opção de consultas base realçada por uma caixa vermelha.

    O painel de consulta base é aberto à direita.

  3. Selecione + Adicionar.

    Captura de tela da nova consulta base nos painéis do Azure Data Explorer.

  4. Insira um Nome de variável a ser usado como referência para essa consulta base.

    Observação

    Sugerimos iniciar cada nome de consulta base com um sublinhado (_) para facilitar o uso posterior e para não entrar em conflito com os nomes definidos pelo Kusto. Para obter mais informações, consulte nomeando suas entidades

    Captura de tela da criação de consulta base nos painéis do Azure Data Explorer.

  5. Selecione uma fonte de dados na lista suspensa.

  6. Insira a consulta KQL que será usada como consulta base. Opcionalmente, essa consulta pode conter outras consultas base.

  7. Selecione Concluído.

Gerenciar consultas base

No painel de consulta base, você pode exibir a lista de consultas base existentes. Em cada cartão de consulta base, selecione o widget de lápis para editar a consulta base ou selecione o menu Mais [...] para duplicar, excluir ou mover a consulta base. A ordem de consulta base também pode ser alterada arrastando e soltando o cartão.

Os seguintes indicadores podem ser visualizados no cartão de consultas base:

  • Nome da variável de consulta base
  • Número de blocos em que a consulta base foi usada
  • Número de parâmetros nos quais a consulta base foi usada
  • Número de consultas base nas quais a consulta base foi usada

Usar uma consulta base

As consultas base podem ser usadas em blocos de dashboard, parâmetros e outras consultas base. Use a consulta base inserindo ['variablename'] no editor de consultas.

Captura de tela do uso de uma consulta base nos painéis do Azure Data Explorer.