Field note · October 31, 2026
Pattern: Merge with a recency guard
Upsert on a natural key, and refuse to let an out-of-order replay overwrite good data with stale data.
The shape: MERGE … WHEN MATCHED AND source.updated_at > target.updated_at. — that is Merge with a recency guard, and it comes up more than it should.
Upsert on a natural key, and refuse to let an out-of-order replay overwrite good data with stale data.
What makes it a pattern rather than a tip is that the wrong version is the one you write naturally. It reads correctly, it runs, and it returns something. The failure is in the result, not in the execution — which means the only defence is recognising the shape before you are in it.
Two datasets on this site have the shape built in: saas-subscriptions and dirty-customers. Both are small enough to run the broken version, see the number, then run the corrected one and see it change.
It lives under moving because it is about data in transit: reruns, backfills, and the assumption that yesterday only ever arrives once.
The long-form treatment is in the course (idempotency-and-backfills, slowly-changing-dimensions); the pattern page is the version to read at 4pm with a query open.
If you have a better formulation of this one, the repository takes issues. Several entries there are sharper than what we started with because someone pushed back.