Skip to main content

Incremental extraction

Incremental extraction is a worker execution concern. The CLI submits only a registered configuration version and does not select local extraction or cache controls.

A configuration package can declare the optional incremental capability. During validation, optional-feature-unqualified warns when the selected source adapter does not qualify that feature. During execution, the worker decides whether a prior compatible cursor permits a warm extraction and falls back to a full extraction when it does not.

Timestamp-based incremental extraction can miss deleted source rows. The worker therefore uses its configured full-resynchronization cadence. When the destination was not fully enumerated, a saved plan reports delete_operations_computed: false; runs plan discloses that the review may omit destination deletes.

Current timestamp-capable adapters include NetBox, Nautobot, and Infrahub. Other adapters use full extraction unless their capability contract says otherwise.