本教程演示了如何将 Drizzle ORM 与 Turso 一起使用。
This guide assumes familiarity with:
- 您应该已经安装了
dotenv
包以管理环境变量。有关该包的更多信息,请阅读 这里
- 您应该已经安装了
@libsql/client
包。有关该包的更多信息,请阅读 这里。
- 您应该已经安装了 Turso CLI。有关更多信息,请查看 文档
Turso 是一个兼容 SQLite 的数据库,建立在 libSQL 上,这是 SQLite 的开放贡献分支。它允许每个组织扩展到数十万个数据库,并支持将数据复制到任何位置,包括您自己的服务器,从而实现微秒级延迟访问。您可以在 这里 阅读有关 Turso 概念的更多内容。
Drizzle ORM 本身支持 libSQL 驱动程序,我们拥抱 SQL 方言及方言特定的驱动程序和语法,并反映大多数流行的类似 SQLite 的 all
、get
、values
和 run
查询方法语法。
请查看 官方文档 以设置 Turso 数据库。
设置 Turso 和 Drizzle ORM
注册或登录到 Turso
注册:
登录:
创建新数据库
通过运行 turso db create <DATABASE_NAME>
命令创建新数据库:
要查看有关数据库的信息,运行以下命令:
创建身份验证令牌
要为您的数据库创建身份验证令牌,请运行以下命令:
在 文档 中了解有关此命令及其选项的更多信息。
更新环境变量
用连接 URL 和身份验证令牌更新您的 .env
或 .env.local
文件。
将 Drizzle ORM 连接到您的数据库
在 src/db
目录中创建一个 index.ts
文件,并设置您的数据库配置:
创建表
在 src/db
目录中创建一个 schema.ts
文件并声明您的表:
设置 Drizzle 配置文件
Drizzle 配置 - 用于 Drizzle Kit 的配置文件,包含有关您的数据库连接、迁移文件夹和模式文件的所有信息。
在项目根目录中创建一个 drizzle.config.ts
文件并添加以下内容:
将更改应用到数据库
您可以使用 drizzle-kit generate
命令生成迁移,然后使用 drizzle-kit migrate
命令运行它们。
生成迁移:
这些迁移存储在 migrations
目录中,如您的 drizzle.config.ts
中所指定。该目录将包含更新数据库模式所需的 SQL 文件,以及一个 meta
文件夹,用于存储不同迁移阶段的模式快照。
生成的迁移示例:
运行迁移:
或者,您可以使用 Drizzle kit push 命令 将更改直接推送到数据库:
IMPORTANT
Push 命令适用于您需要在本地开发环境中快速测试新模式设计或更改的情况,允许快速迭代而无需管理迁移文件的负担。
基本文件结构
这是项目的基本文件结构。在 src/db
目录中,我们有与数据库相关的文件,包括在 index.ts
中的连接和在 schema.ts
中的模式定义。
查询示例
例如,我们可以创建 src/db/queries
文件夹,并为每个操作:插入、选择、更新、删除分别创建文件。
插入数据
有关插入查询的更多信息,请阅读 文档。
选择数据
有关选择查询的更多信息,请阅读 文档。
另外,您可以使用 关系查询语法。
更新数据
有关更新查询的更多信息,请阅读 文档。
删除数据
有关删除查询的更多信息,请阅读 文档。