sqlite数据库文件太大，如何清理

[daleqq]

长时间时候后，sqlite数据库文件太大，请问需要如何清理？

[MLuc24]

旧数据其实是在自动清理的，问题出在 SQLite 不会因为删除数据就把文件缩小。

derived_cleanup.go 里有一整套维护逻辑：RunDerivedStartupMaintenance 在启动时跑一次，StartDerivedMaintenance 之后按周期跑，cleanupDerivedUntilIdle 会分批删除派生表里的过期记录。所以行是真的被删掉了。

但连接参数里只设了这三个：

query.Add("_pragma", "busy_timeout(5000)")
query.Add("_pragma", "foreign_keys(1)")
query.Add("_pragma", "synchronous(FULL)")

没有 auto_vacuum，而 SQLite 的默认值就是关闭。代码里也没有任何地方执行 VACUUM。这意味着删除释放出来的页面只是变成文件内部的空闲页，留着以后写入时复用 —— 文件本身不会变小，只会随着数据峰值一路涨上去，然后停在那个高点。

所以你看到的「越来越大」和清理没做是两回事。想真正把空间还给磁盘，停掉服务后手动执行一次就行：

sqlite3 /path/to/your.db "VACUUM;"

两个注意点。VACUUM 是重写整个数据库文件，过程中磁盘上需要有大约和现有文件同样大的空闲空间；另外它要拿独占锁，必须在服务停止的状态下做，不能一边跑一边清。

做完之后一般不需要定期重复。既然过期数据本来就在自动清理，文件大小会稳定在实际数据量对应的水平附近，除非你的数据规模本身还在持续增长。

[seakee]

CPAMP 这边确实有自动清理逻辑，不过清理的是对应的历史派生/统计数据，不代表所有历史数据都会统一删除。

SQLite 在当前这种使用方式下，DELETE 之后只是把页面标记为空闲，后续可以继续复用，但数据库文件本身通常不会立刻变小，所以看到 usage.sqlite 体积没有下降是正常的。

如果希望实际释放磁盘空间，可以对数据库执行 VACUUM。建议先停止 CPAMP，做好数据库备份后再执行，避免运行过程中持续写入带来的锁竞争或其他问题。

另外需要注意，VACUUM 重建数据库时会需要额外的临时磁盘空间。如果当前磁盘已经接近占满，不建议直接执行，最好先腾出足够空间。

[daleqq]

如果想要重新使用一个新数据库，直接删掉现有的数据库然后重新启动CPAMP就可以自动创建新的数据库？

[seakee]

如果想要重新使用一个新数据库，直接删掉现有的数据库然后重新启动CPAMP就可以自动创建新的数据库？

可以，不过建议不要在 CPAMP 运行中直接删除数据库。

正确的做法是先停止 CPAMP，然后把 usage.sqlite 删除（如果同目录还有 usage.sqlite-wal、usage.sqlite-shm，也一起处理），再重新启动。当前 CPAMP 启动时会自动创建数据库目录、打开 SQLite，并执行完整的数据库初始化/迁移，所以不存在数据库文件时会自动生成一套新的数据库。

不过需要注意，usage.sqlite 现在不只是请求记录和统计数据，CPAMP 自身保存的部分配置、CPA 连接信息以及管理端认证状态也在里面。所以删掉重新创建，本质上相当于重置 Manager Server 的持久化数据，这些内容也需要重新配置。

data.key 一般不用删除，可以继续保留。如果只是想“从零开始统计数据”，我更建议先把原来的数据库文件改名或备份，而不是直接删掉，确认新数据库运行正常之后再清理旧文件。官方文档里备份数据时也是把 usage.sqlite、WAL/SHM 和 data.key 分开处理的。

如果连 data.key 也一起删除，那就属于更彻底的初始化了，新启动会重新生成数据密钥；这种情况下旧数据库里加密保存的数据后面就不能再靠新的 key 解密了。