Partilhar via

Usar parâmetros baseados em consulta

  • Artigo

O artigo orienta você pelas etapas para criar um painel interativo que usa parâmetros baseados em consulta. Ele pressupõe uma familiaridade básica com a criação de painéis no Azure Databricks. Consulte Introdução para obter instruções básicas sobre como criar painéis.

Requisitos

  • Você está conectado a um espaço de trabalho do Azure Databricks.
  • Você tem o direito SQL nesse espaço de trabalho.
  • Você tem pelo menos PODE USAR acesso a um ou mais armazéns SQL.

Criar um conjunto de dados de painel

Este tutorial usa dados gerados do catálogo de exemplos no Azure Databricks.

  1. Clique Novo ícone em Novo na barra lateral e selecione Painel no menu.

  2. Clique no separador Dados.

  3. Clique em Criar a partir do SQL e cole a seguinte consulta no editor. Em seguida, clique em Executar para retornar os resultados.

    SELECT
  *
FROM
  samples.tpch.customer

  4. Seu conjunto de dados recém-definido é salvo automaticamente com o nome Conjunto de dados sem título. Clique duas vezes no título e renomeie-o Segmento de marketing.

Adicionar um parâmetro

Você pode adicionar um parâmetro a esse conjunto de dados para filtrar os valores retornados. O parâmetro neste exemplo é :segment. Consulte Trabalhar com parâmetros do painel para saber mais sobre a sintaxe dos parâmetros.

  1. Cole a seguinte WHERE cláusula na parte inferior da consulta. Um campo de texto com o nome segment do parâmetro aparece abaixo da consulta.

    WHERE
  c_mktsegment = :segment

  2. Digite BUILDING no campo de texto abaixo da consulta para definir o valor padrão para o parâmetro.

  3. Execute novamente a consulta para inspecionar os resultados.

Configurar um widget de visualização

Adicione uma visualização para seu conjunto de dados na tela concluindo as seguintes etapas:

  1. Clique na guia Tela .
  2. Clique em Criar ícone Adicionar uma visualização para adicionar um widget de visualização e use o mouse para colocá-lo na tela.

Configurar o eixo X

  1. Se necessário, selecione Barra no menu suspenso Visualização .
  2. Clique ícone adicionar campo para escolher os dados apresentados ao longo do eixo X. Pode utilizar a barra de pesquisa para procurar um campo por nome. Selecione c_nationkey.
  3. Clique no nome do campo selecionado para visualizar opções de configuração adicionais.
    • Como Tipo de escala, selecione Categórico.
    • Para a seleção Transformar, escolha Nenhum.

Configurar o eixo Y

  1. Clique ao ícone adicionar campo lado do eixo Y e selecione c_acctbal.
  2. Clique no nome do campo selecionado para visualizar opções de configuração adicionais.
    • Como Tipo de escala, selecione Quantitativo.
    • Para a seleção Transformar , escolha SUM.

A visualização é atualizada automaticamente à medida que você a configura. Os dados apresentados incluem apenas registos em que o segment é BUILDING.

Widget de visualização configurado conforme descrito nas etapas anteriores.

Adicionar um filtro

Configure um filtro para que os visualizadores do painel possam controlar em qual segmento de marketing se concentrar.

  1. Clique em Ícone de filtro Adicionar um filtro (campo/parâmetro) para adicionar um widget de filtro. Coloque-o na tela.
  2. No menu suspenso Filtro no painel de configuração, selecione Valor único.
  3. Marque a caixa de seleção Título para mostrar um campo de título no widget de filtro.
  4. Clique no título do espaço reservado no widget e digite Segmento para renomear seu filtro.
  5. Clique ícone adicionar campo ao lado de Parâmetros no painel de configuração.
  6. Escolha o segmento no conjunto de dados do segmento de Marketing.

Seu widget de filtro configurado mostra o valor do parâmetro padrão para o conjunto de dados.

Widget de filtro configurado com um parâmetro, conforme descrito.

Definir uma seleção de valores

O filtro criado é funcional, mas requer que o visualizador conheça o intervalo de opções disponível antes de poder digitar uma seleção. Também requer que os usuários correspondam às maiúsculas e minúsculas e à ortografia ao inserir o valor do parâmetro desejado.

Para criar uma lista suspensa para que o visualizador possa selecionar um parâmetro de uma lista de opções disponíveis, crie um novo conjunto de dados para definir a lista de valores possíveis.

  1. Clique no separador Dados.

  2. Clique em Criar a partir do SQL para criar um novo conjunto de dados.

  3. Copie e cole o seguinte no editor:

    SELECT
  DISTINCT c_mktsegment
FROM
  samples.tpch.customer

  4. Execute sua consulta e inspecione os resultados. Os cinco segmentos de marketing da tabela aparecem nos resultados.

  5. Clique duas vezes no título gerado automaticamente e renomeie essa opção de segmento do conjunto de dados.

Atualizar o filtro

Atualize seu filtro existente para usar o conjunto de dados que você acabou de criar para preencher uma lista suspensa de valores que os usuários podem selecionar.

  1. Clique em Tela. Em seguida, clique no widget de filtro que você criou em uma etapa anterior.
  2. Clique ao ícone adicionar campo lado de Campos.
  3. Clique em Escolha de segmento e, em seguida, clique no nome c_mktsegmentdo campo .

Seu widget de filtro é atualizado à medida que você altera a configuração. Clique no campo no widget de filtro para ver as opções disponíveis no menu suspenso.

Nota

Este tutorial contém um caso de uso simplificado destinado a demonstrar como usar parâmetros baseados em consulta. Uma abordagem alternativa para criar esse painel é aplicar um filtro ao c_mktsegment campo.

Widget de filtro configurado com um campo, conforme descrito.

Próximos passos

Continue aprendendo sobre como trabalhar com painéis com os seguintes artigos: