postgres-drizzle

PostgreSQL 和 Drizzle ORM

根据项目已安装的 API 和部署环境处理数据库工作。用户的明确指示优先于本技能的指南。

确定数据库约定

将相关的架构／查询、迁移历史和所需行为作为输入。对于 Drizzle 代码，检查已安装的 drizzle-orm／drizzle-kit 版本和驱动；对于 SQL，如果某项功能与版本有关，则确认 PostgreSQL 版本。

参考资料涵盖 PostgreSQL 17/18，并区分 Drizzle 的 0.x relations() API 和 v1 defineRelations() API。不要混用它们，也不要根据 npm dist-tag 推断已安装的 API。版本未知时，使用导入信息／锁文件确认，或在提供依赖版本相关的代码前询问缺失的版本信息。

保持变更一致

• 将数据库外键与 ORM 关系元数据分别声明。根据实际关系匹配可空性、唯一性和删除行为。
• 在事务中执行每条语句时，都使用事务句柄；通过外部连接执行的查询可能会脱离事务。
• 根据执行计划和工作负载证据诊断慢查询。评估引用列上的索引；PostgreSQL 不会自动创建这些索引。
• 为架构变更生成并检查迁移 SQL。保留已应用的迁移历史；后续变更使用新的迁移。
• 执行迁移或 push 前，先确认目标。编写或审查 SQL 本身不要求对数据库执行操作。如果用户已授权该目标和操作，则继续执行。
• 将 EXPLAIN ANALYZE 视为查询执行，包括写入操作。如果任务范围不允许执行，请使用合适的测试目标或不会执行查询的计划。

交付所需的 SQL／代码、迁移或诊断结果，并说明兼容性假设和相关验证。如果用户要求执行但未提供目标，则准备好变更，并仅询问缺失的目标信息。

参考资料

阅读与当前操作相关的主题。

任务	参考资料
表、类型、约束、索引、生成列	SCHEMA.md
读取、写入、联接、事务、预备查询	QUERIES.md
关系和特定版本的关系查询 API	RELATIONS.md
drizzle-kit 配置、迁移生成和发布	MIGRATIONS.md
PostgreSQL 功能、RLS、分区、JSONB、全文搜索	POSTGRES.md
查询计划、索引、连接池、分页、批量操作	PERFORMANCE.md
快速查询语法或连接设置	CHEATSHEET.md

对于项目已安装版本和参考资料未涵盖的 API 或支持情况，请查阅与版本匹配的 Drizzle 和 PostgreSQL 文档。