Roteiro em 6 passos

Selo de estado: Preview (teto atual do produto) · Curso ACD-350 — Rota rápida: do Power BI/Excel ao ingestia.bi · Aula 5 de 5 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai planejar migração de 1 relatório — um plano de uma página, com os seis passos na ordem, o critério de corte para desistir e a regra de conciliação antes de desligar o original.

Vídeo#

Identificador no manifesto: acd-350-05-roteiro-de-migracao · duração-alvo 7 min · tela do produto: /connect.

Roteiro:

Conteúdo#

O erro clássico de migração é começar pelo portfólio. O roteiro sugerido pela documentação é por relatório, e esta aula o transforma em plano: cinco passos de execução que a página Migrar do Power BI descreve, mais dois que a prática exige — escolher o piloto no começo e conciliar no fim (eles ocupam as pontas: passo 1 e parte do passo 6).

Mapa dos seis passos

Passo 1 — o critério de corte

Escolha um relatório que seja ao mesmo tempo doloroso e pequeno: muitas pessoas consomem, poucas fontes alimentam. Depois de inventariar (fontes, transformações, medidas, visuais, RLS, destinatários), decida com três perguntas:

1. Alguma peça está na lista da aula 4 como bloqueia a migração? Se sim, pare aqui: o caminho é continuar no Power BI lendo o Gold por OData (aula 2).
2. As medidas dependem de recursos sem equivalente (tabelas virtuais, RELATED, USERELATIONSHIP)? Se muitas dependem, o custo de reescrita pode ser maior que o ganho.
3. Existe alguém que sabe explicar cada número do relatório? Se não, este é o relatório errado para começar — migrar número que ninguém entende só muda o lugar da dúvida.

Passos 2 a 5 — a execução

Modelo antes de medida, medida antes de visual. Recrie o modelo estrela sobre as tabelas do Gold e a tabela calendário (com ano fiscal, se for o seu caso) antes de qualquer gráfico: é o modelo que faz o anti-fan-out trabalhar a seu favor. Em seguida traga as medidas pelo importador de DAX, conferindo cada uma contra o catálogo de fórmulas e tratando cada tradução como rascunho — confiança média ou baixa significa "revise antes de salvar". Só então reconstrua as páginas e os filtros, e por último declare a RLS, conferindo com um membro de teste (maria@example.com, por exemplo) que o recorte aparece como esperado.

Passo 6 — conciliar antes de desligar

Publique a versão nova e rode em paralelo com o relatório original por um ciclo inteiro de atualização. Compare número a número, começando pelos totais e descendo até um recorte com filtro aplicado. Divergência tem três causas típicas, nesta ordem de frequência: grão (fan-out no Power BI que aqui é recusado), semântica de função (as dez diferenças da aula 3 — CONTD e o vazio é a campeã) e janela de dados (o snapshot de um lado está mais velho que o do outro). Só desligue o original quando o responsável pelo relatório assinar embaixo da conciliação.

Como isso aparece no produto

O plano vira artefatos concretos: o modelo e as medidas no editor do painel; a publicação e a RLS no painel de publicação; a distribuição por link, export ou embed; e o projeto exportado em BI-as-code, que dá diff por widget e por versão — útil justamente na fase de conciliação, quando você precisa saber o que mudou entre duas tentativas.

Exemplo Aurora

Plano de uma página para o "Vendas Mensais" da Aurora Varejo: piloto escolhido porque tem uma fonte só e quinze leitores; modelo estrela com vendas + produtos, clientes, filiais, calendario; medidas Receita, Pedidos, Ticket médio, Receita AA e Variação % (duas traduzidas pelo importador, três reescritas na mão); quatro visuais e um slicer de período; RLS por regiao; publicação com link interno; conciliação de duas semanas contra o .pbix; itens fora de escopo registrados — push no celular e alerta por meta (aula 4).

O que NÃO existe neste roteiro

Não há migrador automático de .pbix: nada importa páginas, visuais, temas ou relacionamentos de um arquivo do Power BI. O único automatismo é o importador de medidas DAX, que é assistido e nem tudo converte. Também não há ambiente de homologação separado (sem dev-test-prod): a conciliação em paralelo é feita entre o painel publicado aqui e o relatório que continua no Power BI.

Estado

O roteiro é prático, não uma capacidade do produto — por isso esta aula não cita capabilityId. As capacidades que ele usa estão cada uma no seu selo, e o teto segue Preview: planeje a migração como se o canal pudesse mudar de forma, porque pode.

Faça você mesmo#

No workspace de treino Aurora Varejo (abra /connect no console) — produza um plano de migração de 1 relatório, em uma página:

1. Escolha o relatório-piloto e escreva em uma linha por que ele: quantos leitores, quantas fontes, qual a dor.
2. Inventarie em cinco linhas: fontes, transformações, medidas, visuais e RLS (reaproveite o exercício da aula 1).
3. Rode o critério de corte das três perguntas e registre a decisão: migrar ou continuar no Power BI via OData.
4. Liste as medidas em duas colunas: as que o importador deve resolver e as que você vai reescrever na mão (use as dez diferenças da aula 3 para decidir).
5. Escreva o plano dos passos 2 a 5 com um responsável e uma data-alvo por passo.
6. Defina a conciliação: quais três números serão comparados, por quanto tempo roda em paralelo e quem assina o aceite.
7. Anote os itens fora de escopo, cada um com o estado correto (Preview, Fora de GA, Roadmap).
8. Guarde o plano junto com o projeto exportado em BI-as-code, para ter o diff quando a segunda tentativa vier.

Você terminou quando o plano couber em uma página e responder sem ambiguidade a três coisas: qual é o relatório, quando o original é desligado e o que explicitamente não vai junto.

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

• bi/migrar-do-power-bi
• bi/tutorial-configurar-rls
• bi/bi-as-code

Capacidades ensinadas#

(conceitual — sem capacidade específica da matriz) — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".