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). As versões anteriores dos painéis, anteriormente conhecidas como painéis SQL do Databricks, agora são chamadas painéis herdados. A partir de 7 de abril de 2025, você não pode mais criar ou clonar novos painéis herdados.
• Converta painéis herdados usando a ferramenta de migração ou a 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 Migrar um painel para obter instruções sobre como migrar painéis herdados usando a API.
  • Veja o ponto de extremidade Migrar painel POST /api/2.0/lakeview/dashboards/migrate na referência de 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.

Observação

Você pode definir até 100 conjuntos de dados por painel. A Tela pode conter até 10 páginas. Os painéis podem conter até 100 widgets em todas as páginas.

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. É possível filtrar a lista inserindo um título na barra de pesquisa, por proprietário ou de acordo com a última modificação em um período de tempo.

• 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. Em seguida, clique em Mover para a lixeira.

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 de IA/BI.

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.

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 (Visualização Pública) 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.

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. Uma tela pode conter até quinze páginas. 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 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.

Visualizações

Crie uma visualização adicionando um widget de visualização a uma página na tela. As visualizações com suporte incluem os tipos de gráfico área, barra, caixa, combo, contador, mapa de calor, histograma, linha, pizza, original, sankey, dispersão e 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ções do painel.

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

Se a Previsão de IA (Visualização Pública) estiver habilitada em seu workspace, você poderá 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

Markdown é uma linguagem de marcação para formatar texto em um editor de texto sem formatação. Você pode usar markdown em widgets de texto para formatar texto, inserir links e adicionar imagens ao painel. Para obter detalhes sobre a sintaxe de markdown básica, consulte o guia markdown.

Adicionar imagens a widgets de texto

Para adicionar uma imagem, use a seguinte sintaxe Markdown:

![Description](path-or-URL-to-image)

Essa sintaxe inclui um ponto de exclamação (!), seguido de texto descritivo entre colchetes ([ ]) e o caminho da imagem ou URL entre parênteses (( )). Você pode exibir imagens em um widget de texto usando um caminho de volume, uma cadeia de caracteres codificada em base64 ou uma URL hospedada publicamente. Para redimensionar a imagem, ajuste as dimensões do widget.

Use um dos métodos a seguir para especificar a origem da 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.

Usar um arquivo local

Para usar um arquivo local, primeiro codifique-o como uma cadeia de caracteres base64. Em seguida, use a seguinte sintaxe markdown:

![description](data:image/webp;base64,<base64-encoded-string>)

Observação

Se você estiver familiarizado com utilitários de linha de comando, use a base64 ferramenta para converter seu arquivo. Como alternativa, há muitos recursos online gratuitos que você pode usar para codificar arquivos base64.

Usar uma imagem hospedada publicamente

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

![description](URL)

Substitua o texto de exemplo pela descrição e URL da imagem que você deseja mostrar. Por exemplo, o seguinte markdown inserirá uma imagem do logotipo do Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png).

Observação

Quando você publica seu painel com credenciais incorporadas, os visualizadores usam suas credenciais para acessar as imagens incluídas. Se o painel não for publicado com credenciais inseridas, você deverá 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.

Aplicar filtragem cruzada

Ao explorar um painel, você poderá observar tendências ou valores específicos que deseja investigar mais. Embora os filtros já possam ser aplicados, eles podem não capturar o interesse de cada visualizador. A filtragem cruzada permite que os visualizadores filtrem dados do painel interagindo diretamente com visualizações. Isso é ú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 filtros

Os filtros podem ser aplicados em um nível global ou em um widget em uma única página. 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 widgets

Use atalhos de teclado para copiar um widget selecionado e colá-lo de volta na tela. Use Command-C (Mac) ou Ctrl-C (Windows/Linux) para copiar e Command-V (Mac) ou Ctrl-V (Windows/Linux) para colar. 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.

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.

Para saber como baixar um painel publicado como UM PDF, consulte Baixar um painel publicado.

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:

• Inserir credenciais (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.
• Não insira credenciais: Os visualizadores executam consultas usando suas próprias credenciais. Suas permissões de dados determinam o que podem ver e devem ter acesso aos dados subjacentes para exibir os resultados. Para usuários com acesso ao espaço de trabalho do painel, as credenciais de processamento do editor do painel são usadas para processar a atualização. Os usuários sem acesso ao workspace não têm as permissões necessárias para acessar a computação que executa consultas de painel ou exibir os dados apresentados.

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 inserir ou não suas credenciais.
4. 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 credenciais inseridas associadas a uma entidade de serviço. Quando você executa uma chamada à API usando o token da entidade de serviço, os usuários acessam dados com base nas permissões da entidade de serviço. Isso permite que usuários sem dados diretos ou permissões de computação exibam o painel e executem consultas. Os usuários devem ser registrados com sua conta do Databricks. Para obter detalhes sobre como usar a API REST para gerenciar seus painéis, 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.

Habilitar um espaço Genie no seu painel

Importante

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

Quando você cria um painel, um espaço Genie é criado automaticamente para você. Um espaço do Genie é uma interface sem código que permite que os usuários empresariais realizem análise de dados de autoatendimento usando linguagem natural. O espaço Genie criado automaticamente começa como um rascunho que você pode usar para pré-visualizar o espaço. O espaço Genie de rascunho permanece em sincronia com o seu painel de rascunho à medida que você adiciona e remove conjuntos de dados e visualizações.

Quando você publicar seu painel, poderá optar por publicar o espaço Genie de rascunho associado ou vincular a um espaço Genie existente.

A publicação de um espaço do Genie associado ao seu painel permite que os visualizadores explorem os dados do painel de uma maneira diferente. Em vez de obter insights com base 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. Veja o que é um espaço de IA/BI Genie.

A publicação do espaço do Genie adiciona um botão Pergunte ao Genie ao painel publicado. Quando os visualizadores do painel clicam nesse botão, uma interface de chat é aberta no painel e solicita que os usuários façam perguntas sobre os dados.

Para publicar o espaço Genie associado, use as seguintes etapas:

1. Clique em Publicar.
2. O alternador Habilitar Genie está ativado por padrão. Clique no botão de alternância para ativá-lo.
3. (Opcional) Para vincular um espaço existente do Genie, selecione o botão de opção Vincular espaço existente do Genie e cole a URL associada. Se essa opção não estiver selecionada, um novo espaço do Genie com base no seu painel será gerado automaticamente.
4. Clique em Publicar na caixa de diálogo Publicar .

Observação

Os espaços de rascunho e publicados do Genie são independentes, assim como as versões de rascunho e publicadas do seu painel. Quaisquer alterações feitas no painel de rascunho serão refletidas no espaço Genie publicado somente quando o painel for republicado. Os espaços Genie de rascunho e publicados são complementares ao seu painel. Eles não aparecem no navegador de arquivos ou na página de listagem do Genie.

Para abrir o espaço Genie publicado em uma nova janela:

1. Clique no Menu de kebab no canto superior direito da janela de chat
2. Clique em Abrir Espaço do Gênio.

Para pré-visualizar seu espaço Genie de rascunho:

1. Clique no Menu kebab no canto superior direito do painel.
2. Clique em Abrir o espaço do Genie de rascunho.

Observação

Você não pode editar as instruções para esse espaço Genie na interface do espaço Genie. Seu espaço do Genie de rascunho só será alterado quando você fizer alterações no painel de rascunho.

Pergunte ao Genie sobre um gráfico específico

Para perguntar ao Genie sobre um gráfico de painel específico:

1. Clique em Perguntar ao Genie em um painel publicado com suporte do Genie.
2. Clique em um gráfico de dashboard para selecioná-lo. O Genie exibe o título do gráfico selecionado na janela de chat.
3. Faça perguntas sobre os dados representados no gráfico selecionado.

Permissões para os espaços do Genie vinculados

As permissões no espaço Genie associado espelham as existentes no painel, mas o acesso é limitado a usuários com acesso ao espaço de trabalho. Mesmo que seu painel seja compartilhado com credenciais incorporadas, apenas usuários com acesso ao espaço de trabalho podem interagir com o espaço Genie.

Os espectadores usam suas próprias credenciais para acessar a computação e os dados necessários para alimentar o espaço Genie. Eles precisam ter menos a permissão SELECT nas tabelas usadas no espaço do Genie.

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 emails com um PDF do painel mais recente para os usuários que estão inscritos no agendamento. Os usuários com pelo menos permissões Can Edit podem criar um agendamento para que os painéis publicados com credenciais inseridas sejam executados periodicamente. Cada painel pode ter até dez agendamentos.

Veja Gerenciar atualizações e assinaturas agendadas do painel.

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

• Em um painel de rascunho, clique no menu kebab no canto superior direito da tela e, depois, clique em Exportar painel.
• Confirme ou cancele a ação usando o diálogo Exportar painel. 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

• Em um painel de rascunho, clique no menu kebab no canto superior direito da tela e, depois, clique em Substituir painel.
• Clique em Escolher arquivo para abrir a caixa de diálogo do arquivo e selecione o .lvdash.json arquivo a ser importado.
• 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 os painéis de controle do código-fonte.

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.