Painéis herdados

Você pode usar o editor SQL para criar um painel herdado que combina visualizações e caixas de texto que fornecem contexto com seus dados.

Importante

• A Databricks recomenda o uso de painéis de IA/BI (anteriormente Lakeview dashboards). Versões anteriores de painéis, anteriormente conhecidos como painéis SQL Databricks, agora são chamados de painéis herdados. O Databricks não recomenda a criação de novos painéis herdados.

Cronograma de fim do suporte:

• 7 de abril de 2025: O suporte oficial para a versão herdada dos painéis terminará. Apenas os problemas críticos de segurança e as interrupções de serviço serão resolvidos.

• 3 de novembro de 2025: O Databricks começará a arquivar painéis herdados que não foram acessados nos últimos seis meses. Os painéis arquivados não estarão mais acessíveis e o processo de arquivamento ocorrerá continuamente. O acesso aos painéis usados ativamente permanecerá inalterado.

  A Databricks trabalhará com os clientes para desenvolver planos de migração para painéis legados ativos após 3 de novembro de 2025.

• Converta painéis herdados usando a ferramenta de migração ou a API REST. Consulte Clonar um painel herdado em um painel de IA/BI para obter instruções sobre como usar a ferramenta de migração interna. Consulte Tutoriais de painel para obter tutoriais sobre como criar e gerenciar painéis usando a API REST.

Visualizar e organizar painéis herdados

Você pode acessar painéis do navegador de espaço de trabalho junto com outros objetos do Azure Databricks.

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

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

• Clique na guia Painéis herdados para exibir painéis herdados.

  Por padrão, a guia Meus painéis é selecionada e mostra os painéis que você possui classificados em ordem cronológica inversa. Reordene a lista clicando no cabeçalho Criado em . Ou use as guias próximas à parte superior da página para exibir Favoritos ou Todos os painéis. Use a guia Tags para filtrar por tag.

Organizar painéis em pastas no navegador de espaço de trabalho

Organize painéis novos e existentes em pastas no navegador de espaço de trabalho junto com outros objetos do Azure Databricks. Consulte Navegador de espaço de trabalho.

Filtrar a lista de painéis salvos

Filtre a lista de todos os painéis por painéis que você criou (Meus painéis), por favoritos e por tags.

Criar um painel herdado

Siga estas etapas para criar um novo painel herdado. Para clonar um painel existente, consulte Clonar um painel herdado.

1. Clique em Painéis na barra lateral e, em seguida, clique na guia Painéis herdados.
2. Clique em Criar painel herdado.
3. Insira um nome para o painel.
4. Ao criar um painel, você tem a opção de especificar um depósito a ser usado para atualização manual. Se você não selecionar e salvar um depósito no painel, ele voltará a usar o depósito salvo para consultas individuais.

Nota

Se você selecionar e salvar um depósito no painel e, em seguida, ele for excluído ou ficar indisponível, uma atualização manual falhará até que um novo depósito seja atribuído.

1. Adicione conteúdo ao painel clicando em Adicionar e selecionando o tipo de conteúdo a ser adicionado:

   • Clique em Caixa de texto para adicionar comentários.

     Insira o texto. Estilize as caixas de texto usando Markdown.

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

     Importante

     As imagens usadas em um painel armazenadas no DBFS não serão renderizadas ao fazer um pdf ou assinatura sob demanda

   • Clique em Visualização para adicionar uma visualização de consulta.

     1. Selecione uma consulta. Pesquise consultas existentes ou escolha uma recente na lista pré-preenchida. Se uma consulta foi salva com a configuração Limitar 1000 , a consulta no painel limita os resultados a 1000 linhas.

     2. Na lista suspensa Escolher visualização, selecione o tipo de visualização.

        

2. Clique em Adicionar ao painel herdado.

3. Arraste e solte blocos de conteúdo no painel.

4. Clique em Edição concluída.

   

Você também pode criar um painel com o provedor Databricks Terraform e databricks_sql_dashboard. Você pode criar um widget para um painel herdado com databricks_sql_widget. Você pode criar um painel herdado de exemplo com dbsql-nyc-taxi-trip-analysis.

Clone um painel herdado

Você pode clonar o painel herdado e todas as consultas upstream se tiver as permissões CAN RUN, CAN EDIT e CAN MANAGE no painel e em cada uma de suas consultas upstream. Você se torna o proprietário do novo painel e das consultas.

Importante

As configurações, alertas e assinaturas de compartilhamento não são copiados para o novo painel.

Para clonar um painel herdado:

1. Abra o menu kebab no canto superior direito do painel e selecione Clone.
2. Insira um nome para o novo painel e clique em Confirmar.

Nota

É garantido que a clonagem funcione de forma confiável com menos de 50 visualizações e menos de 30 consultas, incluindo consultas que são usadas para gerar parâmetros de lista suspensa baseados em consulta. A tentativa de clonar um painel com visualizações ou consultas que excedem esses limites pode falhar.

Para obter mais informações sobre parâmetros de lista suspensa baseada em consulta, consulte Lista suspensa baseada em consulta.

Usando parâmetros de consulta em painéis herdados

As consultas podem, opcionalmente, aproveitar parâmetros ou valores estáticos. Quando uma visualização baseada em uma consulta parametrizada é adicionada a um painel, a visualização pode ser configurada para usar um:

• Parâmetro do widget: os parâmetros do widget são específicos para uma única visualização dentro de um painel, aparecem no painel de visualização e os valores de parâmetro especificados se aplicam apenas à consulta subjacente à visualização.
• Parâmetro do painel: os parâmetros do painel herdado podem ser aplicados a várias visualizações. Quando você adiciona uma visualização baseada em uma consulta parametrizada a um painel, por padrão, o parâmetro será contado como um parâmetro de painel. Os parâmetros do painel são configurados para uma ou mais visualizações dentro de um painel e aparecem na parte superior do painel. Os valores de parâmetro especificados para um parâmetro dashboard aplicam-se a visualizações que reutilizam esse parâmetro específico do dashboard. Um painel pode ter vários parâmetros, cada um dos quais pode se aplicar a algumas visualizações e não a outras.
• Valor estático: os valores estáticos são usados em vez de um parâmetro que responde às alterações. Os valores estáticos permitem codificar um valor no lugar de um parâmetro e farão com que o parâmetro "desapareça" do painel ou widget onde aparecia anteriormente.

Ao adicionar uma visualização contendo uma consulta parametrizada, você pode escolher o título e a origem do parâmetro na consulta de visualização clicando no ícone de lápis apropriado. Você também pode selecionar a palavra-chave e um valor padrão. Consulte Propriedades do parâmetro.

Depois de adicionar uma visualização a um painel, você pode acessar a interface de mapeamento de parâmetros clicando no menu kebab no canto superior direito de um widget de painel e, em seguida, clicando em Alterar configurações do widget.

Propriedades do parâmetro

As propriedades do parâmetro do widget do painel são:

• Título: O nome para exibição que aparece ao lado do seletor de valores no painel. O padrão é o título definido no editor de consultas. Para editar como ele aparece no painel, clique no ícone de lápis . Os títulos não são exibidos para parâmetros estáticos do painel porque o seletor de valores está oculto. Se você selecionar Valor estático como Fonte de valor, o campo Título ficará acinzentado.

• Palavra-chave: A cadeia de caracteres literal para este parâmetro na consulta subjacente. Isso é útil para depuração se o painel não retornar os resultados esperados.

• Valor padrão: o valor definido para esse parâmetro no carregamento do painel até que outro seja selecionado e as alterações aplicadas. Para alterar esse padrão, abra a consulta subjacente no editor SQL, altere o parâmetro para o valor desejado e clique no botão Salvar .

• Fonte do valor: A origem do valor do parâmetro. Clique no ícone de lápis para escolher uma fonte.

  • Novo parâmetro do painel: crie um novo parâmetro no nível do painel. Isso permite definir um valor de parâmetro em um só lugar no painel e mapeá-lo para uma ou mais visualizações. Os parâmetros devem ter nomes exclusivos dentro do painel.
  • Parâmetro de painel existente: mapeie o parâmetro desta visualização para um parâmetro de painel existente. Você deve especificar qual parâmetro de painel pré-existente.
  • Parâmetro do widget: exibe um seletor de valor dentro do widget do painel. Isso é útil para parâmetros únicos que não são compartilhados entre widgets.
  • Valor estático: escolha um valor estático para o widget, independentemente dos valores usados em outros widgets. Os valores de parâmetros mapeados estaticamente não exibem um seletor de valores em nenhum lugar do painel, que é mais compacto. Isso permite que você aproveite a flexibilidade dos parâmetros de consulta sem sobrecarregar a interface do usuário em um painel quando não se espera que determinados parâmetros sejam alterados com frequência.

  

Editar um painel herdado

Para abrir o painel para edição, abra o menu kebab no canto superior direito do painel e selecione Editar.

Durante a edição, você pode adicionar e remover conteúdo, editar visualizações e aplicar filtros. Para alterar a ordem em que os parâmetros são mostrados, você pode clicar e arrastar cada parâmetro para a posição desejada.

Filtrar em várias consultas

Para filtrar várias consultas em um painel:

1. Vá para o seu painel legado.
2. No modo de edição, clique em Adicionar e, em seguida, clique em Filtrar.
3. Selecione Novo filtro do painel e escolha as consultas e colunas a filtrar. Você também pode optar por importar filtros de consultas existentes selecionando Filtros de consulta existentes e escolhendo importar um filtro de um editor de consultas SQL. As consultas escolhidas devem pertencer ao mesmo catálogo e esquema.
4. Clique em Guardar. Isso cria um filtro que contém a união de todas as opções suspensas.

Nota

As consultas escolhidas devem pertencer ao mesmo catálogo e esquema. Algumas consultas antigas podem não ser compatíveis com a filtragem em várias consultas.

Editar uma visualização de painel

Para editar uma visualização no painel enquanto estiver no modo de edição, selecione a visualização que deseja editar e clique no menu kebab no canto superior direito da visualização. Na lista exibida, selecione Editar visualização.

Adicionar conteúdo a um painel

1. Abra o painel para edição.
2. Clique em Adicionar caixa de texto ou Adicionar widget.
3. Clique em Adicionar ao painel herdado.
4. Clique em Edição concluída.

Você também pode adicionar uma visualização a um painel no editor SQL.

Remover conteúdo de um painel

1. Clique no ou passe o mouse sobre o objeto, clique no menu kebab no canto superior direito do widget e selecione Remover do painel.
2. Clique em Eliminar.

Filtros de dashboard

Quando as consultas têm filtros, você também deve aplicar filtros no nível do painel. Marque a caixa de seleção Usar filtros de nível de painel para aplicar o filtro a todas as consultas.

Personalizar as cores do painel

Você pode personalizar a paleta de cores do painel, incluindo a criação de uma paleta de cores.

Criar uma paleta de cores

Para criar uma paleta de cores personalizada para um painel:

1. Clique no menu kebab no canto superior direito e clique em Editar.
2. Clique em Cores.
3. Para importar uma paleta de cores existente, clique em Importar e selecione a paleta. Você pode personalizar a paleta importada.
4. Para criar uma nova paleta ou personalizar uma paleta importada, faça o seguinte:
   1. Para adicionar uma nova cor, clique em Adicionar.
   2. Para uma cor recém-adicionada ou uma cor existente, especifique a cor seguindo um destes procedimentos:
      • Clique no quadrado e selecione a nova cor clicando nele no seletor de cores ou usando o conta-gotas.
      • Clique no campo de texto ao lado do quadrado e insira um valor hexadecimal.
5. Clique em Aplicar.

Parar de usar uma paleta de cores personalizada

Para remover uma paleta de cores personalizada:

1. Clique no menu kebab no canto superior direito e clique em Editar.
2. Clique em Cores.
3. Clique em Limpar.
4. Clique em Aplicar.

Usar um paladar de cor diferente para uma visualização

Por padrão, se uma paleta de cores tiver sido aplicada em um painel, todas as visualizações usarão essa paleta de cores. Se você quiser usar cores diferentes para uma visualização, poderá substituir esse comportamento:

1. Clique no menu kebab para a visualização no painel e clique em Editar.
2. Clique na caixa de seleção ao lado de Reter cores especificadas na visualização.
3. Clique em OK.

Atualizar um painel

Os painéis herdados são projetados para carregamento eficiente à medida que recuperam dados de um cache que é renovado sempre que uma consulta é executada. No entanto, seus painéis podem ficar desatualizados se você não executar as consultas associadas regularmente. Para evitar que seus painéis fiquem obsoletos, você pode atualizá-los para executar novamente as consultas associadas.

Cada vez que um painel é atualizado, manualmente ou em uma agenda, todas as consultas referenciadas no painel são atualizadas. Quando uma visualização individual é atualizada, a consulta upstream é atualizada. A atualização manual do painel ou da visualização individual não atualiza as consultas usadas nas Listas Suspensas Baseadas em Consultas. Para obter detalhes sobre listas suspensas baseadas em consulta, consulte Lista suspensa baseada em consulta.

Atualizar o comportamento e o contexto de execução

Quando um painel é "Executar como proprietário" e uma agenda é adicionada, a credencial do proprietário é usada para execução e qualquer pessoa com pelo menos a permissão CAN RUN vê os resultados dessas consultas atualizadas.

Quando um painel é "Executar como visualizador" e uma agenda é adicionada, a credencial do proprietário é usada para execução, mas apenas o proprietário vê os resultados das consultas atualizadas; Todos os outros visualizadores devem atualizar manualmente para ver os resultados da consulta atualizados.

Atualizar manualmente um painel

Para forçar uma atualização, clique em Atualizar no canto superior direito do painel. Isso executa todas as consultas do painel e atualiza suas visualizações.

Atualizar automaticamente um painel

O proprietário de um painel e os usuários com a permissão CAN EDIT podem configurar um painel para atualizar automaticamente em uma agenda. Para atualizar automaticamente um painel:

1. Clique em Agendar no canto superior direito do painel. Em seguida, clique em Adicionar agenda.

2. Use os seletores suspensos para especificar a frequência, o período, a hora de início e o fuso horário. Opcionalmente, marque a caixa de seleção Mostrar sintaxe cron para editar a agenda no Quartz Cron Syntax.

3. Escolha Mais opções para mostrar as configurações opcionais. Pode escolher:

   • Um nome para a agenda.
   • Um armazém SQL para alimentar a consulta. Por padrão, o SQL warehouse usado para execução de consultas ad hoc também é usado para um trabalho agendado. Use essa configuração opcional para selecionar um depósito diferente para executar a consulta agendada.

   Nota

   Este armazém pode ser diferente do utilizado para a atualização manual.

4. Opcional: na guia Assinantes , insira uma lista de endereços de e-mail para notificar quando o painel for atualizado automaticamente. Cada endereço de email deve ser associado a uma conta do Azure Databricks com acesso ao espaço de trabalho ou definido como um destino de notificação nas configurações do espaço de trabalho. Os destinos de notificação são configurados por um administrador de espaço de trabalho.

5. Clique em Criar. O rótulo Schedule muda para Schedule(1).

6. Edite as configurações de compartilhamento.

   Nota

   As permissões do painel não estão vinculadas às permissões de agendamento. Depois de criar o intervalo de atualização agendado, edite as permissões de agendamento para fornecer acesso a outros usuários. Somente usuários com permissão CAN MANAGE podem editar a programação ou editar a lista de assinantes.

   • Clique no menu kebab.
   • Clique em Editar permissões de agenda.
   • Escolha um usuário ou grupo no menu suspenso na caixa de diálogo.
   • Escolha CAN VIEW para permitir que os usuários selecionados visualizem a configuração de agendamento.

A permissão CAN VIEW ou CAN RUN permite que o destinatário atribuído veja que existe uma agenda, bem como outras propriedades, como cadência de relatório e número de assinantes. CAN MANAGE permite que o destinatário modifique a agenda, a lista de assinantes e a permissão de agendamento. A permissão CAN MANAGE também permite que o destinatário pause ou cancele a agenda.

Comportamento de atualização em um painel aberto

Quando você abre um conjunto de painéis como Run as Owner, ele exibe dados da atualização mais recente do painel, independentemente de ter sido agendado ou atualizado manualmente. Se um painel estiver aberto em uma janela do navegador e uma consulta for modificada ou uma execução agendada atualizar os resultados do painel, as alterações não serão refletidas imediatamente. Os resultados atualizados aparecerão na próxima vez que você abrir o painel ou atualizar a janela aberta do navegador.

Assinaturas de instantâneo do painel

Você pode exportar periodicamente e enviar instantâneos do painel por e-mail. Os instantâneos do painel são tirados do estado padrão do painel, o que significa que qualquer interação com os filtros e visualizações não é incluída no instantâneo.

Se você tiver pelo menos a permissão CAN EDIT, poderá criar uma agenda de atualização e inscrever outros usuários, que receberão instantâneos por e-mail do painel toda vez que ele for atualizado. Para adicionar assinantes, insira usuários ou grupos na guia Assinantes, conforme descrito acima. Os subscritores elegíveis incluem utilizadores da área de trabalho e destinos de notificação.

Nota

Os destinos de notificação são configurados por um administrador de espaço de trabalho. Para saber como configurar um destino de notificação, consulte Gerenciar destinos de notificação.

Há um limite de tamanho de arquivo de 6 MB para anexos de e-mail. Se um e-mail de assinatura do painel exceder o limite de tamanho de 6 MB, o e-mail omitirá o instantâneo do painel embutido e incluirá apenas um PDF do instantâneo do painel.

Se o arquivo de instantâneo PDF exceder 6 MB, o e-mail de assinatura omitirá o PDF e, em vez disso, incluirá um link para o painel atualizado. O e-mail terá uma nota de aviso detalhando o tamanho atual do painel. (Os usuários podem testar o tamanho do instantâneo PDF baixando manualmente um PDF do painel.)

Pausar temporariamente as atualizações agendadas do painel

Se um painel estiver configurado para atualizações automáticas e você tiver pelo menos a permissão CAN VIEW na agenda, o rótulo no botão Agendar lerá Schedule(#), onde # é o número de eventos agendados visíveis para você. Além disso, se você tiver pelo menos a permissão CAN MANAGE na agenda, poderá pausar temporariamente a agenda. Isso é útil para evitar o envio de atualizações ao testar alterações no painel. Para pausar temporariamente as atualizações agendadas do painel sem modificar a lista de assinantes:

1. Clique em Schedule(#).
2. Clique no menu kebab.
3. Clique em Pausar.

Parar a atualização automática de um painel

Para interromper a atualização automática do painel e remover suas assinaturas:

1. Clique em Schedule(#).
2. Clique no menu>kebab Excluir.

Nota

Você deve ter pelo menos a permissão CAN MANAGE em um cronograma para excluí-lo.

Limites de tamanho do painel para assinaturas

Os e-mails de assinatura do painel herdado incluem os seguintes arquivos codificados base64:

• PDF: Um arquivo PDF que inclui o painel completo.
• DesktopImage: Um arquivo de imagem otimizado para visualização em computadores desktop.

Um limite máximo de 6MB é imposto ao tamanho combinado dos dois arquivos. As descrições a seguir descrevem o comportamento esperado quando o tamanho do arquivo combinado excede o limite:

• Se o ficheiro PDF tiver mais de 6MB: O e-mail de subscrição não inclui o anexo PDF nem quaisquer imagens. Ele inclui uma observação que diz que o painel excedeu o limite de tamanho e mostra o tamanho real do arquivo do painel atual.
• Se o tamanho combinado do ficheiro for superior a 6MB: apenas o PDF é anexado ao e-mail. A mensagem embutida inclui um link para o painel, mas nenhuma imagem.

Descarregar em formato PDF

Para baixar um painel como um arquivo PDF, clique no menu kebab no canto superior direito do painel e selecione Baixar como PDF.

Mover um painel herdado para a Lixeira

Para mover um painel para a Lixeira, faça o seguinte:

1. Clique no menu kebab no canto superior direito do painel e selecione Mover para a Lixeira.
2. Confirme clicando em Mover para a Lixeira.

Nota

Os painéis herdados movidos para a lixeira em ou por volta de 9/3/2024 ainda podem aparecer na página de listagem do painel herdado. Os painéis excluídos permanentemente não são mostrados.

Restaurar um painel herdado da Lixeira

1. Clique em Espaço de trabalho na barra lateral.
2. Clique em Lixeira no navegador do espaço de trabalho para exibir os ativos incluídos.
3. Clique no menu kebab ao lado do painel que você deseja restaurar.
4. Clique em Restaurar. Uma caixa de diálogo Mover é exibida.
5. Use a caixa de diálogo Mover para escolher um novo local para o painel restaurado.

Excluir permanentemente um painel herdado

1. Clique em Espaço de trabalho na barra lateral.
2. Clique em Lixeira no navegador do espaço de trabalho para exibir seus ativos incluídos.
3. Clique no menu kebab ao lado do painel que você deseja restaurar.
4. Clique em Excluir permanentemente.
5. Confirme clicando em Excluir.

Nota

Por padrão, os painéis na pasta de lixo são excluídos permanentemente após 30 dias. Use esta opção para excluir permanentemente seu painel imediatamente.

Abrir uma consulta

Para abrir a consulta exibida em um widget no editor SQL, clique no menu kebab no canto superior direito do widget e selecione View Query.

Configurar permissões de painel herdadas e propriedade do painel

Você deve ter CAN MANAGE em um painel para configurar permissões Para níveis de permissão do painel, consulte ACLs de painel herdadas.

1. Na barra lateral, clique em Painéis.
2. Clique em um painel.
3. Clique no botão no canto superior direito para abrir a caixa de diálogo Compartilhamento .
4. Procure e selecione os grupos ou usuários e atribua o nível de permissão.
   1. Defina as credenciais como Executar como visualizador para atribuir as permissões CAN EDIT ou CAN MANAGE.
5. Clique em Adicionar.

Você pode compartilhar rapidamente todas as consultas associadas ao seu painel clicando no ícone de engrenagem e selecionando Compartilhar todas as consultas. As consultas referenciadas pelo painel têm permissões separadas e não são compartilhadas por padrão quando você compartilha o painel.

Transferir a propriedade de um painel herdado

Se o proprietário de um painel for removido de um espaço de trabalho, o painel não terá mais um proprietário. Um usuário administrador de espaço de trabalho pode transferir a propriedade de qualquer painel, incluindo um sem proprietário, para um usuário diferente. Não é possível atribuir a propriedade de um painel aos grupos. Você também pode transferir a propriedade usando a API de Permissões.

1. Como administrador do espaço de trabalho, faça logon no seu espaço de trabalho do Azure Databricks.

2. Na barra lateral, clique em Painéis.

3. Clique em um painel.

4. Clique no botão Compartilhar no canto superior direito para abrir a caixa de diálogo Compartilhamento .

5. Clique no ícone de engrenagem no canto superior direito e clique em Atribuir novo proprietário.

   

6. Selecione o usuário ao qual atribuir a propriedade.

7. Clique em Confirmar.

Aceder à vista de administrador

Um usuário administrador do espaço de trabalho do Azure Databricks tem acesso de exibição a todos os painéis no espaço de trabalho. Nessa exibição, um administrador de espaço de trabalho pode exibir e excluir qualquer painel. No entanto, um administrador de espaço de trabalho não pode editar um painel quando as credenciais de configuração de compartilhamento estão definidas como Executar como proprietário.

Para visualizar todos os painéis herdados:

1. Clique em Painéis na barra lateral.
2. Clique na guia Painéis herdados.
3. Clique na guia Todos os painéis na parte superior da tela.