Files
archer/openspec/changes/archive/2026-11-06-add-compress-level-and-xz/specs/cli-contract/spec.md
T
voidandClaude Sonnet 4.6 bc4a6b504f Initial commit: archer, a Go-native MySQL/MariaDB table archiver
Renamed from arcdb: module path, cmd/archer, internal/archererr,
docs, build scripts and ARCHER_* environment variables.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-06 22:12:17 +08:00

1.9 KiB
Raw Blame History

MODIFIED Requirements

Requirement: 默认值

系统 SHALL 采用以下默认值:--chunk-size 2000、--shard-by none、--shard-rows 0、--format dump、--compress none、--compress-level 3、--max-lag 1s、--check-interval 1s、--retries 1、--safe-auto-increment true、--progress 0。

Scenario: 最小可运行配置

  • WHEN 用户只提供 --source、--table、--where、--file
  • THEN 系统以 2000 行一个 chunk、不分片、dump 格式、不压缩的方式导出

Requirement: 参数依赖与互斥

系统 MUST 校验以下规则:--shard-by date 必须有 --shard-column;--shard-by count|none 不得带 --shard-column;--shard-rows 仅在 --shard-by count 或 date 时有效;--bulk-delete 依赖 --purge 且在日期模式下禁止;普通插入、--insert-ignore、--replace 三者互斥;--compress-level MUST 在 1–9 范围内;--compress none 与非默认档位同时出现时 MUST 视为配置错误。违反时 MUST 在启动阶段报错。

Scenario: 数量模式误传日期列

  • WHEN --shard-by count 同时带上 --shard-column
  • THEN 系统报错,说明该参数仅在日期模式下有效

Scenario: 未启用 purge 却要求 bulk-delete

  • WHEN 用户指定 --bulk-delete 但未指定 --purge
  • THEN 系统报错,说明 bulk-delete 必须配合 purge

Scenario: 插入模式互斥

  • WHEN 用户同时指定 --insert-ignore 与 --replace
  • THEN 系统报错,要求只能选择一种插入模式

Scenario: 压缩档位越界

  • WHEN 用户指定 --compress-level 0 或 --compress-level 10
  • THEN 系统在启动阶段报错,说明档位必须在 1–9 之间

Scenario: 不压缩却指定非默认档位

  • WHEN 用户指定 --compress none 与 --compress-level 5
  • THEN 系统在启动阶段报错,说明压缩档位仅在启用压缩时有效