关于 neon-postgres
面向使用 Neon Postgres 的开发者,提供 Prisma、Drizzle 与连接池配置指导。内容重点说明应用连接和数据库迁移应使用不同连接方式。
主要功能
- 01配置 Prisma 连接池
- 02使用 Drizzle Serverless 驱动
- 03区分池化与直连端点
- 04说明 PgBouncer 连接池限制
适用场景
- 01为 Prisma 应用配置 Neon
- 02在边缘或无服务器环境使用 Drizzle
- 03为迁移配置直连数据库
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davila7/ claude-code-templates --skill neon-postgres安装后在 Claude Code 中输入/neon-postgres确认已加载。
详细介绍
Neon Postgres
模式
Prisma 与 Neon 连接
为 Neon 配置 Prisma,并启用连接池。
使用两个连接字符串:
- DATABASE_URL:供 Prisma Client 使用的池化连接
- DIRECT_URL:供 Prisma Migrate 使用的直接连接
池化连接使用 PgBouncer,最多支持 10K 个连接。 迁移(DDL 操作)必须使用直接连接。
Drizzle 与 Neon 无服务器驱动
在边缘/无服务器环境中,使用 Drizzle ORM 和 Neon 的无服务器 HTTP 驱动。
有两种驱动选项:
- neon-http:通过 HTTP 执行单条查询(最适合一次性查询)
- neon-serverless:通过 WebSocket 支持事务和会话
使用 PgBouncer 进行连接池管理
Neon 通过 PgBouncer 提供内置连接池。
主要限制:
- 连接池最多支持 10,000 个并发连接
- 连接仍会占用底层 Postgres 连接
- 为 Neon 超级用户保留 7 个连接
应用使用池化端点,迁移使用直接端点。
⚠️ 注意事项
| 问题 | 严重程度 | 解决方案 |
|---|---|---|
| 问题 | 高 | 参见文档 |
| 问题 | 高 | 参见文档 |
| 问题 | 高 | 参见文档 |
| 问题 | 中 | 参见文档 |
| 问题 | 中 | 参见文档 |
| 问题 | 低 | 参见文档 |
| 问题 | 中 | 参见文档 |
| 问题 | 高 | 参见文档 |
评论
支持 Markdown