neon-postgres

Neon Postgres - 无服务器 PostgreSQL 专家技能

技能概述

提供 Neon serverless Postgres 的专家级模式和最佳实践，涵盖数据库分支、连接池配置以及 Prisma/Drizzle ORM 集成方案。

适用场景

无服务器应用开发：在 serverless 和 edge 函数环境中使用 Neon 的 HTTP 驱动进行数据库连接

高并发 Web 应用：利用 Neon 内置的 PgBouncer 连接池支持最多 10,000 并发连接

现代 ORM 集成：使用 Prisma 或 Drizzle ORM 与 Neon 数据库无缝集成

核心功能

Prisma 连接池配置：配置 Prisma Client 使用连接池、Prisma Migrate 使用直连的正确方式

Drizzle Serverless 驱动：支持 HTTP 驱动（单次查询）和 WebSocket 驱动（事务/会话）两种模式

连接池优化：使用 PgBouncer 实现高并发连接，了解连接限制和最佳实践

常见问题

Neon Prisma 需要两个连接字符串吗？

是的。Neon 与 Prisma 集成需要配置两个连接字符串：DATABASE_URL 使用连接池端点供 Prisma Client 日常查询使用，DIRECT_URL 使用直连端点供 Prisma Migrate 执行 DDL 操作。这是因为迁移操作需要直接连接到数据库，而连接池基于 PgBouncer 不支持 DDL 操作。

Drizzle 应该选择 HTTP 还是 WebSocket 驱动？

取决于使用场景。Neon HTTP 驱动适合单次查询，是最快的选择；WebSocket 驱动（neon-serverless）适合需要事务和会话的场景。如果只是简单的 CRUD 操作，HTTP 驱动性能更优；如果需要数据库事务或多步骤操作，应选择 WebSocket 驱动。

Neon 连接池有什么限制？

Neon 连接池基于 PgBouncer，最多支持 10,000 个并发连接。但需要注意这些连接仍然会消耗底层 Postgres 连接，且有 7 个连接预留给 Neon 超级用户。应用应使用连接池端点，迁移操作使用直连端点。