Painéis

Você pode usar painéis para criar visualizações de dados e compartilhar relatórios com sua equipe. Os painéis de IA/BI apresentam criação assistida por IA, uma biblioteca de visualização aprimorada e uma experiência de configuração simplificada para que você possa transformar rapidamente dados em insights compartilháveis. Quando publicados, seus dashboards podem ser compartilhados com qualquer pessoa registrada em sua conta do Azure Databricks, mesmo que não tenham acesso ao workspace. Veja Compartilhar um painel.

Importante

O Databricks recomenda o uso de painéis de IA/BI (anteriormente painéis do Lakeview). Versões anteriores de dashboards, anteriormente conhecidas como painéis SQL do Databricks, agora são chamadas de painéis herdados.

Cronograma de fim de suporte:

• 12 de janeiro de 2026: Painéis herdados e APIs não são mais acessíveis diretamente. No entanto, você ainda pode convertê-los em painéis de IA/BI. A página de migração está disponível até 2 de março de 2026.

Converta painéis legados usando a ferramenta de migração ou API REST. Consulte Clonar um painel legado para um painel de IA/BI para obter instruções sobre como usar a ferramenta de migração integrada. Consulte Usar APIs do Azure Databricks para gerenciar painéis para tutoriais sobre como criar e gerenciar dashboards usando a API REST.

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

• Dados: a guia Dados permite que os usuários definam conjuntos de dados para uso no painel. Os conjuntos de dados são agrupados com painéis ao compartilhá-los, importá-los ou exportá-los usando a interface do usuário ou a API.
• Canvas: a guia Canvas pode ser organizada em relatórios de várias páginas. Os editores de painéis podem criar e configurar seus painéis adicionando widgets como visualizações, filtros, texto e imagens.

Para obter informações sobre o número de conjuntos de dados, páginas e widgets que cada painel pode conter, consulte os limites do Painel.

Exibir e organizar painéis de controle

Você pode acessar painéis no navegador do workspace junto com outros objetos do Azure Databricks.

• Clique em Workspace na barra lateral para exibir os painéis no navegador do workspace. Os painéis são armazenados no diretório /Workspace/Users/<username> por padrão. Os usuários podem organizar os dashboards em pastas no navegador do espaço de trabalho, juntamente com outros objetos do Azure Databricks. Consulte o navegador do espaço de trabalho.

• Para exibir a página de listagem de painéis, clique em Painéis na barra lateral.

  Por padrão, a página de listagem de painéis mostra os painéis aos quais você tem acesso classificados em ordem cronológica inversa. Você pode filtrar a lista inserindo texto na barra de pesquisa, filtrando pela última modificação dentro de um período de tempo, ou filtrando por proprietário.

  Você pode pesquisar nomes de painéis de controle, nomes de páginas, títulos e descrições de widgets e nomes de bases de dados. Ao usar a barra de pesquisa do workspace, você também pode pesquisar em consultas de conjunto de dados.

• Clique no título de um painel para abri-lo. Se o painel já tiver sido publicado, 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 do painel, clique em Criar próximo ao canto superior direito da página.

Excluir um dashboard

Para excluir um painel:

1. Abra o painel do rascunho.
2. Clique no Menu kebab no canto superior direito do painel.
3. Clique em Ações de arquivo>Mover para o lixo.

O conteúdo da pasta Lixeira é automaticamente excluído permanentemente após 30 dias.

Você também pode organizar e excluir painéis da sua localização na pasta do workspace. Consulte Excluir um objeto.

Rascunho e colaborar em um painel

Novos painéis são abertos como rascunhos. As alterações em um painel de rascunho são salvas automaticamente, mas elas não são sincronizadas automaticamente com a versão publicada se ela existir. Para obter detalhes sobre a publicação de painéis, consulte Publicar um painel.

Para descartar edições e restaurar o rascunho para a versão publicada mais recentemente, clique no Menu kebab no canto superior direito do painel e clique em Descartar alterações.

Você pode colaborar em um rascunho compartilhando-o com os usuários em seu workspace. Os usuários com acesso interagem com o painel usando suas próprias credenciais. Você não pode compartilhar painéis de rascunho com usuários fora do workspace. Para obter mais informações sobre níveis de permissão, consulte ACLs do Painel.

Publicar um painel

A publicação de um dashboard cria uma cópia limpa do rascunho atual. As credenciais de computação do editor são inseridas no painel publicado e usadas para processar todas as atualizações subsequentes, independentemente de qual usuário ou serviço inicie a atualização. Você precisará ter, no mínimo, permissões CAN EDIT para publicar um painel.

Após a publicação, a versão publicada permanecerá inalterada até que você publique novamente, mesmo que você faça alterações no rascunho. É possível fazer modificações e melhorias na versão de rascunho sem afetar a cópia publicada. Os usuários registrados com acesso podem exibir a versão publicada e ela continuará sendo enviada por email aos assinantes, se houver. Para obter mais informações sobre como gerenciar o acesso ao painel, consulte Compartilhar um painel.

Os painéis publicados não têm versão e não devem ser usados ​​para controle de versão. Você pode reverter um painel de rascunho para a última versão publicada. Veja Criar rascunho e colaborar em um painel.

Ao publicar, escolha uma das seguintes opções:

• Permissão de compartilhamento de dados (padrão): os visualizadores executam consultas usando as permissões de dados do editor. Isso permite que os usuários exibam o painel mesmo que não tenham acesso direto aos dados subjacentes. Isso pode expor dados a usuários que não receberam acesso direto a ele. Essa é a opção padrão.
• Permissão de dados individual:
  • Os visualizadores executam consultas usando suas próprias credenciais. Suas permissões de dados determinam quais resultados eles podem ver e devem ter acesso aos dados subjacentes.
  • O acesso à computação sempre é concedido pelas credenciais do editor.

Observação

Todos os visualizadores de dashboard devem se autenticar para acessar o painel, independentemente da configuração de credencial. Para alterar as configurações de credenciais, republicar o painel com sua seleção atualizada.

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

Para publicar um painel, siga estas etapas:

1. Abra um painel de controle. 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 de rascunho atual.
2. Clique em Publicar. A caixa de diálogo Publicar é exibida.
3. Escolha as credenciais a serem usadas no painel publicado. Você pode optar por compartilhar com permissões de dados ou não.
4. (Opcional) Selecione Notificar os visualizadores se você quiser enviar uma notificação por email aos visualizadores do painel sobre a atualização. Por padrão, essa opção é desativada para evitar notificações não intencionais.
5. Clique em Publicar. Se o painel estiver sendo publicado pela primeira vez, uma caixa de diálogo de compartilhamento será aberta e solicitará que você compartilhe o painel publicado. Consulte Compartilhar um painel para obter detalhes e recomendações sobre o compartilhamento.

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

Usar uma entidade de serviço para publicar e compartilhar painéis

Use a API REST para publicar e compartilhar painéis com permissões de dados compartilhadas associadas a uma entidade de serviço. Quando os usuários executam chamadas de API com o token da entidade de serviço, eles acessam dados sob as permissões da entidade de serviço. Essa configuração permite que os usuários que não têm permissões de computação ou dados diretos exibam o painel e executem consultas, desde que estejam registrados na sua conta do Azure Databricks.

Para publicar um dashboard com credenciais de entidade de serviço, primeiro você se autentica como a entidade de serviço para obter um token de acesso OAuth e, em seguida, usa esse token para chamar o endpoint da API de publicação do dashboard com embed_credentials definido como true. O painel é publicado com as credenciais da entidade de serviço inseridas, permitindo que os visualizadores acessem o painel sem exigir permissões diretas para os dados subjacentes ou recursos de computação.

Para obter instruções passo a passo e exemplos de API, consulte Publicar um painel com credenciais de entidade de serviço. Para obter detalhes adicionais sobre como usar a API REST para gerenciar dashboards, consulte Lakeview na referência da API REST.

Baixar um painel publicado

Depois que um Painel de Controle publicado for carregado, use as seguintes etapas para baixá-lo como um PDF:

• Clique no Próximo ao canto superior direito do painel.
• Clique em Baixar como PDF.

Definir os conjuntos de dados

Use a guia Dados para definir os conjuntos de dados subjacentes para o painel.

Você pode definir conjuntos de dados como um dos seguintes elementos:

• Uma nova consulta em uma ou mais tabelas ou exibições.
• Uma tabela ou visão do Unity Catalog.

Ao selecionar tabelas ou exibições na caixa de diálogo de seleção de ativos, você pode passar o mouse sobre um ativo para visualizar seu esquema e metadados, incluindo o proprietário e a hora da última atualização. Isso ajuda a identificar rapidamente a fonte de dados certa para o painel.

Observação

Cada conjunto de dados é definido por uma consulta. Para a maioria das tabelas e exibições, a consulta padrão para esse conjunto de dados é uma SELECT * instrução na tabela ou exibição. Você pode modificar a consulta para refinar o conjunto de dados. Para exibições de métrica, você não pode editar a definição de exibição. No entanto, você pode adicionar cálculos personalizados para visualizar novas medidas e dimensões para o painel. Veja o que são cálculos personalizados?.

Você pode criar vários conjuntos de dados por meio da adição de consultas ou da seleção de tabelas ou exibições adicionais. Para ajustar a ordem de exibição dos conjuntos de dados, arraste e solte os nomes na posição desejada.

Importante

Todos os dados retornados por uma consulta de conjunto de dados são acessíveis aos visualizadores de painel, mesmo que nem todos os campos ou linhas apareçam em visualizações. Para evitar expor dados confidenciais, defina cuidadosamente o escopo do seu SQL. Use a seleção de coluna explícita, WHERE cláusulas e parâmetros para garantir que apenas os dados pretendidos sejam incluídos no conjunto de dados. Consulte Restringir os resultados do conjunto de dados usando o SQL.

Para formatar uma consulta no editor do conjunto de dados, clique com o botão direito do mouse no editor e selecione Formatar documento. Para personalizar como as consultas SQL são formatadas, consulte instruções SQL de formato personalizado.

Para obter mais detalhes sobre como criar e gerenciar conjuntos de dados do painel, consulte Criar e gerenciar conjuntos de dados do painel.

Adicionar páginas, visualizações, texto e filtros à tela

Use a guia Tela para criar seu painel. Você pode adicionar visualizações, texto e widgets de filtro a cada página. Use várias páginas para organizar sua apresentação de conteúdo, minimizar a rolagem e melhorar a legibilidade do painel. Use a barra de ferramentas na parte inferior de cada página para adicionar widgets, como visualizações, caixas de texto e filtros.

Criar relatórios de várias páginas

Os novos painéis começam com uma única página chamada página Sem título. Para editar o nome de uma página, clique duas vezes no título e insira o novo nome no campo de texto. Os conflitos de nomenclatura são resolvidos automaticamente anexando um número ao título. Para obter informações sobre limites de página, consulte os limites do painel.

Para exibir o conteúdo de uma página, clique no título para selecioná-lo.

Adicionar e remover páginas

Para adicionar uma nova página:

• Clique em à direita do título da página atual na tela. Por padrão, sua nova página é chamada de página sem título.
• (Opcional) Clique duas vezes no título da página e insira um novo nome para renomeá-la.

Para remover uma página:

• Clique no Menu kebab à direita do título da página.
• Clique em Excluir para excluir a página.

Observação

A exclusão de uma página também exclui todos os widgets dessa página. Se você excluir todas as páginas, clique em Criar uma página para começar a compilar seu painel novamente.

Clonar uma página

Para clonar uma página:

1. Clique no título da página para selecioná-lo.
2. Clique no no bloco de título e depois clique em Clonar.

A nova página é uma cópia exata do original, incluindo todos os widgets. Os conjuntos de dados subjacentes permanecem inalterados.

Copiar páginas entre painéis de controle

Você pode copiar uma página de um painel e colá-la em outro painel.

Para copiar uma página para outros painéis de controle:

1. No painel de origem, clique no nome da página na barra de abas da página para selecioná-la.
2. Pressione Command-C (Mac) ou Ctrl-C (Windows/Linux) para copiar a página.
3. Navegue até o painel de destino e verifique se ele está no modo de rascunho.
4. Pressione Command-V (Mac) ou Ctrl-V (Windows/Linux) para colar a página.

A página colada inclui todos os widgets da página original. Todos os conjuntos de dados usados pela página são criados como novos conjuntos de dados no painel de destino, garantindo que a página funcione de forma independente.

Visualizações

Crie uma visualização adicionando um widget de visualização a uma página na tela. As visualizações com suporte incluem área, barra, caixa, coorte, combinação, contador, funil, mapa de calor, histograma, linha, pizza, pivô, sankey, dispersão e tipos de gráfico de tabela. Para obter uma lista completa de tipos de visualização disponíveis e valores de configuração de exemplo, consulte os tipos de visualização do painel de IA/BI.

Observação

As consultas usadas por visualizações nem sempre correspondem precisamente ao conjunto de dados. Por exemplo, se você aplicar agregações a uma visualização, a visualização mostrará os valores agregados.

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

• Visualizações assistidas por IA: descreva o gráfico que você deseja ver em linguagem natural e permita que o Assistente do Databricks gere um gráfico. Depois de criado, você pode modificar o gráfico gerado usando o painel de configuração. Você não pode usar o Assistente para criar os tipos de gráfico de tabela ou tabela dinâmica.
• Use o painel de configuração: aplique agregações adicionais ou compartimentos de tempo na configuração de visualização sem modificar o conjunto de dados diretamente. Você pode escolher um conjunto de dados, valores do eixo x, valores do eixo y e cores.

Para obter detalhes sobre como aplicar formatação personalizada aos seus gráficos, consulte Visualizações do Painel. Consulte as opções de Tabela para saber como controlar a apresentação de dados em visualizações de tabela.

Observação

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

Gerar uma previsão

Use a Previsão de IA (Visualização Pública) para aplicar a previsão preditiva a gráficos de linhas para visualizar tendências e padrões futuros. O gráfico de linhas deve ter um campo de data temporal no eixo x e um único campo numérico no eixo y.

Para criar um gráfico com previsão de IA:

• Com o gráfico de linhas selecionado, clique + na seção Previsão do editor de visualização.
• Clique em Clonar com Previsão de IA na caixa de diálogo exibida. Um novo gráfico de linhas é criado com a previsão aplicada.

Para saber mais sobre a função que gera a previsão, consulte ai_forecast função.

Solução de problemas de visualizações

A edição de um conjunto de dados pode fazer com que uma visualização configurada anteriormente exiba uma mensagem de erro. Isso pode acontecer quando os campos do conjunto de dados são removidos ou renomeados. Se a visualização mostrar um erro, tente as seguintes ações:

• Atualize o painel.
• Clique em Mostrar erro no widget de visualização para exibir uma mensagem de erro detalhada que pode ajudar a identificar problemas no conjunto de dados.
• Examine o SQL usado para gerar o conjunto de dados associado à visualização.
• Remova todos os filtros quebrados que referenciam o conjunto de dados.
• Remova quaisquer outras visualizações que usem o conjunto de dados.

Widgets de texto

Os widgets de texto permitem adicionar texto formatado, links e imagens aos dashboards. Arraste um widget de texto para a tela e clique duas vezes nele para iniciar a edição.

Use a barra de ferramentas de formatação para definir o estilo de conteúdo das seguintes maneiras:

• Estilo de texto: ajuste o estilo de bloco, o estilo da fonte, o tamanho da fonte e a cor da fonte.
• Inserir links: clique no ícone de link para abrir o editor de link. Insira a URL e o texto do link a ser exibido no widget.
• Inserir imagens: clique no ícone de imagem para abrir o editor de imagens. Insira uma URL ou caminho para sua imagem e, opcionalmente, texto alt. Consulte os caminhos e URLs de imagem para ver caminhos e URLs com suporte.

Você também pode usar a sintaxe markdown para editar texto. Clique no ícone de >Mostrar markdown para exibir o widget de texto na sintaxe markdown. Para obter detalhes sobre a sintaxe de markdown básica, consulte o guia markdown.

Caminhos e URLs de imagem

Use um dos métodos a seguir para especificar uma URL ou um caminho de volume para uma imagem.

Usar um caminho de volume

Use o seguinte formato, substituindo os espaços reservados pelo nome da instância do Azure Databricks e o caminho para a imagem no volume:

https://<databricks-instance>/ajax-api/2.0/fs/files/<Volumes/path/to/image>

O nome da instância está na primeira parte da URL exibida quando você faz login no seu ambiente do Azure Databricks. Algumas implantações incluem uma ID do workspace. Não inclua a ID do espaço de trabalho ao construir o caminho. Para saber mais, confira nomes de instâncias, URLs e IDs do Workspace.

Para encontrar o caminho do volume:

1. Clique no Cataloge na barra lateral para abrir o Catalog Explorer.
2. Clique no arquivo de imagem no navegador de esquema.
3. Clique no Menu kebab ao lado do nome do arquivo e clique em Copiar Caminho.

Veja o que são volumes do Catálogo do Unity? Para saber mais sobre como armazenar dados em Volumes.

Observação

Independentemente de seu painel ser publicado com permissões de dados compartilhadas ou individuais, você deve conceder explicitamente acesso aos usuários para arquivos de imagem armazenados no Azure Databricks. Use o Explorador de Catálogos para verificar, conceder e revogar permissões nos arquivos de imagem que você deseja incluir. Clique no Cataloge na barra lateral para abrir a interface do usuário do Catalog Explorer.

Usar uma imagem hospedada publicamente

Para imagens hospedadas publicamente, insira a URL pública que aponta para a imagem.

Copiar widgets

Você pode copiar e colar widgets em um painel ou entre painéis. Depois de criar um novo widget, você pode editá-lo como faria com qualquer outro widget.

Para clonar um widget na tela do painel de rascunho, realize as seguintes etapas:

1. Clique com o botão direito do mouse em um widget.
2. Clique em Clonar.

Um clone do seu widget aparece abaixo do original.

Remover widgets

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

Atalhos do teclado

Você pode usar os seguintes atalhos de teclado ao editar painéis:

Shortcut	Ação
Command-Z (Mac) ou Ctrl-Z (Windows/Linux)	Desfazer uma ação na tela
Command-Shift-Z (Mac) ou Ctrl-Shift-Z (Windows/Linux)	Refazer uma ação na tela
Command-C (Mac) ou Ctrl-C (Windows/Linux)	Copiar um widget ou página selecionado
Command-V (Mac) ou Ctrl-V (Windows/Linux)	Colar um widget ou página no painel atual ou em um painel diferente
Delete chave	Excluir um widget selecionado

Baixar os resultados

Você pode baixar conjuntos de dados como arquivos CSV, TSV ou Excel. Você pode fazer download de visualizações na tela como arquivos PNG.

• Para abrir as opções de download na guia Tela, clique no menu kebab no canto superior direito do widget.
• Para abrir as opções de download de uma aba Dados, clique no menu kebab à direita do conjunto de dados.

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

Usar filtros

Os filtros podem ser aplicados em um nível global, no nível da página e no nível do widget. Eles ajudam os visualizadores do painel a restringir os resultados e a refinar dados em visualizações, semelhantes a segmentações de dados em outras ferramentas de BI. Você pode configurá-los para filtrar valores com base em uma ou mais colunas de conjunto de dados (também chamadas de campos) ou parâmetros definidos nas consultas SQL que criam conjuntos de dados. Para saber como configurar filtros para visualizações em um painel, consulte Usar filtros de painel.

Copiar e colar filtros

Você pode copiar e colar filtros entre a tela e o painel de filtro global para reorganizar rapidamente o layout do painel:

1. Selecione um widget de filtro na tela ou no painel de filtro global.
2. Clique com o botão direito do mouse e selecione Recortar ou Copiar ou usar atalhos de teclado (Ctrl+X ou Ctrl+C no Windows/Linux, Cmd+X ou Cmd+C no macOS).
3. Clique com o botão direito do mouse em um espaço vazio no painel de filtro global ou na tela da página.
4. Selecione Colar ou use o atalho de teclado (Ctrl+V no Windows/Linux, Cmd+V no macOS).

Esse recurso só funciona no mesmo painel. Você não pode copiar filtros em diferentes painéis.

Aplicar filtragem cruzada

Ao explorar um painel, você poderá observar tendências ou valores específicos que deseja investigar mais. A filtragem cruzada permite que os visualizadores filtrem dados do painel interagindo diretamente com visualizações. Isso ajuda a explorar dados que os filtros existentes podem não capturar e é útil para explorar padrões, exceções ou segmentos específicos sem editar manualmente controles de filtro.

Você pode usar a filtragem cruzada para:

• Concentre-se em segmentos de dados específicos selecionando valores em um ou mais gráficos.
• Analise dados hierárquicos clicando em valores agregados. Por exemplo, clique em um ano em um gráfico de barras para filtrar outras visualizações até esse ano. Em seguida, clique em um mês ou semana para continuar restringindo o escopo.

A filtragem cruzada é aplicada automaticamente a visualizações com suporte que usam o mesmo conjunto de dados.

Os seguintes tipos de gráfico dão suporte à filtragem cruzada:

• Barra
• Diagrama de caixa
• Mapa de calor
• Histograma
• Pizza
• Dispersão
• Mapa de pontos

Quando você aplica um filtro selecionando um elemento de gráfico, todas as outras visualizações com base no mesmo conjunto de dados são atualizadas automaticamente para refletir os dados filtrados.

Filtrar visualizações relacionadas

Para explorar dados usando a filtragem cruzada:

1. Clique em um ponto de dados em uma visualização, como uma barra em um gráfico de barras ou uma célula em um mapa de calor.
2. O painel aplica um filtro com base no valor selecionado.

Todas as outras visualizações que compartilham o mesmo conjunto de dados se atualizam adequadamente.

Usar drill through para filtrar dados

O detalhamento permite estruturar um relatório para que os visualizadores possam clicar em um segmento específico de dados para abrir uma página de destino filtrada por sua seleção. Quando a página de destino é aberta, qualquer visualização com base no mesmo conjunto de dados que a seleção de origem é filtrada automaticamente. Se a página de destino incluir filtros com base no mesmo conjunto de dados, esses filtros serão preenchidos automaticamente com o segmento selecionado da visualização de origem.

Os seguintes tipos de gráfico dão suporte a detalhamento:

• Barra
• Diagrama de caixa
• Mapa de calor
• Histograma
• Pizza
• Dispersão
• Mapa de pontos

Tipos de filtro e tipos de filtro de detalhamento com suporte

O gráfico de origem deve incluir um tipo de dados que corresponda ao tipo de dados no filtro aplicado. Por exemplo, os dados numéricos devem ter um filtro numérico.

A tabela a seguir descreve tipos de seleção e tipos de filtro compatíveis:

Tipo de seleção de dados de origem	Tipos de filtro de destino
Seleção única em várias dimensões categóricas	Lista suspensa de valor único Lista suspensa de vários valores
Seleção única em várias dimensões quantitativas	Lista suspensa de valor único Lista suspensa de vários valores
Seleção múltipla em uma dimensão categórica	Lista suspensa de vários valores
Seleção múltipla em uma dimensão quantitativa	Lista suspensa de vários valores
Seleção única dentro de um valor temporal em data	Filtro de intervalo de datas

Observação

Ao habilitar o acesso detalhado em campos de data, use uma transformação de data (como DIÁRIO) para garantir que os valores sejam reconhecidos como datas. O drill-through pode não funcionar conforme o esperado quando os campos de data são exibidos usando uma escala categórica e sem transformação, especialmente quando o campo subjacente é datetime em vez de data, porque o drill-through requer uma correspondência exata de valores.

Os seguintes casos de detalhamento ainda não têm suporte:

• Seleção múltipla com várias dimensões categóricas.
• Seleção múltipla com várias dimensões quantitativas.
• Seleção múltipla com vários valores temporais binados em data.

Usar drill through

Para configurar o drill through como um autor do painel:

1. Use o snippet a seguir para criar um conjunto de dados para as visualizações de exemplo. Nomeie o conjunto de dados em todas as viagens.

   SELECT
     DATE(tpep_pickup_datetime) AS trip_date,
     HOUR(tpep_pickup_datetime) AS pickup_hour,
     COUNT(*) AS trip_count,
     ROUND(AVG(trip_distance), 2) AS avg_distance,
     ROUND(AVG(fare_amount), 2) AS avg_fare
   FROM samples.nyctaxi.trips
   GROUP BY trip_date, pickup_hour
   ORDER BY trip_date;
   
   

2. Na tela, nomeie a página padrão, Visão geral.

3. Crie uma visualização com a configuração a seguir.

   • Conjunto de dados: todas as viagens
   • Visualização: Barra
   • Eixo X: DIARIAMENTE(trip_date)
   • Eixo Y: SOMA(avg_fare)

4. Crie uma nova página e nomeie-a detalhes.

5. Clique no Para criar um filtro e colocá-lo na parte superior da página.

6. Altere o título para a data da viagem.

7. Use o painel de configuração para definir os seguintes valores:

   • Filtro: Seletor de intervalo de datas
   • Campos: todos os trips.trip_date

8. Crie uma visualização com a seguinte configuração:

   • Conjunto de dados: todas as viagens
   • Visualização: Tabela
   • Colunas: Selecione Mostrar/ocultar tudo

Para fazer drill through para páginas de destino como um visualizador de dashboard:

1. Clique com o botão direito do mouse em um segmento de dados no gráfico de origem.
2. Clique em Detalhar e, em seguida, no nome da página que você deseja visitar.

Personalizar a aparência do painel

Você pode personalizar o tema, as cores, as fontes e as configurações de localidade do painel para corresponder à identidade visual e às preferências regionais da sua organização. Essas configurações se aplicam globalmente a todos os widgets e visualizações. Consulte as configurações do Dashboard.

Usar etiquetas de painel

Importante

Esse recurso está em Visualização Pública.

Use etiquetas para organizar e categorizar dashboards e facilitar o gerenciamento. Para obter mais informações sobre marcas, consulte Aplicar marcas a objetos protegíveis do Catálogo do Unity. Para saber como exibir e gerenciar marcas em um painel, consulte Gerenciar marcas de painel.

Habilitar um espaço Genie no seu painel

Importante

Esse recurso está em Visualização Pública.

Quando você cria um painel, o Databricks cria automaticamente um espaço do Genie que permite que os usuários empresariais realizem análises de dados de autoatendimento usando linguagem natural. A publicação de um espaço do Genie associado ao seu painel permite que os visualizadores explorem os dados do painel fazendo suas próprias perguntas para uma análise mais profunda.

Para obter mais informações sobre como habilitar, publicar e gerenciar espaços do Genie associados aos painéis, consulte espaços do Genie com dashboards.

Importante

O Genie só pode acessar os dados retornados pelos conjuntos de dados em seu painel. Os visualizadores que usam o Genie herdam o acesso a todo o resultado da consulta do conjunto de dados, não apenas ao que é mostrado nas visualizações. Defina seus conjuntos de dados para incluir apenas os campos e linhas que devem estar acessíveis.

Compartilhar um painel

Você pode compartilhar painéis com segurança com qualquer pessoa em sua conta. Para usuários atribuídos ao seu espaço de trabalho, você pode conceder acesso e definir níveis de permissão variados, como faria com outros objetos do espaço de trabalho. Para usuários que não estão atribuídos ao seu espaço de trabalho, você pode compartilhar painéis no nível da conta, permitindo que usuários registrados visualizem e executem seu painel.

Para obter detalhes sobre como os administradores podem configurar sua conta para compartilhamento no nível da conta, consulte o guia de administração de IA/BI. Para obter detalhes sobre como compartilhar seu painel nos níveis de conta e workspace, consulte Compartilhar um painel.

Inserir dashboards em sites e aplicativos

É possível inserir o painel publicado em sites e aplicativos externos usando um iframe. Consulte Inserir um painel.

Se você for um administrador de workspace que deseja gerenciar os sites externos em que os painéis podem ser inseridos, consulte Gerenciar a inserção do painel.

Agendamentos e assinaturas

Você pode configurar atualizações agendadas para atualizar automaticamente o cache do painel e, opcionalmente, enviar instantâneos para assinantes de email e canais do Slack. Os usuários com pelo menos permissões CAN EDIT podem criar um agendamento para que os painéis publicados com permissões de dados compartilhados sejam executados periodicamente. Cada painel pode ter até dez agendamentos.

Os assinantes recebem capturas de tela do painel de acordo com a frequência de agendamento.

• Assinantes de email: receber um instantâneo em PDF por email
• Canais do Slack: receber um instantâneo de imagem PNG visível diretamente no canal, um link direto para abrir o painel no Azure Databricks e um anexo PDF no thread de mensagem

Para obter detalhes sobre como criar agendas e gerenciar assinaturas, consulte Gerenciar atualizações e assinaturas agendadas do painel. Para configurar destinos de notificação do Slack, consulte Configurar notificações do Slack.

Agendar atualizações usando Tarefas do Lakeflow

Você pode configurar uma tarefa para atualizar rotineiramente um painel publicado existente. Para saber mais sobre como orquestrar fluxos de trabalho com o Lakeflow Jobs, consulte Lakeflow Jobs. Para saber como configurar uma tarefa de painel, consulte a tarefa de painel para trabalhos.

Observação

Listas de agendamento e assinante que você cria usando a interface do usuário ou a API do painel são distintas do agendamento e da automação associadas a um trabalho. Consulte Automatizando trabalhos com agendas e gatilhos.

Exportar, importar ou substituir um painel de controle

Você pode exportar e importar painéis como arquivos para facilitar o compartilhamento de painéis editáveis em diferentes workspaces. Para transferir um painel para um espaço de trabalho diferente, exporte-o como um arquivo e, em seguida, importe-o para o novo espaço de trabalho. Você também pode substituir os arquivos do painel de controle já implementados. Isso significa que, ao fazer edições diretamente em um arquivo do painel, você pode carregar esse arquivo no workspace original e substituir o arquivo existente, mantendo as configurações de compartilhamento existentes.

As seções a seguir explicam como exportar e importar os painéis na interface do usuário. Você também pode usar a API do Databricks para importar e exportar painéis programaticamente. Consulte POST /api/2.0/workspace/import.

Exportar um arquivo de painel

Para exportar um arquivo de painel:

1. Abra um painel de rascunho.
2. Clique no Menu kebab no canto superior direito da tela.
3. Clique emações de arquivo>Exportar.

Quando a exportação for bem-sucedida, um .lvdash.json arquivo será salvo no diretório de download padrão do navegador da Web.

Importar um arquivo do painel

• Na página de listagem de painéis, clique em > Importar painel de um arquivo.
• Clique em Escolher arquivo para abrir a caixa de diálogo de arquivo local e selecione o .lvdash.json arquivo que você deseja importar.
• Clique em Importar painel para confirmar e criar o painel.

O dashboard importado é salvo na sua pasta de 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 painel por um arquivo

Para substituir um dashboard a partir de um arquivo:

1. Abra um painel de rascunho.
2. Clique no Menu kebab no canto superior direito da tela.
3. Clique Ações de arquivo>Substituir.
4. Clique em Escolher arquivo para abrir a caixa de diálogo do arquivo e selecione o .lvdash.json arquivo a ser importado.
5. Clique em Substituir para substituir o painel existente.

Editar um arquivo de painel de controle

O arquivo serializado lvdash.json que você tem depois de exportar um painel inclui a sintaxe de consulta completa e as configurações de widget. Em alguns casos, como editar uma página ou um valor de widget name gerado automaticamente, é útil poder editar esse arquivo diretamente.

Para editar os valores gerados automaticamente na página de valores e os valores de ID do widget:

1. Exporte o rascunho de painel de controle e abra o arquivo .lvdash.json em um editor de texto.
2. Edite os name valores associados à página e ao widget. Salve o arquivo.
3. Importe o arquivo para o seu workspace e o republique.

Observação

O name valor no arquivo JSON é separado do displayName campo, que define o nome da página mostrado na interface do usuário.

Prática recomendada para gerenciar versões do painel

O controle do código-fonte para dashboards agora está na Visualização Pública. Os administradores do workspace podem controlar o acesso ao recurso Public Preview pela página de Previews. Por padrão, a versão prévia de Suporte a painéis na pasta do Git está ativada. Consulte painéis de controle de versão com o Git.

Se você não puder habilitar a Visualização Pública, o fluxo de trabalho recomendado será o seguinte:

1. Exporte seu painel como um arquivo JSON. O formato de arquivo é lvdash.json.
2. Adicione esse arquivo a um sistema de controle de versão, como o Git.
3. Edite o arquivo. Você pode editar valores no arquivo de texto diretamente ou carregá-los de volta no workspace e fazer alterações na interface do usuário.
4. Salve o novo arquivo. Se você fez alterações na interface do usuário, exporte seu novo arquivo. Use o sistema de controle de versão para controlar as alterações e as versões do painel.
5. Atualize o painel existente. No painel de rascunho existente:
   1. Clique no menu kebab no canto superior direito e clique em Substituir painel.
   2. Clique em Escolher arquivo na caixa de diálogo Substituir painel do arquivo. Em seguida, clique em Substituir.

Gerenciar painéis de controle programaticamente

Consulte Usar APIs do Azure Databricks para gerenciar painéis para tutoriais que demonstram como usar AS APIs REST do Azure Databricks para gerenciar dashboards. Os tutoriais incluídos explicam como converter painéis herdados em painéis do Lakeview e como criá-los, gerenciá-los e compartilhá-los.

Para saber como gerenciar um painel de IA/BI usando pacotes de ativos do Databricks, consulte o painel. Para obter um pacote de exemplo que define um painel, consulte o repositório GitHub de exemplos de pacote.

A Databricks também oferece um provedor Terraform. Consulte a documentação do Databricks Terraform.

Próximas etapas

• Compartilhe painéis com sua equipe: controle o acesso e defina os níveis de permissão para colaboração no painel. Veja Compartilhar um painel.
• Agendar atualizações automáticas: configure agendas de atualização automatizadas e assinaturas de email para painéis publicados. Veja Gerenciar atualizações e assinaturas agendadas do painel.
• Crie conjuntos de dados para dashboards: crie e gerencie as fontes de dados que alimentam as visualizações do painel. Consulte Criar e gerenciar conjuntos de dados do painel.
• Habilitar espaços do Genie: permitir a exploração de dados em linguagem natural publicando espaços do Genie com seus painéis. Consulte espaços do Genie com dashboards.
• Inserir painéis em aplicativos: consulte Inserir um painel.
• Automatizar fluxos de trabalho do painel: use Trabalhos do Lakeflow para agendar e orquestrar atualizações do painel. Consulte a tarefa Painel para trabalhos.