SuperAPI AI 工具集

database-patterns

编程与开发

查看项目

更新于 10-16 06:38

技能介绍

用途

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 操作、时间戳、行级安全的用户范围查询以及多表事务操作的场景。

限制

资料未提供关于性能、并发、平台兼容性、收费或价格的具体信息,相关内容暂未提供。