Amazon
Web Services
Microsoft Azure
Google Cloud PlatformPainéis
O senhor pode usar painéis para criar visualizações de dados e compartilhar percepções de dados informativos com sua equipe. A versão mais recente dos painéis apresenta 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.
Observação
Os painéis (anteriormente denominados painéis do Lakeview) agora estão disponíveis de forma geral.
Os painéis originais do site Databricks SQL agora são chamados de painéis legados. Eles continuarão a receber suporte e serão atualizados com correções de bugs críticos, mas as novas funcionalidades serão limitadas. O senhor pode continuar a usar os painéis antigos para criação e consumo.
Converta painéis antigos usando a ferramenta de migração ou a API REST. Consulte Clonar um painel legado em um painel do Lakeview para obter instruções sobre como usar a ferramenta de migração integrada. Consulte Use Databricks APIs para gerenciar dashboards para obter um tutorial sobre como criar e gerenciar dashboards usando o REST API.
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.
Observação
O senhor pode definir até 100 conjuntos de dados por painel. O Canvas pode conter até 100 widgets por dashboard.
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.
Observação
Consulte Clonar um painel legado em um painel do Lakeview para criar um novo painel a partir de um painel legado existente. Para migrar uma consulta individual do site Databricks SQL para um novo painel, use a opção + Create from SQL (Criar a partir de ) nos dados tab do seu painel. Copie e cole o texto da consulta Databricks SQL no editor.
Depois de definir um dataset, o senhor pode usar o 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.
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.
Use o Databricks Assistant: crie visualizações descrevendo o gráfico que o senhor deseja ver em linguagem natural e deixe o assistente gerar 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 no painel de configuração. 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
Os widgets de visualização permanecem em branco até que o senhor descreva o gráfico desejado ou escolha as definições de configuração para definir o dataset, o tipo de gráfico e os valores que deseja representar.
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:
de um URL disponível publicamente. Por exemplo, a marcação a seguir inserirá uma imagem do logotipo da Databricks:. 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:
. Para redimensionar a imagem, redimensione as dimensões do widget. Para obter mais informações sobre DBFS, consulte O que é o sistema de arquivos Databricks (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 filtrem em um campo ou definam parâmetros dataset. Cada widget de filtro pode ser configurado para filtrar nos campos dataset ou para atribuir valores a parâmetros predefinidos em uma consulta dataset. Um único widget de filtro não pode usar campos e parâmetros simultaneamente.
Filtrar por campos
Os painéis suportam os seguintes tipos de filtro para campos de filtragem:
Seleção única dropdown
Seleção múltipla dropdown
TEXT
Data
Intervalo de datas
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 filtros do painel sempre se aplicam a todo o site dataset. Se o site dataset for pequeno, o filtro do painel 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.
Filtrar por parâmetros
Se um filtro estiver conectado a um parâmetro, ele executará uma consulta no site SQL warehouse, independentemente do tamanho do dataset.
Os painéis suportam os seguintes tipos de filtros para a definição de parâmetros:
String
Data
Data e hora
Decimal
Inteiro
Consulte Usar parâmetros do dashboard.
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.
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.
Resultados do download
O senhor pode usar o conjunto de dados download como arquivos CSV, TSV ou Excel. Em um painel de rascunho, acesse as opções do download em Data tab ou clique com o botão direito do mouse em uma visualização na tela.
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.
Para painéis publicados, os visualizadores podem fazer download dos resultados clicando com o botão direito do mouse em uma visualização.
workspace os administradores podem ajustar suas configurações de segurança para impedir que os usuários façam downloads de resultados com os seguintes passos:
Clique no seu nome de usuário na barra superior do site Databricks workspace e selecione Settings (Configurações).
Clique em Security.
Desative a opção de download dos resultados do SQL.
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 no seu site workspace para colaborar. Todos os usuários usam suas próprias credenciais para interagir com os dados e as visualizações nos rascunhos do painel.
Para obter mais informações sobre os níveis de permissão, consulte ACLs do Dashboard.
Publicar um painel
Publique um painel para criar uma cópia limpa do painel atual que pode ser compartilhada com qualquer usuário em seu site Databricks workspace. Depois de publicar seu painel, a versão publicada permanece inalterada e acessível para compartilhamento até que o senhor publique novamente. O senhor pode continuar fazendo modificações e melhorias em uma versão de rascunho sem afetar a cópia compartilhada publicamente.
A publicação não compartilha automaticamente os painéis com os usuários. É possível compartilhar explicitamente painéis com permissões view para usuários ou grupos.
O senhor deve ter pelo menos permissões de Can Edit para publicar um painel.
Abra um painel.
No menu suspenso Compartilhar, no canto superior direito, clique em Publicar. A caixa de diálogo Publicar é exibida.
Escolha as credenciais a serem usadas para o painel publicado. Opcionalmente, o senhor pode optar por incorporar suas credenciais.
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 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. Os visualizadores precisam acessar o site workspace, o anexo SQL warehouse e os dados associados aos resultados do view no painel.
Clique em Publicar.
O senhor pode compartilhar o painel publicado com qualquer usuário em seu site Databricks workspace. Para saber mais sobre como controlar o acesso ao painel, consulte ACLs do painel.
Para acessar o painel publicado, clique em Publicado no menu suspenso próximo à parte superior do painel.
Programar painéis de controle para atualizações periódicas
O senhor pode configurar atualizações programadas para refresh automaticamente seu painel e enviar periodicamente e-mails com os dados mais recentes para seus assinantes.
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:
Clique em programar no canto superior direito do painel. A caixa de diálogo Add programar é exibida.
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.
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á.
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.
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:
Clique em Subscribe (Assinar ) no canto superior direito do painel. A caixa de diálogo programar é exibida.
Identifique o programa ao qual o senhor deseja adicionar assinantes. Clique no link
à 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:
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.
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:
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.
Clique em Subscribed para cancelar a assinatura. O texto do botão muda para Subscribe (Assinar).
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.
workspace controles de inscrição de administradores
workspace Os administradores podem impedir que os usuários distribuam dashboards usando a inscrição.
Para evitar o compartilhamento das atualizações do email:
Clique no seu nome de usuário na barra superior do site Databricks workspace e selecione Settings (Configurações).
Clique em Notifications (Notificações).
Desative a opção Enable dashboard email inscrição.
A alteração dessa configuração impede que todos os usuários adicionem assinantes do email. Os editores de painel não podem adicionar assinantes e os visualizadores de painel não têm a opção de se inscrever em um painel.
Se essa configuração estiver desativada, as inscrições existentes serão pausadas e ninguém poderá modificar as listas de inscrições existentes. Se essa configuração for ativada novamente, a inscrição voltará a usar a lista existente.
Limites de tamanho do painel para inscrição
O e-mail de inscrição do painel inclui os seguintes arquivos codificados em base64:
PDF: Um arquivo PDF que inclui o painel completo.
DesktopImage: Um arquivo de imagem otimizado para visualização em um computador de mesa.
MobileImage: Um arquivo de imagem otimizado para visualização em dispositivos móveis.
Um limite máximo de 9 MB é imposto ao tamanho combinado dos três arquivos. As descrições a seguir descrevem o comportamento esperado quando o tamanho do arquivo combinado excede o limite:
Se o arquivo PDF tiver mais de 9 MB: a inscrição email não inclui o anexo em PDF ou quaisquer imagens. Ele inclui uma nota que diz que o painel excedeu o limite de tamanho e mostra o tamanho real do arquivo do painel atual.
Se o tamanho combinado dos arquivos PDF e DesktopImage for maior que 9 MB: somente o PDF será anexado ao site email. A mensagem em linha inclui um link para o painel, mas nenhuma imagem em linha para visualização em celular ou desktop.
Se o tamanho combinado de todos os arquivos for maior que 9 MB: a MobileImage será excluída do site email.
Transferir a propriedade de um painel
Se o senhor for um administrador do workspace, poderá transferir a propriedade de um painel para outro usuário.
Vá para a lista de painéis. Clique em um nome de painel para editar.
Clique em Compartilhar.
Clique no ícone
no canto superior direito da caixa de diálogo de compartilhamento. 
Comece a digitar um nome de usuário para pesquisar e selecionar o novo proprietário.
Clique em Confirmar.
O novo proprietário aparece na caixa de diálogo de compartilhamento com as permissões CAN MANAGE. Para acessar o site view dashboards listados por proprietário, vá para a lista de dashboards disponíveis selecionando 
.
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
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
> 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.jsonque 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
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.jsona ser importado.Clique em Overwrite para substituir o dashboard existente.
O que é share to account?
O compartilhamento do painel em account permite que os usuários compartilhem painéis publicados com usuários e grupos fora do site workspace, onde o painel foi elaborado.
Adicionar usuários ao site Databricks account não é o mesmo que adicioná-los a um site workspace. Quando os usuários são adicionados a um account, suas credenciais não lhes concedem acesso automático a um workspace, dados ou compute recurso. Em vez disso, o registro estabelece sua identidade dentro do sistema, que a Databricks usará posteriormente para verificar se os painéis compartilhados estão disponíveis apenas para os destinatários pretendidos.
A imagem a seguir mostra um exemplo de como os painéis publicados podem ser compartilhados em vários espaços de trabalho e no nível account.
Os painéis publicados podem ser compartilhados com o seguinte:
Um ou mais usuários específicos atribuídos ao site de origem workspace.
workspace grupos (incluindo todos os usuários do workspace ).
Um ou mais usuários específicos no site Databricks account.
Databricks account grupos (incluindo todos os usuários do account ).
Para obter mais informações sobre usuários e relações de grupo em seu Databricks account, consulte Como os administradores atribuem usuários ao espaço de trabalho?
Importante
Dashboard account compartilhamento requer que o login unificado com logon único (SSO) esteja ativado. Para obter mais informações, consulte Login unificado.
Como compartilhar um painel com outros usuários da conta Databricks
Os painéis de rascunho não podem ser compartilhados com usuários fora do site workspace. Os painéis publicados podem ser compartilhados com usuários e grupos do Databricks account . A adição de usuários e grupos a um Databricks account não atribui automaticamente nenhuma permissão a workspace, dados ou compute. Consulte gerenciar usuários, entidades de serviço e grupos para obter detalhes sobre o gerenciamento de identidade com Databricks.
Use os seguintes passos para publicar e compartilhar seu painel com os usuários do account.
Navegue até o painel de rascunho.
Publique o painel com a configuração Embed credentials (default ).
Incorporar suas credenciais significa que o site SQL warehouse e as consultas usam os dados do editor e as permissões do warehouse para atualizar o painel publicado. Isso é necessário se o senhor quiser compartilhar com usuários fora do site de origem workspace, pois eles não têm suas próprias credenciais.
Clique no botão Share e use a caixa de diálogo de compartilhamento para definir permissões para usuários e grupos no site Databricks account.
Na parte superior da caixa de diálogo de compartilhamento, insira workspace users, workspace groups, specific account users ou account groups.
Para os usuários do seu site workspace, é possível atribuir as permissões Can gerenciar, Can Edit, Can execute ou Can view. account os usuários estão limitados ao acesso Can view, mesmo que tenham recebido uma permissão mais alta no modal Share.
Para atribuir rapidamente o acesso a view a todos os usuários de account, use a opção de configurações de compartilhamento na parte inferior da caixa de diálogo de compartilhamento.
Compartilhe o link com os usuários.
Clique em Copiar link na parte inferior da caixa de diálogo de compartilhamento para copiar um URL compartilhável para o painel publicado.
Observação
Os usuários que não têm acesso ao workspace estão limitados às permissões do Can view. Se o senhor conceder permissões elevadas, como Can Edit, a um usuário que não tenha acesso ao site workspace, as permissões aparecerão na interface do usuário, mas não serão realmente aplicadas até que o usuário seja adicionado ao site workspace.
Para obter mais informações sobre os níveis de permissão do dashboard, consulte Dashboard ACLs.
Considerações sobre a rede
Se as listas de acesso IP estiverem configuradas, um painel publicado no account só poderá ser acessado pelos usuários do account se eles o acessarem de dentro do intervalo de IP aprovado, como, por exemplo, ao usar uma VPN. Para obter mais informações sobre como configurar o acesso, consulte Gerenciar listas de acesso IP.
Monitorar a atividade de Lakeview
Os administradores podem monitorar a atividade nos painéis usando logs de auditoria. Consulte Eventos de painéis.
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.
