Usar parâmetros do painel

Os parâmetros do painel são uma forma de tornar os painéis interativos, permitindo que os visualizadores usem seletores de valor único e selecionadores de data para inserir valores específicos nas consultas do site dataset em tempo de execução. Por exemplo, os parâmetros podem filtrar dados com base em critérios como datas e categorias de produtos antes de serem agregados em uma consulta SQL, permitindo consultas mais eficientes e análises mais precisas.

Os parâmetros são adicionados ao conjunto de dados e conectados a um ou mais widgets na tela de um painel por um autor ou editor de painel. Os visualizadores de painel interagem com os dados do painel selecionando valores nos widgets de filtro em tempo de execução. Isso executa novamente as consultas associadas e apresenta visualizações criadas com base nos dados filtrados.

Os parâmetros modificam diretamente a consulta, o que pode ser poderoso. dataset Os filtros também podem oferecer interatividade de painel, mais recursos e melhor desempenho com grandes conjuntos de dados do que os parâmetros. Veja os filtros.

Adicionar um parâmetro

O senhor deve ter pelo menos a permissão Can Edit no painel de rascunho para adicionar um parâmetro a um painel dataset. O senhor pode adicionar parâmetros diretamente às consultas do site dataset nos dados tab.

O gif mostra um exemplo dos seguintes passos.

Para adicionar um parâmetro a uma consulta:

  1. Posicione o cursor onde o senhor deseja colocar o parâmetro na consulta.

  2. Clique em Add parameter para inserir um novo parâmetro.

    Isso cria um novo parâmetro com o nome default parameter. Para alterar o nome default, substitua-o no editor de consultas. O senhor também pode adicionar parâmetros digitando essa sintaxe no editor de consultas.

Editar um parâmetro

Para editar um parâmetro:

  1. Clique em ícone de engrenagem ao lado do nome do parâmetro. É exibida uma caixa de diálogo de detalhes do parâmetro.

    A caixa de diálogo inclui as seguintes opções de configuração:

    • Palavra-chave: a palavra-chave que representa o parâmetro na consulta. Isso só pode ser alterado atualizando diretamente o texto na consulta.

    • Nome de exibição: O nome no editor de filtros. Em default, o título é o mesmo que a palavra-chave.

    • Type (Tipo): Os tipos compatíveis incluem cadeias de caracteres, data, data e hora, numérico.

      • O tipo de default é strings.

      • O tipo de dado Numeric permite que o senhor especifique entre Decimal e Integer. O tipo numérico do site default é Decimal.

  2. Clique em outra parte da interface do usuário para fechar a caixa de diálogo.

Remover um parâmetro

Para remover um parâmetro, exclua-o de sua consulta.

Usar um parâmetro na tela do painel

Para adicionar um parâmetro ao seu painel:

  1. Clique em Ícone de filtro Add a filter (field/parameter) (Adicionar um filtro (campo/parâmetro)).

  2. Clique em adicionar ícone de campo ao lado de Parameters (Parâmetros ) no painel de configuração.

  3. Clique no nome do parâmetro que o usuário deseja que o visualizador use com esse widget.

Incluir parâmetros no URL

As configurações de parâmetros são armazenadas no URL, permitindo que os usuários o marquem como favorito para manter o estado do painel, incluindo filtros e parâmetros predefinidos, ou o compartilhem com outras pessoas para aplicação consistente dos mesmos filtros e parâmetros.

Exemplos de sintaxe de parâmetros

Uso

Exemplo de caso de uso

Sintaxe dos parâmetros do painel

Inserir uma data

Incluir apenas registros anteriores a uma data específica

WHERE date_field < :date_param

Inserir um número

Incluir apenas preços abaixo de um preço específico

WHERE price < :max_price

Inserir um nome de tabela

Alterar uma tabela usada em uma consulta

SELECT * FROM IDENTIFIER(:param)

Inserir outros objetos do banco de dados

Alterar o catálogo, o esquema e a tabela usados em uma consulta

SELECT * FROM IDENTIFIER(:catalog || '.' || :schema || '.' || :table)

Concatenar vários parâmetros

Combine dois parâmetros com colchetes para criar números de telefone formatados

format_string('(%d) %d', :area_code, :phone_number) (1)

(1) Os valores são inseridos usando a função format_string. Consulte a função format_string.

Importante

Permitir que os visualizadores do painel acessem dados por meio de seleções de parâmetros, como nomes de tabelas ou catálogos, pode levar à exposição acidental de informações confidenciais. Se o senhor estiver publicando um painel com essas opções, a Databricks recomenda não incorporar credenciais no painel publicado.

Parâmetros do painel vs. parâmetros de consulta do site Databricks SQL

Os parâmetros do painel usam a mesma sintaxe dos marcadores de parâmetros nomeados. Consulte Marcadores de parâmetros nomeados. Os painéis não são compatíveis com os parâmetros de estilo do site Databricks SQL.