SQLite 任务历史表上线检查清单

定时任务散落在多台机器，失败时只能翻日志，想知道“最近一周失败率有没有升高”很费劲。把每次执行写入 SQLite，单文件、零运维，足够支撑中小规模趋势查询。但上线前要把写入语义、索引和保留策略定清楚，否则很容易出现锁等待、全表扫描和磁盘膨胀。

一、先固定表结构与写入语义

每次任务尝试写一行，开始时插入 running，结束时更新为 success 或 failed。时间统一存 Unix 秒（UTC），不要存本地时间字符串；耗时由结束时间减开始时间计算，避免时区和格式问题。task_name、host、error_code 要能定位问题，trace_id 便于和日志关联。初始化脚本如下：

mkdir -p "$HOME/task-history"
sqlite3 "$HOME/task-history/history.db" <<'SQL'
PRAGMA journal_mode=WAL;
PRAGMA synchronous=NORMAL;
PRAGMA busy_timeout=5000;

CREATE TABLE IF NOT EXISTS task_run (
  id          INTEGER PRIMARY KEY,
  task_name   TEXT NOT NULL,
  started_at  INTEGER NOT NULL,
  finished_at INTEGER,
  duration_ms INTEGER,
  status      TEXT NOT NULL CHECK (status IN ('running','success','failed')),
  error_code  TEXT,
  host        TEXT,
  trace_id    TEXT
);
CREATE INDEX IF NOT EXISTS idx_task_name_started
  ON task_run(task_name, started_at);
CREATE INDEX IF NOT EXISTS idx_started
  ON task_run(started_at);
CREATE INDEX IF NOT EXISTS idx_status_started
  ON task_run