本教程演示了如何使用 Drizzle ORM 和 Vercel Postgres。Vercel Postgres 是一个为 Vercel Functions 和您的前端框架设计的无服务器 SQL 数据库。
This guide assumes familiarity with:
- 您应该已经安装了
dotenv
包来管理环境变量。更多关于这个包的详情,请查看 这里
- 您应该已经安装了
@vercel/postgres
包。更多关于这个包的信息,请查看 这里
请查看 Vercel文档 了解如何使用 Drizzle ORM 连接到数据库。
设置 Vercel Postgres 和 Drizzle ORM
创建新的 Vercel Postgres 数据库
您可以在 仪表盘 中创建新的 Vercel Postgres 数据库。
阅读 Vercel Postgres 文档 了解如何创建新数据库。
设置连接字符串变量
导航到您的 Vercel Postgres 数据库并复制 POSTGRES_URL
来自 .env.local
部分。
将 POSTGRES_URL
添加到您的 .env.local
或 .env
文件。
连接 Drizzle ORM 到您的数据库
在 src/db
目录中创建一个 index.ts
文件并设置数据库配置:
创建表
在 src/db
目录中创建一个 schema.ts
文件并声明您的表:
设置 Drizzle 配置文件
Drizzle 配置 - 一个配置文件,由 Drizzle Kit 使用,并且包含了有关您的数据库连接、迁移文件夹和模式文件的所有信息。
在项目根目录中创建一个 drizzle.config.ts
文件并添加以下内容:
应用数据库更改
您可以使用 drizzle-kit generate
命令生成迁移,然后使用 drizzle-kit migrate
命令运行它们。
生成迁移:
这些迁移存储在 drizzle/migrations
目录中,正如您的 drizzle.config.ts
中指定的。这个目录将包含更新您的数据库模式所必需的 SQL 文件,以及一个 meta
文件夹,用于存储在不同迁移阶段的数据库模式快照。
生成的迁移示例:
运行迁移:
或者,您可以直接将更改推送到数据库,使用 Drizzle kit push 命令:
💡
Push 命令适合于快速测试新的模式设计或本地开发环境中的更改情况,无需管理迁移文件的额外开销,允许快速迭代。
基本文件结构
这是项目的基本文件结构。在 src/db
目录中,我们有一些关于数据库的文件,包括 index.ts
中的连接设置和 schema.ts
中的模式定义。
查询示例
例如,我们在 src/db/queries
目录中创建文件夹,并为每个操作分隔文件:插入、选择、更新和删除。
插入数据
在 文档 中阅读更多关于插入查询的信息。
选择数据
在 文档 中阅读更多关于选择查询的信息。
或者,您可以使用 关系查询语法。
更新数据
在 文档 中阅读更多关于更新查询的信息。
删除数据
在 文档 中阅读更多关于删除查询的信息。