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.
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:
/importBI em um ou dois relatórios e está pronto para escalar.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.
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.
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:
| Fase | Etapas |
|---|---|
| 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 |
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.
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.
A partir de um rascunho de dashboard, abra o Genie Code e envie:
/importBI <path/to/volume/directory>

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

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

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

Acima: Uma execução que foi pausada para solicitar entrada. Neste exemplo, a fonte de dados publicada por trás da pasta de trabalho.
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.

Acima: O plano de migração para um único relatório, acompanhado passo a passo.
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.

Acima: Um AI/BI dashboard final gerado pela migração em massa.
Antes de desativar um relatório de origem, verifique se o dashboard migrado fornece as mesmas respostas que o original.
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.
Configure tudo direitinho antes de executar o /importBI para obter a migração mais fiel já na primeira tentativa:
| Boa prática | Detalhes |
|---|---|
| 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.
|
| 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).
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.
|
| 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.
|
| 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. |
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.
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.
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
Assine nosso blog e receba os posts mais recentes diretamente na sua caixa de entrada.