Clonar um painel legado para um painel do Lakeview

Observação

Os painéis (anteriormente denominados painéis do Lakeview) agora estão disponíveis de forma geral.

  • A Databricks recomenda a criação de novos painéis usando as ferramentas mais recentes. Consulte Dashboards.

  • Os painéis originais do site Databricks SQL agora são chamados de painéis legados. Eles continuarão a receber suporte e serão atualizados com correções de bugs críticos, mas as novas funcionalidades serão limitadas. O senhor pode continuar a usar os painéis antigos para criação e consumo.

  • Converta painéis antigos usando a ferramenta de migração ou a API REST. Consulte Clonar um painel legado em um painel do Lakeview para obter instruções sobre como usar a ferramenta de migração integrada. Consulte Use Databricks APIs para gerenciar dashboards para obter um tutorial sobre como criar e gerenciar dashboards usando o REST API.

Este artigo descreve como criar um novo painel de rascunho clonando um painel legado existente. O Clone to Lakeview dashboard é uma opção de menu na interface do usuário que simplifica o processo de conversão.

O uso desse botão para criar um novo painel não afeta o painel ou as consultas originais herdados. Em vez disso, esse processo usa as consultas subjacentes e as configurações do widget para criar um painel equivalente.

Observação

Os painéis (anteriormente painéis do Lakeview) não são compatíveis com todas as funcionalidades dos painéis antigos. Consulte Dashboards para saber mais sobre os recursos disponíveis.

Permissões necessárias

O senhor deve ter pelo menos a permissão Can view no painel herdado e em todas as consultas upstream, incluindo aquelas que fazem backup de parâmetros de lista dropdown baseados em consultas. Os painéis antigos tratam as permissões para Databricks SQL consultas e painéis separadamente. Permissões insuficientes em uma consulta upstream fazem com que as operações de clonagem falhem.

Clonar para o painel de controle

A animação a seguir mostra uma conversão bem-sucedida.

Gif mostrando o processo de conversão

Complete os seguintes passos para clonar um dashboard:

  1. Clique em Clone to Lakeview dashboard (Clonar para o painel do Lakeview).

    O senhor pode acessar a opção Clone to Lakeview dashboard nas seguintes áreas da interface do usuário:

    • O navegador de arquivos workspace.

      Clique com o botão direito do mouse no título do painel e clique em Clone to Lakeview dashboard (Clonar para o painel do Lakeview). Como alternativa, use o menu Menu Kebab kebab para acessar a mesma opção.

    • Um painel de controle legado.

      • Ao visualizar um painel salvo: Clique em Clone to Lakeview dashboard no menu Menu Kebab kebab em um dashboard legado existente.

      • Ao editar um painel salvo: Clique em Clone to Lakeview (Clonar para Lakeview ) no canto superior direito da tela.

        Clonar o botão Lakeview do modo de edição do painel legado.
  2. (Opcional) Especifique um título e um local de pasta para o novo painel.

    Em default, o senhor salva o novo painel na mesma pasta que o painel legado original, com (Lakeview ) anexado ao título original. Nesse estágio, o senhor pode renomear o novo painel e escolher uma pasta de destino diferente.

  3. Clique em Clonar.

    Mensagem de sucesso com link para o novo painel.

Após a conclusão das operações, procure uma notificação no canto superior direito da tela. Use o link para navegar até seu novo painel de controle.

Revisar os resultados do painel clonado

Uma operação de clonagem bem-sucedida cria um novo painel de rascunho. O painel legado existente e as consultas relacionadas permanecem inalterados. Os dois painéis não estão relacionados. As atualizações em um dashboard não afetam o outro.

O novo painel é criado como um rascunho. Ele herda todas as permissões de compartilhamento aplicadas no nível da pasta. As permissões definidas no painel de origem não são propagadas.

Todos os rascunhos de painel recebem automaticamente a execução como credenciais de Viewer, independentemente das configurações de credenciais existentes no painel legado original. Quando o senhor publica um painel, pode optar por incorporar ou não as credenciais. Isso afeta a forma como outros usuários view e interagem com seu painel. Consulte Dashboard ACLs para saber como compartilhar e gerenciar permissões para dashboards publicados.

Ajustar os parâmetros legados

Os painéis (anteriormente painéis do Lakeview) oferecem suporte limitado a parâmetros. Não há suporte para filtros de parâmetros por widget. Não há suporte para os seguintes tipos de parâmetros:

  • dropdown listas

  • Listas dropdown baseadas em consultas

  • Intervalo de datas

Todos os tipos de parâmetros suportados persistem no novo painel. Tipos de parâmetros não suportados default para valores string. Os valores previamente definidos em default são mantidos.

Trabalhar com widgets de parâmetros

Durante as operações de clonagem, todos os widgets de parâmetros antigos no nível do painel são convertidos em filtros e aparecem na parte superior do novo Canvas do painel. Os widgets de parâmetros de data e hora são adicionados como filtros do selecionador de data, e todos os outros tipos de widgets de parâmetros são convertidos em filtros de valor único.

Quando o senhor clona um dashboard que inclui consultas com parâmetros, o clone consegue recriar a consulta de destino, mas a consulta precisa ser ajustada para usar a sintaxe de parâmetro nomeado para que seja bem-sucedida. Consulte [_] (/sql/language-manual/sql-ref-parameter-marker. md # named-parameter-markers). O senhor deve atualizar a sintaxe na consulta relacionada dataset para limpar a mensagem de erro exibida no widget de filtro de parâmetro. Clique com o botão direito do mouse no widget para abrir e editar a consulta conectada dataset.

Trabalhar com parâmetros no conjunto de dados

No site Data tab, abra o site dataset que o senhor deseja editar. Na conversão, todos os parâmetros mustache ({{ }}) de consultas usadas em painéis antigos são automaticamente adicionados à coleção de parâmetros mostrados na interface do usuário.

Uma consulta dataset recém-convertida com parâmetros escritos com sintaxe mustache e mensagem de aviso.

Solução de problemas e ajustes manuais

Os painéis (anteriormente Lakeview dashboards) não são compatíveis com todos os tipos de recurso ou gráfico disponíveis nos painéis herdados. Quando o senhor clona um painel antigo com elementos não suportados, os widgets no novo painel mostram uma mensagem de erro em vez de uma cópia do widget original. Geralmente, os erros ocorrem devido à conversão de visualizações ou filtros sem suporte. Consulte Adicionar ou remover visualizações, texto e widgets de filtro na tela para saber quais visualizações e filtros são compatíveis.

Dashboard incluindo widgets com erros.

Consulte Tipos de visualização de painel para saber como usar os tipos de gráficos compatíveis com os painéis.