Painéis

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. Quando publicados, seus painéis podem ser compartilhados com qualquer pessoa registrada em seu site Databricks account, mesmo que ela não tenha acesso ao site workspace. Consulte Compartilhar um painel.

Observação

AI/BI (anteriormente Lakeview dashboards) estão agora 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 AI/BI para obter instruções sobre como usar a ferramenta de migração integrada. Consulte o tutorial do Dashboard para obter um tutorial sobre a criação e o gerenciamento de dashboards usando o site REST API.

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 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 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.

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. O senhor não pode compartilhar painéis de rascunho com usuários fora do site workspace. Todos os usuários usam suas 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.

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 à direita do nome dataset para renomear, clonar ou excluir. O senhor também pode download o dataset como um arquivo CSV, TSV ou Excel.

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, caixa, 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.

Parâmetros estáticos do widget

Os parâmetros permitem que o senhor substitua valores diferentes nas consultas do site dataset em tempo de execução. Para saber como configurar parâmetros em suas consultas, consulte Trabalhar com parâmetros do painel.

Os parâmetros do widget estático são configurados diretamente em um widget de visualização, permitindo que os autores reutilizem o conjunto de dados e apresentem diferentes visões do mesmo conjunto de resultados em diferentes widgets de visualização. Por exemplo, considere um site dataset que mostra as tendências de vendas ao longo do tempo em todas as regiões comerciais. Para comparar as tendências entre a Região A e a Região B, o senhor pode criar duas visualizações com o mesmo tipo de gráfico que fazem referência ao mesmo dataset. Ao adicionar um parâmetro a cada visualização e selecionar o valor específico a ser exibido, o senhor pode mostrar a comparação em seu painel. Os parâmetros estáticos do widget não são interativos, portanto, a visualização do painel não pode ajustar seus valores.

Consulte Parâmetros estáticos do widget para obter um exemplo.

Para saber mais sobre a configuração de parâmetros em widgets de filtro, consulte Filtro em parâmetros.

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.

Adicione imagens aos widgets de texto

Use um dos métodos a seguir para adicionar imagens ao seu painel. Cada método inclui uma amostra de sintaxe de marcação que é editada para exibir sua imagem. Para redimensionar uma imagem, ajuste as dimensões do widget.

• De um volume:

  <WorkspaceURL>/ajax-api/2.0/fs/files/<Volumes/path/to/image>
  

  Substitua o texto de amostra deste exemplo pelo URL do seu espaço de trabalho e pelo caminho da imagem armazenada em um volume.

  Use os seguintes passos para obter o caminho para sua imagem:

  1. Clique em Catálogo na barra lateral para abrir a interface do usuário do Catalog Explorer.

  2. Clique no arquivo de imagem no navegador do esquema.

  3. Clique no menu kebab à direita do nome do arquivo. Em seguida, clique em Copiar caminho.

  Consulte O que são volumes do Unity Catalog? para saber mais sobre o armazenamento de dados em volumes.

• Imagens hospedadas publicamente:

  ![description](URL)` where the URL publicly hosted on the internet.
  

Substitua o texto de amostra pela descrição e pelo URL da imagem que você deseja mostrar. 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 obter mais informações sobre a sintaxe do markdown, consulte este guia.

Observação

Quando você publica seu painel com credenciais incorporadas, os espectadores usam suas credenciais para acessar as imagens incluídas. Se os seus painéis não forem publicados com credenciais incorporadas, será necessário conceder explicitamente acesso aos usuários para os arquivos de imagem armazenados no Databricks. Use o Catalog Explorer para verificar, conceder e revogar permissões nos arquivos de imagem que você deseja incluir. Clique em Catálogo na barra lateral para abrir a interface do usuário do Catalog Explorer.

Filtros

Os filtros são widgets de painel que ajudam os visualizadores a restringir os resultados e refinar os dados nas visualizações, de forma semelhante aos slicers em outras ferramentas de BI. O senhor pode configurá-los para filtrar valores com base em uma ou mais colunas (também chamadas de campos) do site dataset ou em parâmetros definidos nas consultas do site SQL que criam o conjunto de dados. Os filtros e parâmetros de campo podem ser combinados em um único widget ao usar parâmetros baseados em consultas. Consulte Usar parâmetros baseados em consulta para saber como aplicar um parâmetro baseado em consulta.

Definir valores padrão

O senhor pode definir um valor default em um widget para a maioria dos tipos de filtro, conforme indicado nas listas de tipos de filtro a seguir. Para isso, selecione um valor no menu suspenso de valor padrão 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 otimização e armazenamento em cache do conjunto de dados.

Filtrar por campos

Os filtros de campo refinam os dados apresentados nas visualizações, filtrando campos específicos do site dataset. Por exemplo, um filtro de campo pode limitar os dados a um determinado intervalo de datas com base em um campo de data em um site dataset. Os filtros podem ser aplicados aos 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. Quando você seleciona um valor para um filtro, ele pode alterar dinamicamente os valores disponíveis mostrados nos menus suspensos de outros filtros. A imagem a seguir mostra um painel de configuração de filtro definido para filtrar em dois campos.

Os painéis são compatíveis com os seguintes tipos de filtro para filtragem em um campo:

• Valor único

• Valores múltiplos

• Selecionador de datas

• Seletor de intervalo de datas

• Entrada de texto

• Controle deslizante de intervalo (não aceita valores de default )

Filtrar por parâmetros

Ao contrário dos filtros de campo, que filtram diretamente os campos de dados, os filtros de parâmetro alteram a própria consulta SQL, permitindo ajustes dinâmicos na consulta com base na entrada do usuário. 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 Trabalhar com parâmetros do painel.

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

• Valor único

• 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.

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.

Filtragem cruzada

A filtragem cruzada permite que os usuários se aprofundem em um subconjunto selecionado de dados e explorem interativamente relacionamentos e padrões em várias visualizações. Quando um visualizador de painel clica em um elemento de um gráfico, todos os outros gráficos baseados no mesmo dataset são automaticamente filtrados por esse valor.

Como editor de painel, configure a filtragem cruzada criando dois ou mais gráficos que compartilhem o mesmo dataset. Os tipos de gráfico a seguir permitem que os visualizadores filtrem o site dataset clicando em um elemento do gráfico:

• Barras

• Mapa de calor

• Pizza

• Dispersão

Após a seleção, todas as outras visualizações baseadas no mesmo site dataset serão automaticamente atualizadas com os valores filtrados.

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 no canto superior direito do widget.

• Para abrir as opções do download em um Data tab, clique no menu 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.

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.

Habilite um espaço Genie em seu painel de controle

Visualização

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

Quando o senhor cria um painel, um rascunho do espaço genie é criado automaticamente para o senhor. O espaço genie é uma interface sem código que permite que os usuários corporativos realizem análises de dados de autoatendimento usando linguagem natural. A publicação de um espaço genie associado permite que os visualizadores explorem os dados do painel de uma maneira diferente. Em vez de obter percepções baseadas apenas no que está disponível em um painel, eles se envolvem com os dados fazendo suas próprias perguntas para uma análise mais profunda. Consulte Trabalhar com um espaço AI/BI Genie.

O espaço de rascunho genie permanece em sincronia com seu painel de rascunho à medida que o senhor adiciona e remove conjuntos de dados e visualizações. O senhor pode usar o rascunho do espaço genie para visualizar e interagir com seu espaço genie antes de publicá-lo.

Para visualizar seu rascunho genie space:

1. Clique no menu de kebab no canto superior direito do seu painel.

2. Clique em Abrir o espaço de rascunho genie .

Observação

O senhor não pode editar as instruções para esse espaço genie na interface do usuário do espaço genie. Seu espaço de rascunho genie só muda quando o senhor faz alterações no painel de rascunho.

Ao publicar seu painel, o senhor pode disponibilizar esse espaço genie para os visualizadores. Isso adiciona um botão Ask genie que vincula a uma cópia publicada do espaço genie onde os usuários podem fazer perguntas de acompanhamento.

Para controlar se o espaço genie está disponível em seu painel publicado:

1. Clique em Publicar.

2. A opção Enable genie é ativada por default. Clique no botão para ativá-lo ou desativá-lo.

3. Clique em Publicar.

Observação

Os espaços genie rascunho e publicado são independentes, assim como as versões rascunho e publicada de seu painel. Todas as alterações feitas no rascunho do painel são refletidas no espaço genie publicado somente quando o painel é republicado. Os espaços genie publicados e em rascunho são acompanhados em seu painel. Eles não aparecem em seu navegador de arquivos ou na página de listagem genie.

Compartilhar um painel

O senhor pode compartilhar painéis de forma segura com qualquer pessoa em seu site account. Para os usuários atribuídos ao seu workspace, o senhor pode conceder acesso e definir níveis de permissão variados, como faria com outros objetos do workspace. Para os usuários que não estão atribuídos ao seu workspace, é possível compartilhar painéis no nível account, permitindo que os usuários registrados acessem view e executem seu painel.

Para obter detalhes sobre como os administradores podem configurar o site account para compartilhamento no nível account, consulte o Guia de administração do painel. Para obter detalhes sobre como compartilhar seu painel nos níveis account e workspace, consulte Compartilhar um painel.

Incorpore painéis em sites e aplicativos

Visualização

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

Você pode incorporar seu painel publicado em sites e aplicativos externos usando um iframe. Consulte Incorporar um painel.

Se o senhor for um administrador do workspace e quiser gerenciar os sites externos nos quais os painéis podem ser incorporados, consulte gerenciar a incorporação de painéis.

programar e inscrição

O senhor pode configurar atualizações programadas para refresh automaticamente o cache do seu painel e, opcionalmente, enviar um e-mail com um PDF do painel mais recente para os usuários 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.

Veja gerenciar atualizações programadas do painel e inscrição.

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.

As seções a seguir explicam como exportar e importar painéis 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 painéis, clique em > Importar painel 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 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.

O senhor também pode gerenciar painéis usando o Terraform. Para obter detalhes, consulte a documentação do Databricks Terraform.