Clonar um painel herdado em um painel Lakeview

Observação

Os painéis (anteriormente painéis Lakeview) agora estão disponíveis para o público geral.

Os painéis não estão disponíveis nas regiões do Azure Governamental. Use os painéis herdados.

• A Azure Databricks recomenda a criação de novos painéis usando as ferramentas mais recentes. Veja Painéis.
• Os painéis SQL originais do Databricks já são chamados de painéis herdados. Eles continuarão a ser suportados e atualizados com correções de bugs críticos, mas as novas funcionalidades serão limitadas. Você pode continuar a usar painéis herdados para criação e consumo.
• Converta painéis herdados usando a ferramenta de migração ou API REST. Veja Clonar um painel herdado em um painel Lakeview para instruções sobre como usar a ferramenta de migração integrada. Consulte Usar APIs do Azure Databricks para gerenciar painéis para obter tutoriais sobre como criar e gerenciar dashboards usando a API REST.

Esse artigo descreve como criar um novo painel de rascunho clonando um painel herdado existente. Clonar para o dashboard do Lakeview é uma opção de menu na interface do usuário que simplifica o processo de conversão. A clonagem para o painel Lakeview tem suporte para painéis legados com um máximo de 100 widgets.

Usar esse botão para criar um novo painel não afeta o painel herdado original ou as consultas. 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 (antigos painéis Lakeview) não oferecem suporte a todas as funcionalidades do painel herdado. Veja Painéis para saber mais sobre os recursos disponíveis.

Permissões necessárias

Você deve ter pelo menos a permissão Pode visualizar no painel herdado e em todas as consultas upstream, incluindo aquelas que apoiam os parâmetros da lista suspensa baseada em consulta. Os painéis herdados lidam com permissões para consultas e painéis SQL do Databricks separadamente. Permissões insuficientes em uma consulta upstream impedem que a operação de clonagem seja bem-sucedida.

Clonar para painel

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

Execute as seguintes etapas para clonar um dashboard:

1. Clique em Clonar para o dashboard do Lakeview.

   Você pode acessar a opção Clonar para o dashboard do Lakeview nas seguintes áreas da interface do usuário:

   • O navegador de arquivos do Workspace.

     Clique com o botão direito do mouse no título do dashboard e, em seguida, Clonar para o dashboard do Lakeview. Alternativamente, use o menu kebab para acessar a mesma opção.

   • Um painel herdado.

     • Ao exibir um dashboard salvo: clique em Clonar para o dashboard do Lakeview no menu de três pontos em um painel herdado existente.

     • Ao editar um dashboard salvo: clique em Clonar para Lakeview próximo ao canto superior direito da tela.

       

2. (Opcional) Especifique um título e um local de pasta para o novo dashboard.

   Por padrão, você salva o novo painel na mesma pasta do painel herdado original, com (Lakeview) anexado ao título original. Nesse ponto, você pode renomear o novo dashboard e escolher uma pasta de destino diferente.

3. Clique em Clonar.

   

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

Revisar os resultados do dashboard clonado

Uma operação de clonagem bem-sucedida cria um novo painel de rascunho. O painel herdado existente e as consultas relacionadas permanecem inalteradas. Os dois dashboards não são relacionados entre si. As atualizações de um dashboard não afetam o outro.

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

Todos os rascunhos de painel recebem automaticamente credenciais Executar como visualizador, independentemente das configurações de credenciais existentes no painel herdado original. Ao publicar um painel, você pode optar por incorporar credenciais ou não. Isso afeta a forma como outros usuários veem seu dashboard e interagem com ele. Veja ACLs do Painel para saber como compartilhar e gerenciar permissões para painéis publicados.

Ajustar parâmetros legados

Os painéis (antigos painéis Lakeview) oferecem suporte limitado para parâmetros. Filtros de parâmetros por widget não são suportados. Não há suporte para os seguintes tipos de parâmetros:

• Listas suspensas
• Listas suspensas baseadas em consulta
• Intervalo de datas

Todos os tipos de parâmetros suportados persistem no novo painel. Os tipos de parâmetros não suportados são padronizados como valores string. Os valores padrão definidos anteriormente são mantidos.

Trabalhar com widgets de parâmetros

Durante a operação de clonagem, todos os widgets de parâmetros legados no nível do painel são convertidos em filtros e aparecem na parte superior do novo painel Canvas. Os widgets de parâmetro de data e hora são adicionados como filtros Seletor de data e todos os outros tipos de widgets de parâmetro são convertidos em filtros de Valor único.

Quando você clona um painel que inclui consultas com parâmetros, o clone consegue recriar a consulta de destino, mas a consulta precisa ser ajustada para usar a sintaxe do parâmetro nomeado para que seja bem-sucedida. Veja [_] (/sql/language-manual/sql-ref-parameter-marker. md # named-parameter-markers). Você deve atualizar a sintaxe na consulta do conjunto de dados relacionado para limpar a mensagem de erro mostrada no widget de filtro de parâmetro. Clique com o botão direito no widget para abrir e editar a consulta do conjunto de dados conectado.

Trabalhar com parâmetros em conjuntos de dados

Na guia Dados, abra o conjunto de dados que você deseja editar. Na conversão, todos os parâmetros bigode ({{ }}) de consultas usadas em painéis legados são adicionados automaticamente à coleção de parâmetros mostrados na IU.

Solução de problemas e ajustes manuais

Os painéis (antigos painéis Lakeview) não oferecem suporte a todos os recursos ou tipos de gráficos disponíveis nos painéis herdados. Ao clonar um painel legado 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, ocorrem erros na conversão de visualizações ou filtros não suportados. Veja Adicionar ou remover visualizações, texto e widgets de filtro na tela para saber quais visualizações e filtros são suportados.

Veja Tipos de visualização de painel para aprender como usar os tipos de gráficos suportados em painéis.