Painéis

Visualização

Esse recurso está em Prévia Pública.

O senhor pode usar painéis para criar visualizações de dados e compartilhar percepções de dados informativos com sua equipe. AI/BI painéis recurso de autoria assistida por IA, uma biblioteca de visualização aprimorada e uma experiência de configuração simplificada para que o senhor possa transformar rapidamente dados em percepções compartilháveis.

AI/BI Os painéis têm os seguintes componentes:

  • Dados: O Data tab permite que os usuários definam o conjunto de dados a ser usado no painel. Os conjuntos de dados são agrupados com painéis ao compartilhá-los, importá-los ou exportá-los usando a UI ou API.

  • Canvas: O Canvas tab permite que os usuários criem visualizações e construam seus painéis. A tela contém widgets que podem ser configurados para exibir visualizações, filtros, texto ou imagens.

Observação

O senhor pode definir até 100 conjuntos de dados por painel. O Canvas pode conter até 100 widgets por dashboard.

Visualizar e organizar painéis de controle

O senhor pode acessar os painéis do navegador workspace juntamente com outros objetos Databricks.

  • Clique em Ícone do workspace workspace na barra lateral para acessar view dashboards no navegador workspace. Os painéis são armazenados no diretório /Workspace/Users/<username> por default. Os usuários podem organizar os painéis em pastas no navegador workspace junto com outros objetos Databricks. Consulte Navegador do espaço de trabalho.

  • Para acessar view a página de listagem do painel, clique em Ícone dos painéis Dashboards na barra lateral.

    Em default, a página de listagem do painel mostra os painéis aos quais o senhor tem acesso, classificados em ordem cronológica inversa. O senhor pode filtrar a lista inserindo um título na barra de pesquisa, filtrar pela última modificação em um período de tempo ou filtrar por proprietário.

  • Clique no título de um dashboard para abri-lo. Se o painel tiver sido publicado anteriormente, a versão publicada será aberta. Caso contrário, o painel de rascunho será aberto.

Criar um novo painel

Para criar um novo painel na página de listagem de painéis, clique em Create (Criar ) no canto superior direito da página.

Defina seu conjunto de dados

Use o Data tab para definir o conjunto de dados subjacente ao seu painel.

O senhor pode definir o conjunto de dados como qualquer um dos seguintes:

  • Uma nova consulta em uma ou mais tabelas ou exibições.

  • Uma tabela existente no site Unity Catalog ou view.

O senhor pode definir o conjunto de dados em qualquer tipo de tabela ou view. O senhor pode definir vários conjuntos de dados escrevendo consultas adicionais ou selecionando tabelas ou visualizações adicionais. Após definir um dataset, o senhor pode usar o menu kebab Menu Kebab à direita do nome dataset para renomear, clonar ou excluir. O senhor também pode download o dataset como um arquivo CSV, TSV ou Excel.

O menu mostra as opções do site dataset

Limitar o acesso aos dados com o SQL

Todos os dados em um painel dataset podem estar acessíveis aos visualizadores do painel, mesmo que não sejam exibidos em uma visualização. Para evitar que dados confidenciais sejam enviados ao navegador, limite as colunas especificadas na consulta SQL que define o dataset. Por exemplo, em vez de selecionar todas as colunas de uma tabela, escolha apenas as colunas específicas necessárias para as visualizações em sua instrução SQL em vez da configuração da tabela.

Adicionar ou remover visualizações, texto e widgets de filtro na tela

Use o Canvas tab para criar seu painel. Use a barra de ferramentas na parte inferior da tela para adicionar widgets, como visualizações, caixas de texto e filtros.

Visualizações

Crie uma visualização adicionando um widget de visualização à tela. As visualizações compatíveis incluem os tipos de gráfico de área, barra, combo, contador, mapa de calor, histograma, linha, pie, pivô, dispersão e tabela.

Observação

As consultas usadas pelas visualizações nem sempre correspondem precisamente ao site dataset. Por exemplo, se o senhor aplicar agregações a uma visualização, a visualização mostrará os valores agregados.

Para criar uma visualização, use um dos métodos a seguir:

  • Visualizações assistidas por IA: Descreva o gráfico que o senhor deseja ver em linguagem natural e deixe que o Databricks Assistant gere um gráfico. Depois de criado, o senhor pode modificar o gráfico gerado usando o painel de configuração. O senhor não pode usar o Assistente para criar tipos de gráficos de tabela ou de tabela dinâmica.

  • Use o painel de configuração: Aplicar agregações adicionais ou intervalos de tempo na configuração da visualização sem modificar diretamente o site dataset. O senhor pode escolher um dataset, valores do eixo x, valores do eixo y e cores. Consulte Tipos de visualização do painel para obter detalhes de configuração e exemplos de cada tipo de visualização compatível. Consulte Opções de tabela para saber como controlar a apresentação de dados em visualizações de tabela.

Observação

Quando o senhor aplica transformações temporais na configuração da visualização, a data mostrada na visualização representa o início desse período.

Widgets de texto

Markdown é uma linguagem de marcação para formatação de texto em um editor de texto simples. O senhor pode usar o markdown em widgets de texto para formatar o texto, inserir links e adicionar imagens ao seu painel.

  • Para adicionar uma imagem estática em um widget de texto, adicione a sintaxe de imagem markdown com a descrição e o URL desejados: ![description](URL) de um URL disponível publicamente. Por exemplo, a marcação a seguir inserirá uma imagem do logotipo da Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png). Para redimensionar a imagem, redimensione as dimensões do widget.

  • Para adicionar uma imagem do DBFS, adicione a sintaxe de imagem markdown com a descrição desejada e o caminho do FileStore: ![description](files/path_to_dbfs_image). Para redimensionar a imagem, redimensione as dimensões do widget. Para obter mais informações sobre DBFS, consulte O que é DBFS?

Para obter mais informações sobre a sintaxe do markdown, consulte este guia.

Filtros

Os filtros são widgets que permitem que os visualizadores do painel reduzam os resultados filtrando campos específicos ou definindo parâmetros dataset. Eles funcionam da mesma forma que os slicers em outras ferramentas de BI, permitindo que os visualizadores de painéis manipulem e refinem os dados apresentados nas visualizações. Cada widget de filtro pode ser configurado para filtrar nos campos dataset ou para atribuir valores a parâmetros predefinidos em uma consulta dataset. Os filtros e parâmetros de campo podem ser combinados em um único widget ao usar parâmetros baseados em consulta. Consulte Usar parâmetros baseados em consulta para saber como aplicar um parâmetro baseado em consulta.

O senhor pode definir um valor default em um widget para alguns tipos de filtro, conforme indicado nas listas de tipos de filtro a seguir. Para isso, selecione um valor no menu suspenso default value nas definições de configuração do widget de filtro. Os filtros sempre se aplicam a todo o site dataset. Se o site dataset for pequeno, o filtro será aplicado diretamente no navegador para melhorar o desempenho. Se o site dataset for maior, o filtro será adicionado à consulta que está sendo executada no site SQL warehouse. Consulte dataset optimization and caching.

Filtrar por campos

Os filtros podem ser aplicados a campos de um ou mais conjuntos de dados. Para conectar um filtro a campos de mais de um site dataset, adicione vários campos, até um por site dataset. O filtro se aplica a todas as visualizações criadas no conjunto de dados selecionado. A seleção do filtro é feita em cascata em todos os outros filtros. Os painéis são compatíveis com os seguintes tipos de filtro para filtragem em um campo:

  • Valor único (aceita o valor default )

  • Vários valores (aceita o valor default )

  • Selecionador de datas

  • Seletor de intervalo de datas

  • Entrada de texto

  • Controle deslizante de faixa

Filtrar por parâmetros

Um filtro pode ser aplicado a um ou mais parâmetros. Para conectar um filtro a mais de um parâmetro, adicione vários parâmetros no painel de configuração do filtro. Para os tipos de filtro que aceitam a definição de um valor default no widget, o valor default substitui o valor default definido no editor de consultas do Data tab. Se um filtro estiver conectado a um parâmetro, ele executará uma consulta no site SQL warehouse, independentemente do tamanho do dataset. Consulte O que são parâmetros de painel?

Os painéis suportam os seguintes tipos de filtro para filtragem em um parâmetro:

  • Valor único (aceita o valor default )

  • Selecionador de datas

O senhor pode definir valores de parâmetros para aceitar um dos seguintes tipos de dados:

  • String

  • Data

  • Data e hora

  • Decimal

  • Inteiro

Observação

Não há suporte para o uso de parâmetros para especificar intervalos de datas. Para especificar um intervalo de datas, aplique filtros nos campos que incluem as datas de início e término do intervalo desejado.

Incluir filtros e parâmetros nos URLs do painel publicado

As seleções de filtros e parâmetros são armazenadas no URL. Os usuários podem marcar esses URLs como favoritos para salvar o estado do painel, incluindo todos os filtros e parâmetros. Dessa forma, as configurações do painel permanecem intactas, permitindo que outras pessoas o view com as mesmas configurações quando acessarem o link.

Copiar widgets

Use os atalhos do teclado para copiar um widget selecionado e colá-lo de volta na tela. Depois de criar um novo widget, o usuário pode editá-lo como faria com qualquer outro widget.

Para clonar um widget na tela do painel de rascunho, conclua os seguintes passos:

  • Clique com o botão direito do mouse em um widget.

  • Clique em Clonar.

Um clone de seu widget aparece abaixo do original.

Remover widgets

Exclua os widgets selecionando um widget e pressionando a tecla delete key no teclado. Ou clique com o botão direito do mouse no widget. Em seguida, clique em Excluir.

Resultados do download

O senhor pode usar o conjunto de dados download como arquivos CSV, TSV ou Excel. O senhor pode fazer o download das visualizações na tela como arquivos PNG.

  • Para abrir as opções do download no Canvas tab, clique no menu kebab do Menu Kebab no canto superior direito do widget.

  • Para abrir as opções do download em um Data tab, clique no menu Menu Kebab kebab à direita do dataset.

O senhor pode download até aproximadamente 1 GB de dados de resultados nos formatos CSV e TSV e até 100.000 linhas em um arquivo Excel. O tamanho final do arquivo download pode ser um pouco maior ou menor que 1 GB, pois o limite de 1 GB é aplicado a um passo anterior ao arquivo final download.

Elaborar e colaborar em um painel de controle

Os novos painéis começam como um rascunho. O senhor pode compartilhar o rascunho com outros usuários em seu workspace para colaborar. Os painéis de rascunho não podem ser compartilhados com usuários fora do site workspace. Todos os usuários usam suas próprias credenciais para interagir com os dados e as visualizações nos rascunhos do painel.

Para saber mais sobre os níveis de permissão, consulte ACLs do painel AI/BI.

Publicar um painel

Publique um painel para criar uma cópia limpa do rascunho atual. O senhor deve ter pelo menos permissões CAN EDIT para publicar um painel.

Depois de publicar um painel, a versão publicada permanece intacta até que o usuário publique novamente, mesmo que faça alterações no rascunho. O senhor pode fazer modificações e melhorias na versão preliminar sem afetar a cópia publicada. Qualquer usuário registrado com acesso ao painel publicado pode continuar acessando view a versão publicada. A versão publicada continua a ser enviada por e-mail aos assinantes, se houver algum. Para saber mais sobre como gerenciar o acesso ao painel, consulte Compartilhar um painel.

Ao publicar um painel, o senhor pode optar por incorporar ou não suas credenciais.

Importante

Os painéis publicados não são versionados e não devem ser usados para controle de versão. O senhor não pode reverter um painel de rascunho para um estado publicado anteriormente.

  • Incorporar credenciais: Todos os visualizadores de um painel publicado podem executar consultas usando suas credenciais para dados e compute. Isso permite que os usuários vejam o painel mesmo que não tenham acesso ao site de origem workspace, aos dados subjacentes ou ao site SQL warehouse. Isso pode expor os dados a usuários que não receberam acesso direto a eles. Essa é a opção default.

  • Não incorpore credenciais: Todos os visualizadores das consultas de execução do painel publicado usam seus próprios dados e as credenciais do compute. Para obter os resultados do view no painel, os visualizadores precisam acessar o workspace, o SQL warehouse anexado e os dados associados.

Consulte Compartilhar um painel publicado para obter recomendações sobre qual configuração escolher.

Para publicar um dashboard, conclua os seguintes passos:

  1. Abra um painel. Se o painel tiver sido publicado anteriormente, a versão publicada será aberta. Se necessário, use o seletor na parte superior da página para ver a versão atual do rascunho.

  2. Clique em Publicar. A caixa de diálogo Publicar é exibida.

  3. Escolha as credenciais a serem usadas para o painel publicado. O senhor pode optar por incorporar suas credenciais ou não.

  4. Clique em Publicar. Se o seu painel estiver sendo publicado pela primeira vez, uma caixa de diálogo de compartilhamento será aberta e solicitará que o senhor compartilhe o painel publicado. Consulte Compartilhar um painel para obter detalhes e recomendações sobre compartilhamento.

Para acessar o painel publicado, clique em Publicado no menu suspenso próximo à parte superior do painel.

Menu suspenso que mostra as versões de rascunho e publicadas do painel disponíveis.

Programar painéis de controle para atualizações periódicas

O senhor pode configurar atualizações programadas para refresh automaticamente o seu painel e, opcionalmente, enviar um e-mail com um PDF do painel mais recente para os usuários que estão inscritos no programa.

Os usuários com permissões de pelo menos Can Edit podem criar um programa para que os painéis publicados com credenciais incorporadas sejam executados periodicamente. Cada dashboard pode ter até dez programas.

Para cada atualização programada do painel, ocorre o seguinte:

  • Toda a lógica do SQL que define a execução do conjunto de dados no intervalo de tempo designado.

  • Os resultados preenchem o cache de resultados da consulta e ajudam a melhorar o tempo de carregamento inicial do painel.

Para criar um programa:

  1. Clique em programar no canto superior direito do painel. A caixa de diálogo Add programar é exibida.

    Adicionar diálogo de programação
  2. Use os seletores suspensos para especificar a frequência e o fuso horário. Opcionalmente, marque a caixa de seleção Show cron syntax (Mostrar sintaxe do cron) para editar o programa no Quartz Cron Syntax.

  3. Clique em Create. A caixa de diálogo do programa é exibida e mostra o programa que o senhor criou. Se houver outros programas para esse dashboard, a caixa de diálogo também os mostrará.

  4. Opcionalmente, clique em Subscribe para se adicionar como assinante e receber um e-mail email com um PDF Snapshot do painel após a conclusão de uma execução agendada.

Observação

Se um programar já tiver sido criado para esse painel, o botão no canto superior direito indicará Subscribe (Assinar). O senhor pode usar o fluxo de trabalho descrito anteriormente para adicionar um programar.

gerenciar inscrição

Os assinantes do programar recebem um e-mail email com um PDF Snapshot do dashboard atual sempre que o programar for executado. Os assinantes qualificados incluem usuários do workspace e destinos de notificação do email.

Observação

Se o senhor não puder adicionar assinantes ao email, o administrador do workspace pode ter desativado as notificações do email para o seu workspace. Consulte o guia de administração do Dashboard.

workspace os administradores devem definir os destinos de notificação do email antes de poderem ser selecionados como assinantes. Consulte gerenciar destinos de notificação. account usuários, listas de distribuição e usuários fora do account (como usuários em parceiros ou organizações de clientes) podem ser configurados como destinos de notificação do email e assinados. No entanto, eles não podem ser assinados diretamente.

Importante

As listas de inscrição podem conter até 100 assinantes. Um destino de notificação email conta como um assinante, independentemente do número de e-mails que envia.

O senhor pode adicionar e remover outros assinantes para receber atualizações se tiver pelo menos privilégios de Can Edit no painel. O senhor pode adicionar e remover a si mesmo como assinante de um programa existente se tiver pelo menos os privilégios do Can view no painel.

  • Para inscrever outros usuários:

    1. Clique em Subscribe (Assinar ) no canto superior direito do painel. A caixa de diálogo programar é exibida.

    2. Identifique o programa ao qual o senhor deseja adicionar assinantes. Clique no link Menu Kebab à direita do programa. Em seguida, clique em Edit (Editar).

    Observação

    O senhor também pode usar esse menu de contexto para pausar ou excluir um programa.

    Se o senhor tiver acesso ao Can view a um dashboard que tenha um programar atribuído, poderá se inscrever para receber atualizações sempre que ocorrer uma execução programada.

  • Para se inscrever em um programa existente:

    1. Clique no botão Subscribe (Assinar ) próximo ao canto superior direito do painel. A caixa de diálogo de programação mostra toda a programação do painel.

    2. Clique em Subscribe (Assinar ) à direita do programa que o senhor escolheu.

    Se o senhor não conseguir se adicionar como assinante, verifique os seguintes motivos:

    • Um administrador do site workspace desativou a opção Habilitar inscrição no painel para o site workspace.

      Essa configuração substitui todas as outras. Se o administrador do workspace tiver desativado essa configuração, os editores do painel ainda poderão atribuir um programador, mas nenhum assinante poderá ser atribuído.

    • O painel não é compartilhado com credenciais incorporadas.

      Os painéis compartilhados sem credenciais incorporadas não podem ser atribuídos a um programador, portanto, não podem receber assinantes.

    • O senhor não tem permissão para acessar o site workspace.

      account os usuários só podem ser adicionados como assinantes como um destino de notificação email. Não há botão Subscribe (Assinar ) no painel para usuários do account.

    • Nenhum programa foi definido.

      Para painéis sem um programador definido, os usuários do workspace com acesso Can view ou Can Execution a um painel não podem interagir com o botão Subscribe.

Cancelar a assinatura de atualizações por e-mail

Os assinantes podem optar por parar de receber e-mails cancelando a assinatura do programa.

  • Para cancelar a assinatura usando a interface do usuário do painel:

    1. Clique no botão Subscribe (Assinar ) próximo ao canto superior direito do painel. A caixa de diálogo de programação mostra toda a programação do painel.

    2. Clique em Subscribed para cancelar a assinatura. O texto do botão muda para Subscribe (Assinar).

    A interface do usuário muda de Subscribed para Subscribe.
  • Use o link Unsubscribe (Cancelar assinatura ) no rodapé do site email para cancelar a assinatura das atualizações programadas.

Observação

Quando um usuário incluído em uma lista de distribuição maior configurada para notificações do email opta por cancelar a assinatura usando o link no rodapé do email, a ação cancela a assinatura de toda a lista de distribuição. O grupo como um todo é removido da inscrição e não receberá futuras atualizações do PDF Snapshot.

Limites de tamanho do painel para inscrição

O e-mail de inscrição do painel inclui os seguintes arquivos codificados em base64:

Exportar, importar ou substituir um painel

O senhor pode exportar e importar painéis como arquivos para facilitar o compartilhamento de painéis editáveis em diferentes espaços de trabalho. Para transferir um painel para outro site workspace, exporte-o como um arquivo e importe-o para o novo site workspace. O senhor também pode substituir os arquivos do painel no local. Isso significa que, quando o senhor edita um arquivo de painel diretamente, pode upload esse arquivo para o workspace original e substituir o arquivo existente, mantendo as configurações de compartilhamento existentes.

Os passos a seguir explicam como exportar e importar dashboards na interface do usuário. O senhor também pode usar a API da Databricks para importar e exportar painéis de forma programática. Consulte POST /api/2.0/workspace/import.

Exportar um arquivo de painel

  • Em um painel de rascunho, clique no menu Menu Kebab kebab no canto superior direito da tela e, em seguida, clique em Export dashboard (Exportar painel).

  • Confirme ou cancele a ação usando a caixa de diálogo Export dashboard. Quando a exportação é bem-sucedida, um arquivo .lvdash.json é salvo no diretório default download do seu navegador da Web.

Importar um arquivo de painel

  • Na página de listagem de Dashboards, clique em Seta azul para baixo> Importar dashboard do arquivo.

  • Clique em Choose file (Escolher arquivo ) para abrir a caixa de diálogo do arquivo local e selecione o arquivo .lvdash.json que deseja importar.

  • Clique em Import dashboard (Importar painel ) para confirmar e criar o painel.

O painel importado é salvo na pasta do usuário. Se já existir um painel importado com o mesmo nome nesse local, o conflito será resolvido automaticamente com a inclusão de um número entre parênteses para criar um nome exclusivo.

Substituir um dashboard de um arquivo

  • Em um painel de rascunho, clique no menu Menu Kebab kebab no canto superior direito da tela e, em seguida, clique em Replace dashboard (Substituir painel).

  • Clique em Escolher arquivo para abrir a caixa de diálogo de arquivo e selecione o arquivo .lvdash.json a ser importado.

  • Clique em Overwrite para substituir o dashboard existente.

Gerenciar painéis com a API REST

Consulte Usar Databricks APIs para gerenciar dashboards para obter um tutorial que demonstra como usar Databricks REST APIs para gerenciar dashboards. O tutorial incluído explica como converter painéis herdados em painéis Lakeview, além de como criá-los, gerenciá-los e compartilhá-los.