Principle:Risingwavelabs Risingwave CDC Offset Management
| Knowledge Sources | |
|---|---|
| Domains | CDC, State_Management, Recovery |
| Last Updated | 2026-02-09 07:00 GMT |
Overview
Offset tracking and context management for CDC binlog-based replication, enabling resume from precise positions in the change stream.
Description
CDC Offset Management handles the persistent tracking of replication positions within database change streams. For binlog-based sources (MySQL, MariaDB), offset context includes the binlog filename, byte position within the file, GTID sets, event counts, and row-within-event numbers. These multi-level coordinates enable precise positioning within the change stream. The offset context is stored via a configurable backing store and restored during connector restart to resume replication from the exact point where it stopped. This principle ensures no data loss or duplication across connector restarts.
Usage
Apply this principle when implementing or extending CDC connectors that need reliable position tracking across restarts, particularly for binlog-based sources.