Painéis legados

O senhor pode usar o editor SQL para criar um painel legado que combine visualizações e caixas de texto que forneçam contexto aos seus dados.

important

• Databricks recomenda o uso do AI/BI dashboards (anteriormente Lakeview dashboards). As versões anteriores dos painéis, anteriormente chamadas de Databricks SQL dashboards, agora são chamadas de legacy dashboards . A Databricks não recomenda a criação de novos painéis legados.

Cronograma de fim do suporte :

• 7 de abril de 2025 : o suporte oficial para a versão antiga dos painéis será encerrado. Somente problemas críticos de segurança e interrupções de serviço serão abordados.

• 3 de novembro de 2025 : A Databricks começará a arquivar painéis legados 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á de forma contínua. 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 antigos usando a ferramenta de migração ou a API REST. Consulte Clonar um painel legado para AI/BI dashboard para obter instruções sobre como usar a ferramenta de migração integrada. Consulte o tutorial do Dashboard para obter um tutorial sobre a criação e o gerenciamento de dashboards usando o site REST API.

visualizar e organizar painéis antigos

O senhor pode acessar os painéis do navegador workspace juntamente com outros objetos Databricks.

• Clique em workspace na barra lateral para acessar view dashboards no navegador workspace. Os painéis são armazenados no diretório /Workspace/Users/<username> por default. Os usuários podem organizar os painéis em pastas no navegador workspace junto com outros objetos Databricks.

• Para acessar view a página de listagem do painel, clique em Dashboards na barra lateral.

• Clique em Legacy dashboards tab para view legacy dashboards.

  Em default, o My dashboards tab é selecionado e mostra os dashboards que o senhor possui, classificados em ordem cronológica inversa. Reordene a lista clicando no título Criado em . Ou use a guia próxima à parte superior da página para view Favorites ou All dashboards . Use as Tags tab para filtrar por tag.

Organize os painéis em pastas no navegador workspace

Organize painéis novos e existentes em pastas no navegador workspace junto com outros objetos Databricks. Consulte o navegador do 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.

Crie um painel legado

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

1. Clique em Dashboards na barra lateral e, em seguida, clique em Legacy dashboards tab.
2. Clique em Criar painel legado .
3. Insira um nome para o painel.
4. Ao criar um painel, o senhor tem a opção de especificar um depósito a ser usado para o manual refresh. 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 o senhor selecionar e salvar um depósito no painel e, em seguida, ele for excluído ou ficar indisponível, haverá falha no refresh manual 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 de imagem markdown com uma descrição e um URL disponível publicamente: ![description](url). Por exemplo, a marcação a seguir insere uma imagem do logotipo da 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 de imagem markdown 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.

important

As imagens usadas em um painel que estão armazenadas em DBFS não serão renderizadas ao fazer uma inscrição ou um pdf 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 Limite 1000 , a consulta no painel limita os resultados a 1000 linhas.

  2. No menu suspenso Escolher visualização , selecione o tipo de visualização.

  

2. Clique em Adicionar ao painel legado .

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

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

   

O senhor também pode criar um painel com o provedor Databricks Terraform e o databricks_sql_dashboard. Você pode criar um widget para um painel legado com databricks_sql_widget. O senhor pode criar um painel legado de amostra com o dbsql-nyc-taxi-trip-análise.

Clone um painel legado

O senhor 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 novas consultas.

important

As configurações de compartilhamento, alerta e inscrição não são copiadas para o novo painel.

Para clonar um painel legado:

1. Abra o menu de kebab no canto superior direito do painel e selecione Clonar.
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 dropdown baseados em consultas. A tentativa de clonar um painel com visualizações ou consultas que excedam esses limites pode falhar.

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

Usando parâmetros de consulta em painéis legados

Opcionalmente, as consultas podem 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:

• Parâmetro do widget: os parâmetros do widget são específicos de uma única visualização em um painel, aparecem no painel de visualização e os valores dos parâmetros especificados se aplicam somente à consulta subjacente à visualização.
• Parâmetro do painel : os parâmetros do painel legado podem ser aplicados a várias visualizações. Quando o senhor adiciona uma visualização baseada em uma consulta parametrizada a um painel, em default, o parâmetro será contado como um parâmetro do painel. Os parâmetros do painel são configurados para uma ou mais visualizações em um painel e aparecem na parte superior do painel. Os valores dos parâmetros especificados para um parâmetro do painel se aplicam às visualizações que reutilizam esse parâmetro específico do painel. 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 : valores estáticos são usados em vez de um parâmetro que responde às mudanças. Os valores estáticos permitem que você codifique um valor no lugar de um parâmetro e farão com que o parâmetro “desapareça” do painel ou widget onde ele apareceu anteriormente.

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

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 do painel e, em seguida, clicando em Alterar configurações do widget.

Propriedades dos parâmetros

As propriedades dos parâmetros do widget do painel são:

• Título : O nome de exibição que aparece ao lado do seletor de valores em seu painel. Ele tem como padrão o título definido no editor de consultas. Para editar a forma como ela aparece no painel, clique no ícone do 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 sua fonte de valor, o campo Título ficará acinzentado.

• Palavra-chave : a literalidade da cadeia de caracteres para esse 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 default, abra a consulta subjacente no editor SQL, altere o parâmetro para o valor desejado e clique no botão Save (Salvar ).

• Fonte do valor : A origem do valor do parâmetro. Clique no ícone do 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 no painel.
  • Parâmetro de painel existente : mapeie o parâmetro dessa visualização para um parâmetro de painel existente. Você deve especificar qual parâmetro de painel preexistente.
  • Parâmetro do widget : exibe um seletor de valores 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 dos parâmetros mapeados estaticamente não exibem um seletor de valores em nenhum lugar do painel, o 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 legado

Para abrir o painel para edição, abra o menu de 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 na qual os parâmetros são exibidos, você pode clicar e arrastar cada parâmetro até a posição desejada.

Filtrar várias consultas

Para filtrar várias consultas em um painel:

1. Acesse seu painel antigo.
2. No modo Editar , clique em Adicionar e, em seguida, clique em Filtrar .
3. Selecione Novo filtro de painel e escolha as consultas e colunas a serem filtradas. O senhor também pode optar por importar filtros de consultas existentes, selecionando Filtros de consultas existentes e escolhendo importar um filtro de um editor de consultas SQL. As consultas que você escolher devem pertencer ao mesmo catálogo e esquema.
4. Clique em Salvar . Isso cria um filtro que contém a união de todas as opções do site dropdown.

nota

As consultas que você escolher 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 do painel

Para editar uma visualização no painel enquanto estiver no modo de edição, selecione a visualização que você 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 legado .
4. Clique em Edição concluída .

O senhor também pode adicionar uma visualização a um dashboard no editor de SQL.

Remover conteúdo de um painel

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

Filtros do painel

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 no nível do painel para aplicar o filtro a todas as consultas.

Personalize as cores do painel

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

Crie 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 fazendo o seguinte:
      • Clique no quadrado e selecione a nova cor clicando nela 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 .

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

Use uma paleta de cores diferente para uma visualização

Em default, se uma paleta de cores tiver sido aplicada em um painel, todas as visualizações usarão essa paleta de cores. Se quiser usar cores diferentes para uma visualização, você pode ignorar esse comportamento:

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

Atualizar um painel

Os painéis legados são projetados para um carregamento eficiente, pois recuperam dados de um cache que é renovado sempre que uma consulta é executada. No entanto, seus painéis podem ficar desatualizados se o senhor não executar as consultas associadas regularmente. Para evitar que seus painéis fiquem obsoletos, o senhor pode acessar refresh o painel para executar novamente as consultas associadas.

Sempre que um painel é atualizado, seja manualmente ou em um programa, 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 refresh as consultas usadas nas listas suspensas baseadas em consultas. Para obter detalhes sobre as listas suspensas baseadas em consulta, consulte Lista suspensa baseada em consulta.

comportamento de atualização e contexto de execução

Quando um painel é "executado como proprietário" e um programar é adicionado, 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 dashboard é "executado como Viewer" e um programar é adicionado, a credencial do proprietário é usada para execução, mas somente o proprietário vê os resultados das consultas atualizadas; todos os outros visualizadores devem acessar manualmente refresh para ver os resultados atualizados das consultas.

Manualmente refresh um painel de controle

Para forçar um refresh, clique em refresh (atualizar ) no canto superior direito do painel. Essa execução realiza todas as consultas do painel e atualiza suas visualizações.

Automaticamente refresh um painel de controle

O proprietário de um painel e os usuários com a permissão CAN EDIT podem configurar um painel para refresh automaticamente em um programar. Para acessar automaticamente refresh um dashboard:

1. Clique em programar no canto superior direito do painel. Em seguida, clique em Add programar .

2. Use os seletores do site dropdown 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 Show cron syntax (Mostrar sintaxe do cron ) para editar o programa no Quartz Cron Syntax.

3. Escolha Mais opções para mostrar as configurações opcionais. Você pode escolher:

   • Um nome para o programador.

   • Um SQL warehouse para alimentar a consulta. Em default, o SQL warehouse usado para a 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

Esse depósito pode ser diferente do usado para o manual refresh.

4. Opcional: Em Subscribers (Assinantes ) tab, insira uma lista de endereços email para notificar quando o painel for atualizado automaticamente. Cada endereço email deve estar associado a um Databricks account com acesso workspace ou definido como um destino de notificação nas configurações workspace. Os destinos de notificação são configurados por um administrador do site workspace.

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

6. Editar configurações de compartilhamento.

nota

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

• Clique no menu de kebab.
• Clique em Edit programar permissões .
• Escolha um usuário ou grupo no menu suspenso da caixa de diálogo.
• Escolha CAN VIEW para permitir que os usuários selecionados view a configuração do programa.

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

comportamento de atualização em um painel aberto

Quando você abre um painel definido 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 programada atualizar os resultados do painel, as alterações não serão refletidas imediatamente. Os resultados atualizados serão exibidos na próxima vez que o senhor abrir o painel ou refresh a janela aberta do navegador.

Inscrição no Dashboard Snapshot

O senhor pode exportar periodicamente e email dashboard Snapshot. O Dashboard Snapshot é obtido do estado do painel default, o que significa que qualquer interação com os filtros e visualizações não está incluída no Snapshot.

Se o senhor tiver pelo menos CAN EDIT permissão, poderá criar um refresh programar e inscrever outros usuários, que receberão email um instantâneo do painel sempre que ele for atualizado. Para adicionar assinantes, insira usuários ou grupos em Subscribers tab conforme descrito acima. Os assinantes qualificados incluem usuários do workspace e destinos de notificação.

nota

Os destinos de notificação são configurados por um administrador do site workspace. 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 os anexos do site email. Se uma inscrição de painel email exceder o limite de tamanho de 6 MB, o site email omitirá o instantâneo do painel em linha e incluirá apenas um PDF do instantâneo do painel.

Se o arquivo PDF Snapshot exceder 6 MB, a inscrição email omitirá o PDF e, em vez disso, incluirá um link para o painel atualizado. O site email terá uma nota de aviso detalhando o tamanho atual do painel. (Os usuários podem testar o tamanho do PDF Snapshot fazendo o download manual de um PDF do painel).

Suspender temporariamente as atualizações programadas do painel

Se um painel estiver configurado para atualizações automáticas e o senhor tiver pelo menos a permissão CAN VIEW no programar, o rótulo do botão programar será programar(#) , em que # é o número de eventos programados que estão visíveis para o senhor. Além disso, se o senhor tiver pelo menos a permissão CAN MANAGE no programador, poderá pausar temporariamente o programador. Isso é útil para evitar o envio de atualizações ao testar as alterações no painel. Para suspender temporariamente as atualizações programadas do painel sem modificar a lista de assinantes:

1. Clique em programar(#) .
2. Clique no menu de kebab.
3. Clique em pausa .

Pare de atualizar automaticamente um painel

Para interromper a atualização automática do painel e remover sua inscrição:

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

nota

O senhor deve ter pelo menos a permissão CAN MANAGE em um programa para excluí-lo.

Limites de tamanho do painel para inscrição

O e-mail de inscrição do painel legado inclui os seguintes arquivos codificados em base64:

baixar como PDF

Para download um dashboard como arquivo PDF, clique no menu kebab no canto superior direito do dashboard e selecione download as PDF .

Mover um painel antigo para a lixeira

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

1. Clique no menu de 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 antigos movidos para a lixeira em 3/9/2024 ou por volta de 9/3/2024 ainda podem aparecer na página de listagem de painéis legados. Os painéis excluídos permanentemente não são exibidos.

Restaurar um painel antigo da lixeira

1. Clique em workspace na barra lateral.
2. Clique em Trash (Lixeira ) no navegador workspace para view o ativo incluído.
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 legado

1. Clique em workspace na barra lateral.
2. Clique em Lixeira no navegador workspace para view o ativo incluído.
3. Clique no menu de kebab ao lado do painel que você deseja excluir.
4. Clique em Excluir permanentemente .
5. Confirme clicando em Excluir .

nota

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

Abra 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 (Exibir consulta ).

Configure as permissões do painel legado e a propriedade do painel

O senhor deve ter o CAN MANAGE em um painel para configurar as permissões. Para obter os níveis de permissão do painel, consulte ACLs do painel legado.

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

4. Pesquise e selecione os grupos ou usuários e atribua o nível de permissão.

   1. Defina as credenciais para execução 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 pelo site default quando o senhor compartilha o painel.

Transferir a propriedade de um painel antigo

Se o proprietário de um painel for removido de um workspace, o painel não terá mais um proprietário. Um usuário administrador do workspace pode transferir a propriedade de qualquer painel, inclusive de um painel sem proprietário, para outro usuário. Não é possível atribuir aos grupos a propriedade de um painel. O senhor também pode transferir a propriedade usando a API de permissões.

1. Como administrador do workspace, faça logon no seu workspace Databricks.

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

3. Clique em um painel.

4. Clique no botão Share (Compartilhar ) no canto superior direito para abrir a caixa de diálogo de compartilhamento .

5. Clique no ícone de engrenagem no canto superior direito e clique em Assign new owner (Atribuir novo proprietário) .

   

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

7. Clique em Confirmar .

Acesso ao administrador view

Um usuário Databricks workspace admin tem view acesso a todos os painéis no workspace. Neste view, um administrador do workspace pode view e excluir qualquer painel. No entanto, um administrador do workspace não pode editar um painel quando as credenciais de configuração do compartilhamento estão definidas para execução como proprietário .

Para view todos os dashboards antigos:

1. Clique em Painéis na barra lateral.
2. Clique em Legacy dashboards tab.
3. Clique em All dashboards (Todos os painéis ) tab próximo à parte superior da tela.