SELECT * FROM <some table> should return the same data on the source and the replica.
If a table is genuinely stale and the issue is not a transient connectivity problem, you can force a re-synchronization.
This page covers the new outbound-only client. For the legacy WCF-based mirroring service, see the legacy procedure at the bottom of this page.
When you need a re-sync
Common reasons:- A table is missing rows after extended client downtime.
- You suspect schema drift between source and replica.
- You want to revalidate a single table against the source after an incident.
Recover from extended downtime (longer than 7 days)
Change events are streamed through Kafka topics with a default retention of 7 days. If the client is offline longer than that window, change events will have been purged from the topics. The client cannot fill the gap by replaying older events, it has to be re-snapshotted. You have three options, from least to most disruptive:Option A - Re-snapshot specific tables (recommended)
Use theresync-tables CLI command to trigger a Debezium signal-based snapshot of just the affected tables. The client truncates each table locally first, then receives a fresh snapshot from the cloud:
Option B - Trigger via the Replication Service API
The same operation can be triggered from a backend or operations tool:Option C - Full reset (operations only)
If the entire replica needs to be rebuilt from scratch, SuperOffice Operations can reset all connector offsets, which triggers a complete re-snapshot of all tables:Validate after a re-sync
Once the snapshot completes:- Confirm the table is no longer empty and row counts look reasonable.
- Spot-check a handful of recent changes from the source.
- Check the Windows Event Log for any errors (source
SuperOfficeReplicationClient).
Legacy (WCF-based) mirroring
[!IMPORTANT] This section applies only to the legacy WCF-based mirroring service. New deployments use the outbound-only client and follow the procedure above.
Restart synchronization for a single table
-
Using SQL Server Management Studio, open the
<context identifier>_mirroringtable. -
For each table you have identified as having a problem, set
LSNto-1in the mirroring table. -
Then truncate the data in the table(s) you set the LSN to
-1: - Shortly thereafter, the legacy Mirroring Task will send an authentication request, which your client must respond to. After successful authentication, SuperOffice will begin to deliver periodic updates to your mirroring service.
Hard reset the legacy mirror
-
Using SQL Server Management Studio, open the
<context identifier>_mirroringtable. -
For each table you have identified as having problems, for example
contact: - Then drop the affected table.
- Shortly thereafter (the next mirroring cycle), the legacy Mirroring Task will send an authentication request, which your client must respond to. After successful authentication, SuperOffice will recreate the table and begin to deliver periodic updates.