Ir para o conteúdo principal
Plataforma

Migre seus dashboards em lote para o AI/BI com o Genie Code

Como mover vários relatórios do Tableau e Power BI para os painéis do AI/BI em uma única execução de /importBI e, em seguida, revisar e aprimorar cada um com o Genie Code.

por Dipankar Kushari e Archana Shetty

  • Migre uma pasta inteira de relatórios com um único comando. Coloque seus arquivos do Tableau ou Power BI em um volume do Unity Catalog, abra um rascunho de painel e execute /importBI no Genie Code. O agente encontra cada relatório, associa pastas de trabalho às suas fontes de dados e cria painéis do AI/BI e visões de métricas no catálogo e no esquema escolhidos.
  • Acompanhe o lote enquanto ele é executado. Os relatórios são colocados na fila e processados em lotes, reutilizando tabelas, visões e visões de métricas existentes do Unity Catalog sempre que possível. Um cartão de status mostra cada relatório como Na fila, Em execução ou Concluído, e você pode interromper um único relatório ou o lote inteiro.
  • Construa uma camada semântica reutilizável à medida que migra. Promova as visões de métricas criadas durante a migração para o Unity Catalog ou solicite visões de métricas do Unity Catalog antecipadamente. Migrações posteriores, outros painéis, agentes do Genie e notebooks poderão então reutilizar as mesmas definições governadas.

Em nossa publicação anterior, Migre suas Dashboards para AI/BI com o Genie Code, mostramos como migrar um único relatório do Tableau ou do Power BI para o Databricks AI/BI usando a ferramenta /importBI no Genie Code. Esse fluxo de um relatório por vez é perfeito para um piloto, mas a maioria das organizações tem centenas de relatórios acumulados ao longo dos anos, e migrá-los individualmente transforma um esforço de modernização estratégico em um trabalho manual que dura meses.

A migração em massa de dashboards muda isso. Agora você pode direcionar o agente de migração para uma pasta inteira de relatórios e convertê-los em AI/BI Dashboards em uma única execução — sem precisar iniciar migrações relatório por relatório.

Este guia é para você se:

  • Você já testou o /importBI em um ou dois relatórios e está pronto para escalar.
  • Você tem uma fila de relatórios do Tableau ou do Power BI (dezenas ou centenas) que deseja mover para o Databricks AI/BI.
  • Você quer um processo de migração repetível por pasta, em vez de fazer isso relatório por relatório.

O que é migração em massa?

A migração em massa expande a experiência de migração do Databricks AI/BI para que, em vez de importar um relatório por vez, você possa processar vários relatórios juntos a partir de um único comando. O agente de migração lê seus arquivos de BI de origem, gera os AI/BI Dashboards correspondentes no Databricks e os mapeia para o catálogo e o esquema de destino especificados.

Esse recurso já está disponível de forma geral e pronto para uso no seu espaço de trabalho hoje mesmo. Antes de começar, verifique se os recursos de IA fornecidos por parceiros estão ativados nos níveis de conta e de espaço de trabalho.

Por que isso importa

Para equipes que estão padronizando no Databricks AI/BI, a migração em massa remove o maior gargalo em uma migração de dashboards em grande escala: a pura repetição de mover relatórios um de cada vez. Ao migrar uma pasta inteira de relatórios do Tableau ou do Power BI em uma única execução — e salvá-los diretamente no catálogo e no esquema escolhidos —, você transforma um projeto de migração de uma fila manual em um fluxo de trabalho repetível por pasta.

Um manual prático de migração em massa

O manual abaixo apresenta o passo a passo de uma migração em massa de ponta a ponta. Ele está dividido em três fases:

FaseEtapas
Preparar(1) Exporte seus relatórios de BI
(2) Organize-os em um volume do Unity Catalog
Executar(3) Inicie a importação em massa
(4) Escolha o catálogo e o esquema de destino
(5) Acompanhe o lote
Revisar e aprimorar(6) Revise cada relatório
(7) Siga o plano de migração
(8) Refine e dê os ajustes finais

1. Exporte seus relatórios de BI

Exporte cada relatório do Tableau ou do Power BI que você deseja migrar para um tipo de arquivo compatível. Isso inclui: .twb, .twbx, .tds, .tdsx, .pbit ou .tmdl. Os guias de documentação de exportação do Tableau e os modelos de relatório do Power BI orientam você durante o processo de exportação.

Dica: Está trabalhando com uma pasta de trabalho do Tableau que se conecta a uma fonte de dados publicada? Exporte essa fonte de dados também (.tds ou .tdsx) e mantenha-a junto com a pasta de trabalho.

2. Organize os arquivos em um volume do Unity Catalog

Coloque os arquivos de relatório de BI que você deseja migrar em um diretório dentro de um volume do Unity Catalog. Mantê-los juntos em uma única pasta permite que você os migre em lote. Uma execução em massa sempre busca seus arquivos no volume; arrastar arquivos diretamente para o chat funciona apenas para importações avulsas de um único relatório.

3. Inicie a importação em massa a partir de um rascunho de dashboard

A partir de um rascunho de dashboard, abra o Genie Code e envie:

/importBI <path/to/volume/directory>

image1.png

Acima: Executando /importBI em um diretório de volume a partir de um rascunho de dashboard.

Apontar o comando para o diretório (em vez de para um único arquivo) aciona o fluxo em massa para todos os relatórios naquela pasta. 

Se preferir linguagem natural, uma solicitação como “Migre todos os relatórios do Power BI em /Volumes/finance/bi/reports para AI/BI Dashboards” funciona muito bem. 

Você também pode nomear arquivos específicos em vez de uma pasta inteira: “Migrate Tableau reports Dashboard1.twb, Dashboard2.twb in /Volumes/finance/bi/reports to AI/BI Dashboards”. 

Por fim, adicione orientações que se apliquem a todo o lote — por exemplo, pedir ao Genie Code para "criar apenas as visualizações de métricas".

4. Escolha o catálogo e o esquema de destino

O agente reconhece o lote e lista os relatórios encontrados no volume, associando automaticamente cada pasta de trabalho do Tableau ao seu arquivo de fonte de dados correspondente e verificando com você caso alguma associação fique incerta. Em seguida, ele solicita o catálogo e o esquema de destino para que as visualizações de métricas e as visualizações SQL dos dashboards migrados fiquem no lugar certo.

image8.png

Acima: O Genie Code lista os relatórios encontrados e solicita o catálogo e o esquema de destino.

Depois de verificar a lista de arquivos e dar o sinal verde, a migração em massa é iniciada e um painel de status exibe cada relatório à medida que ele começa. Os relatórios entram na fila e são processados em pequenos grupos, sendo que cada relatório reutiliza tabelas e visualizações existentes do Unity Catalog sempre que possível antes de criar novas.

Observação: Para saber sobre os limites atuais de número e tamanho de arquivos compatíveis em uma única importação em massa, consulte sempre a documentação pública em /importBI.

5. Acompanhe o lote

Um cartão de status no chat mantém uma contagem contínua do lote, com cada relatório marcado como Na fila (não iniciado), Em execução ou Concluído (sessão encerrada). Você pode interromper um relatório individual ou pausar tudo o que ainda estiver em andamento a partir desse mesmo cartão.

image7.png

Acima: O cartão de status acompanha todos os relatórios do lote.

Como cada relatório é executado em seu próprio processo em segundo plano, não é necessário manter a aba aberta — retorne ao chat original no seu histórico do Genie Code a qualquer momento para ver o progresso do lote.

6. Revise cada relatório

Cada nome de arquivo no cartão de status leva à conversa do Genie Code daquele relatório específico, que é aberta em uma aba separada. Se uma execução parar para fazer uma pergunta, responda lá e a migração continuará de onde parou.

image5.png

Acima: Uma execução que foi pausada para solicitar entrada. Neste exemplo, a fonte de dados publicada por trás da pasta de trabalho.

7. Siga o plano de migração

Assim como na migração de um único arquivo /importBI, cada relatório passa pela fase de planejamento do Genie Code — por exemplo, analisar e avaliar a pasta de trabalho, enumerar a camada semântica, criar visualizações de métricas, montar as páginas do dashboard e validar a migração.

image2.png

Acima: O plano de migração para um único relatório, acompanhado passo a passo.

8. Refine e dê os ajustes finais

Assim que a execução do plano for concluída, você poderá visualizar o AI/BI dashboard final gerado pela migração. Você pode aprimorá-lo ou personalizá-lo ainda mais com comandos adicionais para o Genie Code. Cada resposta do Genie Code pode ser desfeita em uma única etapa, tornando seguro fazer experimentos, e você pode até pedir ao Genie Code para melhorar a aparência visual do dashboard.

image6.png

Acima: Um AI/BI dashboard final gerado pela migração em massa.

9. Valide em relação ao dashboard original

Antes de desativar um relatório de origem, verifique se o dashboard migrado fornece as mesmas respostas que o original.

  1. Capture uma captura de tela de referência. No Tableau ou no Power BI, defina um estado de filtro conhecido (por exemplo, o último trimestre completo e uma região) e tire uma captura de tela na qual os blocos de KPI, os totais e alguns gráficos principais estejam claramente legíveis.
  2. Faça correspondência com os filtros no AI/BI. Aplique os mesmos filtros e intervalo de datas ao dashboard migrado para que você esteja comparando dados equivalentes.
  3. Envie a captura de tela para a conversa do Genie Code do relatório e peça para reconciliar:
    1. "Aqui está uma captura de tela do relatório original filtrado para o Q3 de 2026, EMEA. Aplique os mesmos filtros a este painel, compare cada KPI e o total de cada gráfico com a captura de tela e liste quaisquer valores que não coincidam junto com a provável causa."
    2. "Para cada divergência, mostre a definição da exibição de métricas ou o SQL por trás do número e sugira uma correção."
    3. "Verifique se os filtros e parâmetros se comportam como o original: mesmos valores padrão, mesma filtragem cruzada e o mesmo tratamento de valores nulos e 'Todos'."
  4. Analise as diferenças antes de aceitá-las. As lacunas geralmente decorrem da atualização dos dados (uma extração comparada com tabelas ativas do Unity Catalog), filtros padrão diferentes ou semântica de cálculo, como contagens distintas, expressões de nível de detalhe ou inteligência de tempo. Nem sempre isso significa um erro de migração.
  5. Registre a aprovação. Para painéis críticos para o negócio, mantenha a captura de tela e o resultado da reconciliação como evidência antes de liberar o acesso para os usuários.

Dica: Se você conectou o Tableau ou o Power BI por meio de uma conexão MCP somente leitura (consulte a folha de dicas abaixo), o Genie Code pode verificar os números diretamente no relatório ativo, em vez de ler os valores de uma captura de tela.

Sua folha de dicas de boas práticas

Configure tudo direitinho antes de executar o /importBI para obter a migração mais fiel já na primeira tentativa:

Boa práticaDetalhes
Conecte sua ferramenta de BI de origem via MCP (opcional/recomendado)

• Configure uma conexão MCP somente leitura com o Tableau ou o Power BI para que o Genie Code possa usar o relatório ativo como fonte de veracidade, validando os resultados em relação ao original em vez de confiar apenas no arquivo exportado, o que melhora significativamente a precisão.

  • Entre em contato com a equipe da sua conta Databricks para configurar a conexão MCP do Tableau ou Power BI.
Carregue as definições de fonte de dados compartilhadas ou publicadas• No Tableau, exporte qualquer fonte de dados publicada para seu próprio arquivo .tds; no Power BI, exporte o modelo de dados compartilhado como um .pbit. Carregue esses arquivos junto com o relatório para que o agente veja a camada semântica completa.
Certifique-se de que os dados subjacentes estejam acessíveis no Databricks

• Os painéis migrados são mapeados para tabelas do Unity Catalog (via Lakeflow Connect, Lakehouse Federation ou tabelas existentes do UC).

  • Se uma fonte referenciada não estiver presente, o agente poderá se adaptar à tabela disponível mais próxima; portanto, confirme se cada painel está vinculado à fonte correta.
  • Você também pode solicitar proativamente que o Genie Code use as fontes corretas.

Exemplo: "As tabelas de origem para este relatório estão disponíveis no esquema dev.finance"

"Use prod.finance.table1, prod.finance.table2 e prod.finance.mv_revenue como fonte para este relatório"

Adicione capturas de tela do painel original• Enviar capturas de tela do estado "anterior" para o chat do Genie Code melhora significativamente a fidelidade visual e de layout. Dica: Salve capturas de tela dos seus painéis originais em um volume do Unity Catalog antes de migrar, para poder referenciá-las por caminho no comando do Genie Code.
Espere ter que refinar com um comando de acompanhamento• Trate o Genie Code como qualquer agente de IA: um segundo comando para ajustar um gráfico, filtro ou cálculo após a primeira execução é normal.
Promova exibições de métricas concluídas para o Unity Catalog

• As importações do Tableau produzem exibições de métricas (locais) no escopo do painel por padrão, enquanto as importações do Power BI produzem exibições de métricas do Unity Catalog.

  • Quando estiver satisfeito com as locais, promova-as para o Unity Catalog para que migrações futuras, outros painéis, agentes do Genie e notebooks possam reutilizá-las — ou solicite exibições de métricas do Unity Catalog desde o início no seu comando. |
Verifique os limites de arquivos documentados

• Os limites de contagem e tamanho de arquivos podem mudar, portanto, consulte sempre a documentação pública do /importBI para ver os limites atuais.

  • A migração em lote lê suas entradas de um volume do Unity Catalog, portanto, coloque todos os arquivos lá. |
Revise cada resultado antes de confiar nele• "Concluído" significa que a execução terminou, não que cada visual está finalizado. Valide cada relatório antes de fechar a sessão.

Outros recursos

  • Notas de versão do AI/BI e do Genie One (2026): os recursos e melhorias mais recentes no AI/BI, incluindo atualizações do /importBI e do Genie Code para criação de painéis.
  • Padrões semânticos do Unity Catalog: padrões de referência testados para a criação de exibições de métricas no Unity Catalog (inteligência de tempo, medidas semi-aditivas, classificação, conversão de moeda e segmentação), úteis ao refinar ou promover as exibições de métricas criadas pela sua migração.

Conclusão

Mover centenas de relatórios do Tableau ou Power BI para o Databricks AI/BI não significa mais dezenas de migrações individuais. Com a migração em lote, você prepara uma pasta de relatórios uma vez, executa um único comando /importBI e deixa o Genie Code processar o lote em segundo plano enquanto você revisa e refina cada resultado.

Se você está planejando um esforço de modernização de BI, carregue uma pasta de relatórios em um volume do Unity Catalog e teste o /importBI a partir de um rascunho de painel para ver a migração em lote em ação.

Pronto para trazer seus relatórios do Tableau e Power BI para o AI/BI?

Se você estiver pronto para começar, basta colocar os arquivos de relatório em um volume do Unity Catalog, abrir um rascunho de painel e executar /importBI no Genie Code.

Para obter detalhes passo a passo, consulte a documentação sobre como importar arquivos de BI com o Genie Code. Se você é novo no AI/BI, comece com nossa postagem anterior: Migre seus painéis para o AI/BI com o Genie Code. Você também deve ler a documentação do produto sobre migração em lote.

Perguntas frequentes

P: O que é a migração em lote para o Databricks AI/BI?

R: A migração em lote permite processar vários relatórios do Tableau ou Power BI juntos em uma única execução, em vez de importar um relatório por vez. O agente de migração lê os arquivos de BI de origem, gera os painéis de AI/BI correspondentes no Databricks e os mapeia para o catálogo e o esquema de destino.

P: Quais formatos de arquivo a migração em lote suporta?

R: A migração em lote suporta os formatos de arquivo .twb, .twbx, .tds, .tdsx, .pbit e .tmdl de relatórios do Tableau e Power BI.

P: Onde preciso armazenar meus arquivos de relatório de BI para a migração em lote?

R: Armazene todos os arquivos de relatório de BI que deseja migrar em um diretório dentro de um volume do Unity Catalog. Em seguida, você pode apontar o comando /importBI para esse diretório para acionar o fluxo de trabalho de migração em lote.

P: Como faço para iniciar uma migração em lote no Genie Code?

R: A partir de um rascunho de painel, abra o Genie Code e envie o comando /importBI <caminho/para/o/diretório/do/volume>. Você também pode usar linguagem natural, como "Migre todos os relatórios do Power BI em /Volumes/finance/bi/reports para painéis do AI/BI".

P: O que devo fazer após a conclusão da migração em lote?

R: Após a conclusão, você pode revisar cada painel migrado, compará-lo com o relatório original e usar os comandos do Genie Code para refinar ou personalizar o painel. Você também pode promover exibições de métricas locais para o Unity Catalog para que possam ser reutilizadas por outros painéis e aplicativos.

(Esta publicação no blog foi traduzida utilizando ferramentas baseadas em inteligência artificial) Publicação original

Tags relacionadas:

Clientes, Práticas recomendadas e Data Warehousing

Receba os posts mais recentes na sua caixa de entrada

Assine nosso blog e receba os posts mais recentes diretamente na sua caixa de entrada.