using-neon

Neon Serverless Postgres 使用指南

技能概述

using-neon 提供 Neon Serverless Postgres 的完整使用指南，帮助开发者掌握无服务器数据库的连接方法、核心功能和最佳实践。

适用场景

Serverless 和边缘函数应用

使用 @neondatabase/serverless 驱动通过 HTTP/WebSocket 连接 Neon，非常适合部署在 Vercel、Cloudflare Workers 等 serverless 平台的应用，以及需要从边缘位置低延迟访问数据库的场景。

需要数据库分支的开发工作流

利用 Neon 的分支功能创建瞬时数据库副本，支持并行开发、测试环境隔离和 CI/CD 流水线集成，每个分支都可以独立操作而不影响生产数据。

需要认证和 Data API 的项目

使用 @neondatabase/auth 实现安全的数据库认证，或通过 @neondatabase/neon-js 使用 PostgREST 风格的数据 API，无需编写 SQL 即可进行数据库操作。

核心功能

智能连接方法选择

根据运行时平台（Node.js、浏览器、边缘函数）和应用场景，指导选择合适的连接方式：serverless 驱动、标准 pg 驱动、Drizzle ORM 集成，或使用 Neon JS SDK 的 Data API。

Neon 平台功能全覆盖

涵盖 Neon 的核心特性，包括自动扩展（autoscaling）、数据库分支（branching）、即时恢复（instant restore）、缩放到零（scale-to-zero），以及通过 CLI 或 Platform API 进行资源管理。

认证与 API 集成

提供 @neondatabase/auth 认证库的使用指南，以及 Neon Platform API 和 TypeScript/Python SDK 的文档索引，支持自动化管理 Neon 项目和数据库资源。

常见问题

Neon Serverless Postgres 和传统 Postgres 有什么区别？

Neon 是完全兼容 Postgres 的无服务器平台，主要区别在于架构：Neon 将计算和存储分离，支持自动扩展、缩放到零、数据库分支等云原生功能。你可以像使用普通 Postgres 一样使用 SQL、pg 驱动和任何 ORM，但额外获得云服务的弹性。

如何选择 Neon 的连接方式？

选择取决于你的运行时环境：Node.js 后端应用可使用标准 pg 驱动；serverless/边缘函数应使用 @neondatabase/serverless 驱动；需要免 SQL 操作时可使用 @neondatabase/neon-js 的 Data API；使用 Drizzle ORM 时有专门的集成指南。

Neon 的分支功能适合什么场景？

数据库分支非常适合开发测试、预发环境、CI/CD 流水线。你可以在几秒钟内创建一个包含完整数据的数据库副本，用于并行开发、测试新功能、或安全地执行 schema 变更，分支完成后可以删除或合并到生产环境。