GitHub
07/24/2025, 7:18 PMstart_date when using incremental replication with saved state.
## Context
Users may expect that changing the start_date configuration to an earlier date will cause the extractor to pull historical data. However, when incremental replication state exists, the bookmark dates in the state take precedence over the start_date setting.
## Changes
Added a new subsection "Start date and incremental replication" to the integration guide that:
• Explains that bookmark dates in state take precedence over start_date configuration
• Documents how to use the --full-refresh flag to ignore saved state and start from the configured start_date
• References the meltano state command as an alternative way to manage state directly
## Testing
Documentation-only change. Verified markdown renders correctly and links are valid.
Closes #2519
## Summary by Sourcery
Clarify incremental replication behavior and improve dump command guidance in the documentation.
Documentation:
• Explain that bookmark dates in saved state take precedence over the start_date setting for incremental replication and document the use of --full-refresh and meltano state commands to override this behavior
• Provide alternatives to meltano run --dump by documenting meltano state get, meltano config list, and meltano invoke commands for dumping state, extractor configuration, loader configuration, and catalog
meltano/meltanoGitHub
07/24/2025, 7:18 PMGitHub
07/24/2025, 7:55 PM