SST项目中从Aurora迁移到RDS PostgreSQL的实践指南

背景介绍

在使用SST框架构建云应用时，数据库的选择和配置是一个关键环节。近期SST 3.1.70版本后对PostgreSQL数据库支持进行了重要调整，将默认数据库从Aurora Serverless v2变更为RDS PostgreSQL，这一变化影响了使用Drizzle ORM的开发者的配置方式。

新旧版本差异分析

在SST 3.1.70版本之前，开发者使用的是Aurora Serverless v2数据库，其配置方式依赖于两个关键ARN参数：

• secretArn：用于存储数据库凭证的Secrets Manager ARN
• clusterArn：Aurora集群的ARN

这种配置方式在Drizzle ORM的官方文档中仍有体现，但随着SST的更新已经不再适用。新版本中，SST团队基于以下考虑做出了这一变更：

1. 成本因素：Aurora初始成本较高，不适合中小规模应用
2. 兼容性问题：Aurora与标准PostgreSQL存在一些不兼容特性
3. 实践体验：Data API在实际使用中存在诸多限制
4. 易用性：RDS PostgreSQL配合sst tunnel工具提供了更好的开发体验

新版配置方案

1. SST配置文件调整

在新版本中，数据库配置应使用sst.aws.Postgres而非之前的Aurora配置：

const database = new sst.aws.Postgres("MyDatabase", {
  vpc,
});

2. Drizzle配置文件更新

Drizzle ORM的配置文件需要调整为直接使用数据库连接参数：

export default defineConfig({
  dialect: "postgresql",
  dbCredentials: {
    user: Resource.MyDatabase.username,
    password: Resource.MyDatabase.password,
    host: Resource.MyDatabase.host,
    port: Resource.MyDatabase.port,
    database: Resource.MyDatabase.database,
  },
  schema: ["./src/**/*.sql.ts"],
  out: "../../migrations",
});

3. 应用层数据库连接

在应用代码中建立数据库连接时，也应使用新的连接参数：

const client = new Pool({
  user: Resource.MyDatabase.username,
  password: Resource.MyDatabase.password,
  database: Resource.MyDatabase.database,
  host: Resource.MyDatabase.host,
  port: Resource.MyDatabase.port,
});

迁移注意事项

1. 版本兼容性：确保SST版本在3.1.70及以上
2. VPC配置：建议启用bastion功能以便本地开发调试
3. 资源链接：在Next.js等前端应用中正确链接数据库资源
4. 权限管理：检查IAM权限是否适配新的RDS连接方式

高级使用场景

对于确实需要Aurora Serverless v2特性的项目，SST仍保留了支持方案：

const database = new sst.aws.Postgres.v1("MyAuroraDatabase", {
  // Aurora特有配置
});

最佳实践建议

1. 对于大多数应用场景，推荐使用新的RDS PostgreSQL方案
2. 仅在预期会有极大流量规模时考虑使用Aurora
3. 充分利用sst tunnel工具简化开发环境配置
4. 定期检查SST和Drizzle文档获取最新配置方式

这一变更体现了SST团队对开发者体验的持续优化，通过简化配置和降低成本，使开发者能够更专注于业务逻辑的实现。