O fim de semana da transição

🌐 Também em 19 idiomas

English · Español · 日本語 · Português (Brasil) · Français · Deutsch · Italiano · 한국어 · 简体中文 · 繁體中文 · Bahasa Indonesia · Türkçe · Polski · Tiếng Việt · ไทย · Українська · Español (México) · Français (Canada) · Deutsch (Schweiz)

Imagem gerada com IA

Traduzido com IA. Ainda não revisto pela comunidade. Ler em inglês Esta secção mudou em inglês e ainda não foi traduzida de novo. (54)

Módulo 4 de 5 do capítulo Migração e sincronização, capítulo 10 do curso Data Architect. Cada módulo sustenta-se sozinho. Previous: Automation During the Load · Next: Getting Data Out: Keeping Another System in Step ⟲

A pergunta que este módulo responde: Como faz a transição, e prova que a migração funcionou?

É sexta à noite. Os utilizadores foram embora, a equipa de migração está online, e alguém diz: “Testamos isto três vezes. Vamos lá.” Ok. O que exatamente estamos prestes a fazer? Quando o sistema antigo para de mudar? Quando é a extração final? Quem desliga a automação, quem inicia cada carga? E se à meia-noite estivermos duas horas atrasados, ou 3 por cento das contas falharem? Quem decide se continuamos? Como provamos que os dados estão certos, e quando os utilizadores podem voltar? E se correr mal: como saímos? A transição não é “correr a migração”. É uma transição controlada de um estado conhecido para outro.

Start With the Picture

Here’s our landscape one more time. This is the weekend that amber arrow runs, and then disappears. ⟲

Clique para ampliar

The weekend this arrow runs. On Monday morning, it’s gone. ⟲

But more changes that weekend than one arrow. The partners’ manifests stop landing in RouteDesk and start arriving through the integration layer. RouteDesk’s own outbound feeds, Keystone’s nightly status file and Redrock’s webhook, have to come from Salesforce instead. Coordinators route Monday’s deliveries in Field Service, not RouteDesk. And on Monday morning, 330 trucks leave the distribution centers on routes from the new system. Everything in this module is about getting to that Monday safely, and knowing what we’d do if we couldn’t. ⟲

A produção deveria ser entediante

Quero que a transição em produção pareça quase decepcionante. Já rodamos o processo, cronometramos, vimos as falhas, testamos os bypasses, conciliamos os resultados e praticamos a volta à operação normal. A produção é o mesmo roteiro com dados novos. Se estamos a inventar a migração no fim de semana da transição, já estamos encrencados.

That takes a dress rehearsal, not “we loaded accounts in the sandbox.” Beginning to end: a final-style extract, transformations, quality checks, the load sequence, automation and integration controls, reconciliation, deferred processing, the return to normal mode, all timed, at production or representative scale, in a Full sandbox. Record how long each step took, what failed, what needed manual help, what confused people, where we waited, what surprised us. Then improve the runbook. The first rehearsal teaches you how the migration works; the next one should prove you learned. And because module 2 brought the keys back, a rehearsal doesn’t have to start from nothing every time: fix one transformation, reload just the rows it touched, and run the reconciliation again. For RouteDesk, that means the whole weekend in a Full sandbox: the extract, the preparation data store, the waves of module 1, the bypass of module 3, the switch of the partners’ feeds, and the reconciliation, with a stopwatch running. ⟲

O runbook é arquitetura executável

Não “sábado de manhã: migrar os dados”. Algo mais perto disto:

Etapa	Ação	Responsável	Duração prevista	Evidência / critério de saída
1	Confirm RouteDesk is read-only after Saturday’s last truck	Operations lead	10 min	Written confirmation; time of the last change recorded
2	Final RouteDesk extract into the preparation data store	Data team	45 min	Counts and control totals captured
3	Confirm the bypass on the migration user	Salesforce team	10 min	A test record saves with no status events sent
4	Incremental load: Saturday’s changes, upsert by the partner key	Migration team	30 min	Results and new IDs back in the preparation data store
5	Reconcile against the expected numbers	Data team and operations	30 min	Counts, totals and aggregate reports approved
6	Switch the partners’ manifests and status feeds to the integration layer	Integration team	30 min	One test manifest upserted and one status sent, per partner
…	…	…	…	…
14	Remove the bypass from the migration user	Salesforce team	10 min	Permission set unassigned, and checked

Now we know what happens, who does it, how long we expect, and what proves each step is complete. That’s much stronger than a checklist that says “Load Work Orders.” Notice step 14. Module 3’s bypass is a permission to skip business rules, so taking it away is a runbook step with an owner, not something we hope someone remembers. ⟲

Dia −7, dia −1, dia 0

I call go-live Day 0: usually a Sunday or another off-hours day. Steve Trucking delivers six days a week, so Day 0 is the Sunday with no trucks on the road. Day +1 is after it; Day −1 and Day −7 are before it. And on any large load, I ask: do I have to wait until Day 0 to load all the data? If the load takes hours and the source keeps changing, I’m going to need an incremental anyway. So: ⟲

• Day −7: the initial load. Load the bulk of the data a week early, kept invisible by sharing, so users and reports don’t see it. Smoke-test users (a system administrator) validate it in place. Ask the business what would be hurt by loading early; if the answer is “it would break my reports,” load it hidden. It’s much simpler to open up the sharing on Day 0 than to spend five hours loading a million records and all their children inside the window. ⟲
• Dia −1: a carga de atualização. Traga o que mudou desde o dia −7, e proteja a linha de largada: os utilizadores ainda estão a mudar a origem, as integrações estão a escrever, os jobs agendados estão a correr? Congele a origem, deixe-a somente leitura, ou defina exatamente como as mudanças posteriores à extração serão capturadas.
• Dia 0: o incremental. Carregue o que mudou desde o dia −1 (às vezes um incremental no início da janela e um final no fim), concilie, decida o go ou o no-go, abra a partilha, restabeleça a operação normal.

For RouteDesk, Day −7 is the Sunday before: the 190,000 delivered Work Orders go in, hidden by sharing, and smoke-test users check them all week. History barely changes, so most of the load is done before the weekend starts. Day −1 is Saturday night, once the last truck is back: RouteDesk goes read-only, and the refresh brings the week’s changes. Day 0 is Sunday: a small incremental, then the gates. ⟲

Clique para ampliar

Day −7: most of the data, a week early, where nobody can see it yet. ⟲

Clique para ampliar

Day −1: the week’s changes, and the source stops moving. ⟲

Clique para ampliar

Day 0: a small incremental, then the gates. ⟲

Clique para ampliar

Day +1: the first truck leaves, and the rollback clock runs out. ⟲

This isn’t an unusual way to cut over; it’s the common one, under other names. Salesforce’s own guidance for moving a B2C Commerce site says to migrate as much data as you can “as close as possible prior to the actual cut-over. Ideally, only the delta from the previous day should be required to copy during the cut-over to minimize the down time” (B2C Commerce Realm Split FAQ (abre num novo separador), Salesforce Help). Microsoft’s guidance for its own platform is a full migration “about a month before go-live, followed by weekly delta loads,” with the final delta “after freezing both source and target systems” (Data migration planning for go-live (abre num novo separador), Microsoft Learn). And AWS’s database migration service builds the same idea in: a full load while it captures changes, then “shut down your applications, let the remaining changes flow through to the target” (Components of AWS DMS (abre num novo separador), AWS; all three checked 2026-10-27). The timing changes with the volume: a month or a week ahead, weekly or daily deltas. The Salesforce twist is the one I add: load early hidden by sharing, so the data is in place and checked, and nobody sees it until Day 0. ⟲

Test knowledge. For a large migration with a short cutover window, load most of the data days early, hidden from users by sharing, then load only what changed (a refresh before the window, an incremental inside it). Freeze or capture changes in the source from the extract onward, and validate with test users before opening access. ⟲

For the cutover, the point is the gates around those loads. By Day −7 I don’t want to be designing the migration anymore: mappings, transformations, the load sequence, automation decisions, migration identities, reconciliation reports, the runbook, rollback criteria and known exceptions are stable, because the real loads have started. Things can still change, but every late change reduces rehearsal. At some point you stop improving the migration and start protecting the cutover. And know when the source stopped moving, or know exactly how you’ll capture what changed after your extract. ⟲

That second half is the watermark: the point through which each extract was current, so the next load knows what changed since. For RouteDesk, the watermark is the moment of each extract: everything RouteDesk changed after Sunday’s Day −7 extract is in Saturday’s refresh. That only works if RouteDesk records when a delivery last changed, so check that it does, and that every DC’s screens update it. If it doesn’t, compare snapshots: extract again and find the differences by key. Slower, but it’s a watermark you can trust. Without one, delta processing is guesswork. ⟲

Depois, o dia 0 é execução. Siga o runbook, registre os horários reais, os IDs dos jobs, as contagens, os erros e as decisões. Se a etapa 17 falhar, não pule para a 24 porque alguém acha que isso economiza tempo: entenda a dependência, use o procedimento de recuperação, atualize o estado. A equipa deveria sempre conseguir dizer onde estamos, o que está concluído, o que falhou, o que vem a seguir e se ainda estamos dentro da janela.

Bloqueie os utilizadores quando precisar de controlo

Ninguém gosta de indisponibilidade. Mas fingir que o sistema está disponível enquanto mudamos a sua fundação pode ser pior, e “queremos indisponibilidade zero” não deve tornar-se em silêncio “não fazemos ideia de qual versão dos dados tem a autoridade”. Às vezes a estratégia mais limpa é bloquear os utilizadores, fazer a transição, provar o resultado e trazê-los de volta. Como?

• Os formas duros: congelar os utilizadores, mudar o horário de login deles ou restringir os intervalos de IP. Não os desative: isso quebra a propriedade e tudo o que está ligado a ela.
• O forma suave: um fluxo de login (login flow) que deixa as pessoas entrarem e as coloca numa sala de espera: “o sistema está em manutenção; volte mais tarde”. Mais amigável que erros que fazem os utilizadores pensarem que a conta deles está quebrada. Nunca coloque esse fluxo de login nos administradores do sistema; se ele quebrar, ninguém entra.
• Sempre deixe uma porta dos fundos: um grupo de administradores do sistema (e os seus utilizadores de teste de fumaça) que ainda consegue entrar.
• As sessões continuam. Bloquear os utilizadores não encerra as sessões já abertas, então planeie como tirar as pessoas que ainda estão a trabalhar: um aviso, um prazo ou, com trabalho personalizado, uma forma de deslogá-las.

At Steve Trucking it’s Sunday, so the people to plan for are the care agents answering phones, the coordinators getting ready for Monday, and the 300 Retail Partner users who might log in to the portal to check a claim. Login flows are assigned by profile (Custom Login Flows (abre num novo separador), Salesforce Help, checked 2026-10-27), so the partners’ profile can get the waiting room (“your deliveries are moving to a new system; back Monday at 6 a.m.”) while the smoke-test users and administrators come and go. ⟲

Não invente isso na semana anterior. Decida o que os utilizadores vão vivenciar, e avise.

Test knowledge. To keep users out during a cutover, freeze their accounts, restrict login hours or IP ranges, or use a login flow (assigned by profile) as a waiting room. Don’t deactivate users: it breaks ownership and what’s attached to it. Keep administrators and test users able to log in. ⟲

Go/no-go, e o relógio do rollback

Às 2h da manhã, com doze horas de trabalho, não é hora de inventar os critérios de go/no-go. Defina-os antes da transição: objetos críticos conciliados, taxa de falhas abaixo de um limite aprovado, nenhum defeito crítico de dados sem solução, relações obrigatórias validados, integrações críticas verificadas, automação restabelecida e testada, desempenho aceitável, validação de negócio feita, tempo suficiente para as etapas posteriores. Senão “go” torna-se “já chegamos até aqui”. Isso não é arquitetura. É o viés do custo irrecuperável.

“We have a rollback plan.” Good. Until when? We migrate, open Salesforce, and for six hours users create cases, update accounts, enter opportunities, change contact details, while integrations send data elsewhere. Can we restore Friday night? Not without losing legitimate work. Rollback gets harder the longer the new system runs, so define the rollback point: before it, we return to the previous state with the tested procedure; after it, recovery needs a different strategy. Rollback has a clock, and the runbook should show it. For Steve Trucking the clock is easy to read: until Monday’s first truck leaves on a Field Service route, we can still send the coordinators back to RouteDesk, which is why it stays read-only and untouched until then. After that, every delivery made, photo taken and status sent lives only in Salesforce, and going back would lose real work. From that moment, recovery means fixing forward. ⟲

O rollback também não é só eliminar o que carregou. A automação pode ter criado filhos, as integrações podem ter enviado registos para outros lugares, os utilizadores podem ter mudado registos migrados, ficheiros podem estar anexados, eventos publicados, registos existentes atualizados. Os efeitos distribuídos são o motivo de os controlos de automação e de integração do módulo 3 serem arquitetura da transição.

And what makes you roll back? In my experience it’s rarely the loader. It’s unknown data: you find out something key was missed, or a data feed was running that nobody accounted for. The best rollback plan is not needing it: know all of your key data, and every feed that touches it, before cutover. RouteDesk has two that are easy to forget, because they go out, not in: the nightly status file Keystone picks up, and the webhook that tells Redrock what happened. Retire RouteDesk without moving them, and on Monday night Keystone hears nothing. Nobody loaded the wrong data; a feed just stopped. ⟲

Quatro formas de eu provar os dados

Depois da carga, não pergunto “a API disse que correu bem?”. Quero quatro tipos de prova, e uso as quatro: contagens, totais, verificações pontuais e relatórios agregados.

Contagens. Quantos registos deveriam existir, e quantos existem? Contas de origem selecionadas: 500.000. Duplicatas consolidadas: 20.000. Excluídas por política aprovada: 5.000. Previstas: 475.000. No destino: 475.000. Ótimo, mas as contagens sozinhas não são prova; pode ter o número certo de registos e os dados errados.

Totais. Onde os números importam, compare os totais de controlo: valor das faturas, valor das encomendas, saldo em aberto, quantidade. Os dois sistemas têm 100.000 faturas, mas o legado soma US$ 412.800.000 e o Salesforce US$ 398.100.000. Pare. Os totais expõem o que as contagens deixam passar.

Spot checks. Look at real records, not just easy ones: a simple record and a complex one, a large customer and a small one, one with many children, one that was transformed, one involved in dedupe, one with unusual history. Trace each from source to target: fields, relationships, ownership, history, External IDs. Averages hide serious individual failures. ⟲

Relatórios agregados. Compare a forma: contas por estado, encomendas por ano, casos por estado, clientes por segmento, receita por mês. Se a origem diz 82.000 clientes no Arizona e o Salesforce diz 8.200, temos uma pista: um código de estado que não foi mapeado, um ano excluído, um estado traduzido errado, um ficheiro pulado. A contagem de linhas pode parecer certa enquanto a distribuição conta a história.

For RouteDesk, each proof has its check, and each catches something the others miss. ⟲

Clique para ampliar

Each proof catches what the others miss. Use all four. ⟲

The aggregate report is the one I’d watch first. Remember module 1’s status codes: nine DCs, nine spellings. If DC 7’s deliveries by week come out 40 percent short against RouteDesk’s, the count for the whole load might still look close, but one DC’s DONE/INST didn’t map. ⟲

Test knowledge. Prove a migration with more than “no errors”: record counts against expected numbers set before the load, control totals on amounts that matter, spot checks of real records traced end to end, and aggregate reports that compare the shape of the data. Business owners validate it too. ⟲

Elas vêm com duas regras. Primeira, defina os números previstos antes da carga (módulo 1): contagem da origem, exclusões aprovadas, duplicados consolidadas, registos em quarentena, destino previsto. Depois compare e explique a diferença. Um número previsto inventado depois de ver o resultado não é conciliação; é racionalização. Segunda, zero erros ainda pode estar errado. Mapeie Billing State em Shipping State e cada linha carrega sem erros de API: execução técnica perfeita, arquitetura errada. Por isso a conciliação de negócio importa, não só os logs técnicos.

Os responsáveis de negócio também validam

A equipa técnica consegue provar as contagens, as chaves, as relações e o sucesso da carga. Os utilizadores de negócio reconhecem o que nós não vamos reconhecer: “estes não são os nossos clientes ativos”, “esse estado não é usado desde 2022”, “estas contas pertencem à região errada”, “este cliente deveria ter três contratos ativos”. Então a validação de negócio é uma etapa explícita do go-live, com pessoas nomeadas, relatórios nomeados, registos nomeados e uma aprovação nomeada, não “dá uma olhada quando tiver tempo”.

Authority Moves on Day 0

Why not move everything on Day 0? The Number of Zeros. If the full migration takes 18 hours and the business tolerates 4 hours of downtime, we have a problem, and moving data earlier solves it. History goes in before cutover while the legacy system stays authoritative; the window only has to handle what changed, what couldn’t be preloaded, final relationships, validation and reconciliation. Instead of moving eight years of history during the outage, we’re closing a gap. ⟲

But preloaded data needs protection. If production data lands on Day −7, can users see it, edit it, can automation react, can integrations publish it, can agents act on it? The answer should be: not yet. So we keep it hidden by sharing, owned and controlled, with automation and integrations held back (module 3). A preload isn’t “put the records in early.” It’s put them in early without accidentally making the new system authoritative early. ⟲

Before cutover, the legacy system is authoritative and Salesforce holds a staged, increasingly current copy. During cutover we close the gap. At the agreed moment, authority moves, and afterward Salesforce is authoritative. For Steve Trucking that moment is Day 0: from then on, a delivery’s truth lives in Salesforce, and RouteDesk is a read-only record of the past. That’s where chapters 6, 9 and 10 meet: identity, authority, movement and cutover aren’t separate problems; they’re views of the same data lifecycle. ⟲

So don’t let two systems both think they’re master. If the legacy system stays writable after cutover, a coordinator changes a delivery window in Salesforce, another changes it in the legacy system, and both systems think they own it. Last write wins? Salesforce wins? Human review? If that’s unanswered, we haven’t finished a migration; we’ve created two writable copies. Chapter 9’s rule: technical permission isn’t architectural authority. ⟲

Not every migration needs ongoing synchronization. If we’re replacing the legacy system completely, Day 0 comes, the final deltas load, reconciliation passes, users move, the old system goes read-only and is eventually archived or retired. Don’t build a permanent integration because “migrations usually have integrations.” If the old system is dead, stop feeding it. That’s RouteDesk: on Monday it’s read-only, then it’s retired, and nothing syncs with it. The synchronization Steve Trucking does need is a different arrow, Salesforce to Snowflake, designed in chapter 9 and covered in module 5. ⟲

Clique para ampliar

The gap closes, authority moves, and the migration ends. The Snowflake feed goes on. ⟲

The opposite happens too. A transition that lasts months, users active in both systems, business units moving at different times: synchronization may have to start before the migration is finished. Now the migration is still moving the historical baseline while synchronization keeps live records consistent, and that’s a much harder architecture. You need to know which process owns which changes, or the load and the sync overwrite each other. So define the boundary visibly: before this point we’re building the target state; after it we’re maintaining consistency. It might be a timestamp, a cutover event, a business-unit transition, an object-by-object switch, a watermark. If nobody can tell me whether a record belongs to the migration process or the synchronization process, we have overlapping ownership, and that’s where records get missed or processed twice. ⟲

De volta ao normal, depois o hypercare

Restore normal operation deliberately: automation, scheduled jobs, integrations, event consumers, agents, user access, in an order that matters. For Steve Trucking: take the bypass away from the migration user, switch the Change Data Capture subscriber back on from the cutover point (so Snowflake gets Monday’s changes, not the weekend’s load), run module 3’s one backfill, then let the coordinators in. Remember module 3’s catch-up storm: when an integration comes back, what does it think happened while it was off? When users come back, is every critical service actually ready? The return to normal is part of the cutover. ⟲

Aí estamos no ar, mas não terminamos. Durante um período de estabilização (chame-o de hypercare), vigie os erros de migração, as falhas de integração, a automação inesperada, as duplicados novas, as relações a faltar, os problemas de desempenho, os problemas de dados relatados pelos utilizadores e os desvios de conciliação. O risco da migração não desaparece no momento em que os utilizadores fazem login.

Then clean up: temporary migration users and permissions, bypass settings, staging data, temporary scripts, migration-only configuration, files holding sensitive source data, temporary integrations, runbook access. Don’t leave migration scaffolding attached to production because “we might need it someday.” Temporary architecture needs an exit plan too. Don’t forget the preparation data store. After RouteDesk, it holds eight years of Recipients’ names, addresses and phone numbers in its raw tables. Keep what the retention policy says to keep, as evidence, then delete the rest, on a date someone owns. ⟲

E guarde as evidências: a extração final, a versão da transformação, os ficheiros de carga, os resultados dos jobs, os ficheiros de erros, os relatórios de conciliação, as aprovações, o runbook com os horários reais, a decisão de go/no-go e as exceções. Três semanas depois, alguém vai perguntar se um registo já estava errado antes da migração ou por causa dela. Deveria conseguir responder. Confie, mas verifique não termina quando a carga termina.

A IA pode ajudar a vigiar a transição. O go/no-go não é dela.

A IA é útil sob a pressão da transição: resumir as falhas, classificar os erros, comparar relatórios, identificar anomalias, acompanhar o runbook, apontar desvios em relação ao ensaio. Mas o go/no-go combina evidências técnicas, impacto no negócio, tempo restante, posição de rollback e tolerância a risco. A IA pode trazer as evidências à tona. As pessoas responsáveis tomam a decisão.

Além do exame: o que a IA muda. A IA pode tornar mais rápidos o monitorização e a conciliação da transição, principalmente ao encontrar padrões em grandes conjuntos de dados de erros e de validação. Mantenha a responsabilidade humana explícita pelo go/no-go, pelo rollback e pela aceitação de riscos de migração não resolvidos.

O que um arquiteto decide aqui

• The rehearsal depth, the Day −7 / Day −1 / Day 0 load plan and the rollback point (what loads early, hidden by sharing) and the runbook that makes production cutover repeatable. ⟲
• Como os utilizadores são bloqueados e deixados voltar, com uma porta dos fundos e utilizadores de teste de fumaça, e como a automação, as integrações e os agentes são controlados enquanto isso.
• Os critérios de go/no-go, o procedimento de rollback e o ponto depois do qual o rollback deixa de ser a recuperação segura, e os dados e fluxos desconhecidos que precisam de ser encontrados primeiro.
• Como a migração é provada com contagens, totais, verificações pontuais e relatórios agregados, contra valores previstos definidos antes da carga.
• Que validação de negócio, evidências e estabilização pós-go-live são exigidas antes de a migração estar concluída.

A transição é prova

Os scripts correram: não basta. A API devolveu sucesso: não basta. As contagens de linhas bateram: ainda não basta. Quero contagens, totais, verificações pontuais e relatórios agregados, a validação de negócio, o sistema de volta ao normal, saber se ainda estamos dentro da janela de rollback e evidências de exatamente o que aconteceu. A transição em produção deveria ser entediante, porque fizemos o pensamento difícil antes da sexta à noite. Confie, mas verifique. Depois deixe os utilizadores voltarem.

Para saber mais

• Others who cut over the same way: Salesforce Help, B2C Commerce Realm Split FAQ (abre num novo separador); Microsoft Learn, Data migration planning for go-live (abre num novo separador); AWS, Components of AWS DMS (abre num novo separador); all checked 2026-11-01. ⟲
• Salesforce Help: Freeze or Unfreeze User Accounts (abre num novo separador) and Custom Login Flows (abre num novo separador) (login flows are assigned by profile), checked 2026-11-01. ⟲
• Neste curso: Dados mestres e identidade e Integração e movimentação de dados.