用途:为 Python 项目提供 SQLite 的常用操作模式,适用于本地状态或配置存储、缓存层、事件日志、MCP 服务器持久化以及中小型数据集。
主要能力:资料给出连接与配置写法,使用 conn = sqlite3.connect(db_path, check_same_thread=False),设置 conn.row_factory = sqlite3.Row 以获得类字典访问,并执行 PRAGMA journal_mode=WAL 提升并发、PRAGMA foreign_keys=ON 启用外键约束。提供基于 contextlib.contextmanager 的事务模式,成功时 commit,异常时 rollback 并重新抛出。说明 WAL 模式适合并发读写场景(如 Web 应用、MCP 服务器),默认 DELETE 模式写入时读会被阻塞。
常见问题与对策:出现 database is locked 时启用 WAL;查询慢时添加索引并检查 EXPLAIN QUERY PLAN;线程安全使用 check_same_thread=False;外键未生效需运行 PRAGMA foreign_keys=ON。
CLI 快速参考:sqlite3 mydb.sqlite 打开数据库;.tables 列出表;.schema items 查看表结构;.headers on && .mode csv && .output data.csv 导出 CSV;VACUUM; 回收空间。
附加资源:可加载 ./references/schema-patterns.md(状态、缓存、事件、队列表设计)、./references/async-patterns.md(aiosqlite CRUD、批处理、连接池)、./references/migration-patterns.md(版本迁移、JSON 处理)。
限制:资料未提供具体版本要求、性能基准或收费信息,暂未提供。