Clonar um painel legado para um painel AI/BI

Observação

AI/BI (anteriormente Lakeview dashboards) estão agora disponíveis de forma geral.

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

  • Os painéis originais do site Databricks SQL agora são chamados de painéis legados. Eles continuarão sendo suportados e atualizados com correções críticas de bugs, mas as novas funcionalidades serão limitadas. Você pode continuar usando painéis legados 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 AI/BI 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. Clone to AI/BI dashboard é uma opção de menu na interface do usuário que simplifica o processo de conversão. O Clone to AI/BI dashboard é compatível com painéis antigos com um máximo de 100 widgets.

Usar esse botão para criar um novo painel não afeta o painel ou as consultas antigas originais. 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 AI/BI (anteriormente painéis 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 suspensa 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 AI/BI

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 AI/BI dashboard (Clonar para o painel AI/BI).

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

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

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

    • Um painel antigo.

      • Ao visualizar um painel salvo: Clique em Clone to AI/BI dashboard (Clonar para painel AI/BI) no menu Menu kebab kebab em um painel legado existente.

      • Ao editar um painel salvo: Clique no menu Menu kebab kebab e, em seguida, em Clone to AI/BI.

  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 (AI/BI ) anexado ao título original. Nesse estágio, você 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.

Analise 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 e as atualizações de um 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. Ao publicar um painel, você pode optar por incorporar credenciais ou não. Isso afeta a forma como outros usuários view e interagem com seu painel. Consulte ACLs de painel AI/BI para saber como compartilhar e gerenciar permissões para painéis publicados.

Ajuste os parâmetros legados

AI/BI Os painéis oferecem suporte limitado para parâmetros. Os seguintes tipos de parâmetros não são suportados:

  • Multi-valor dropdown list

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

Trabalhe 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 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âmetros nomeados para que tenha sucesso. 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. Consulte Trabalhar com parâmetros de consulta para obter sintaxe e exemplos.

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 de bigode ({{ }}) das consultas usadas em painéis antigos são adicionados automaticamente à coleção de parâmetros mostrada 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

AI/BI Os painéis não são compatíveis com todos os tipos de recurso ou gráfico disponíveis nos painéis herdados. Quando você clona 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. Normalmente, ocorrem erros na conversão de visualizações ou filtros não suportados. Consulte Adicionar ou remover visualizações, texto e widgets de filtro na tela para saber quais visualizações e filtros são compatíveis.

Painel incluindo widgets com erros.

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