Execution controls
Bound source load and invocation length without confusing a budget with completion.
Invocation budgets
--max-rows and --max-duration-seconds apply per invocation. Time is checked at safe boundaries, so an in-flight batch may finish after the requested duration. Zero clears a saved budget on resume/retry; unspecified controls preserve the saved value. Duration is limited to one year.
Load and capacity
--batch-delay-ms is 0–3,600,000 (default 0). --query-timeout-ms defaults to 10,000; --lock-timeout-ms defaults to 2,000. Both accept 1–300,000 ms and lock timeout must not exceed query timeout. --min-free-bytes defaults to 1 GiB and must be positive; disk checks are point-in-time, not space reservations.
Bounded example
The command below limits each invocation and adds a delay between batches. Inspect returned status and durable counters before deciding whether to resume.
coldctl archive run orders-archive --source-stability quiescent-copy --max-rows 10000 --max-duration-seconds 300 --batch-delay-ms 100 --query-timeout-ms 10000 --lock-timeout-ms 2000