Clone um painel herdado em um painel do Lakeview

Nota

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

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

• O Azure Databricks recomenda a criação de novos painéis usando as ferramentas mais recentes. Consulte Painéis.
• Os painéis SQL originais do Databricks agora são chamados de painéis herdados. Eles continuarão a ser suportados e atualizados com correções de bugs críticos, mas a nova funcionalidade será limitada. Você pode continuar a usar painéis herdados para criação e consumo.
• Converta painéis herdados usando a ferramenta de migração ou a API REST. Consulte Clonar um painel herdado em um painel do Lakeview para obter 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 painéis usando a API REST.

Este artigo descreve como criar um novo painel de rascunho clonando um painel herdado existente. Clone to Lakeview dashboard é uma opção de menu na interface do usuário que simplifica o processo de conversão. O painel Clone to Lakeview é suportado para painéis herdados 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.

Nota

Os painéis (anteriormente Lakeview dashboards) não suportam todas as funcionalidades de painéis herdados. Consulte Painéis para saber mais sobre os recursos disponíveis.

Permissões obrigatórias

Você deve ter pelo menos a permissão Pode Exibir no painel herdado e todas as consultas upstream, incluindo aquelas que dão suporte aos parâmetros da lista suspensa baseada em consulta. Os painéis herdados lidam com permissões para consultas e painéis Databricks SQL separadamente. Permissões insuficientes em uma consulta upstream faz com que a operação de clone falhe.

Clonar no painel

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

Conclua as seguintes etapas para clonar um painel:

1. Clique em Clonar no painel Lakeview.

   Você pode acessar a opção Clone to Lakeview dashboard das seguintes áreas na interface do usuário:

   • O navegador de arquivos de espaço de trabalho.

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

   • Um painel legado.

     • Ao visualizar um painel salvo: Clique em Clonar no painel Lakeview no menu kebab em um painel herdado existente.

     • Ao editar um painel salvo: clique em Clonar para Lakeview perto do canto superior direito da tela.

       

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

   Por padrão, você salva o novo painel na mesma pasta do painel herdado original, com (Lakeview) anexado ao título original. Nesta etapa, você pode renomear o novo painel 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é o novo painel.

Revisar os resultados do painel clonado

Uma operação de clonagem bem-sucedida cria um novo painel de rascunho. O painel herdado existente e as consultas relacionadas permanecem inalterados. Os dois painéis não estão relacionados. As atualizações de um painel 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 do painel recebem automaticamente credenciais de 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 visualizam e interagem com seu painel. Consulte ACLs de painel para saber como compartilhar e gerenciar permissões para painéis publicados.

Ajustar parâmetros herdados

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

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

Todos os tipos de parâmetros suportados persistem no novo painel. Tipos de parâmetros sem suporte padrão para string valores. 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 no nível do painel herdados 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 de seletor de data e todos os outros tipos de widgets de parâmetros 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 de parâmetro nomeado para que ela seja bem-sucedida. Consulte [_] (/sql/language-manual/sql-ref-parameter-marker. md # named-parameter-markers). Você deve atualizar a sintaxe na consulta de conjunto de dados relacionada para limpar a mensagem de erro mostrada no widget de filtro de parâmetro. Clique com o botão direito do mouse 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 de bigode ({{ }}) de consultas usadas em painéis herdados são adicionados automaticamente à coleção de parâmetros mostrados na interface do usuário.

Solução de problemas e ajustes manuais

Os painéis (anteriormente Lakeview dashboards) não suportam todos os recursos ou tipos de gráficos disponíveis em painéis herdados. Quando você clona um painel herdado 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 ao converter 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 suportados.

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