用途
Database Patterns 是一套针对 SQLite 数据库操作的开发规范,基于 better-sqlite3 库。它适用于实现 CRUD 操作、时间戳记录,以及带行级安全(row-level security)的用户范围查询。
主要能力与核心原则
资料中明确列出以下核心原则:
- 预编译语句(Prepared statements):所有查询都应使用预编译语句,用于防止 SQL 注入。
- ID 生成:所有主键使用 nanoid() 生成,不使用自增(auto-increment)。
- 时间戳:以 Unix epoch 存储,使用 Date.now(),单位为毫秒。
- 行级安全(Row-level security):WHERE 子句中必须始终包含 user_id,禁止仅按 ID 单独查询。
- 事务(Transactions):用于多表操作,保证全有或全无(all-or-nothing)。
- 同步(Synchronous):better-sqlite3 是同步的,不需要 async/await。
使用方式
资料提供的 Quick Start 示例:
从 $lib/server/db 导入 db,从 nanoid 导入 nanoid。
SELECT 带 user_id(行级安全)示例:
const contact = db
.prepare('SELECT * FROM contacts WHERE id = ? AND user_id = ?')
.get(id, user_id) as Contact | undefined;
INSERT 使用 nanoid 与时间戳示例:
const stmt = db.prepare(
'INSERT INTO contacts (id, user_id, name, created_at, updated_at) VALUES (?, ?, ?, ?, ?)',
);
stmt.run(nanoid(), user_id, name, Date.now(), Date.now());
参考文件
资料列出以下参考文件:
- schema.md — 完整的 schema,包含列与类型
- relationships.md — 表关系与外键
- query-examples.md — 连接(joins)、事务与高级模式
适用场景
根据资料,适用于需要在 SQLite 中实现 CRUD 操作、时间戳、行级安全的用户范围查询以及多表事务操作的场景。
限制
资料未提供关于性能、并发、平台兼容性、收费或价格的具体信息,相关内容暂未提供。