Cloudflare Workers 可以连接并查询 SQL 和 NoSQL 数据库中的数据,包括:
- Cloudflare 自有的 D1 无服务器 SQL 数据库,以及带 SQLite 存储的 Durable Objects。
- 传统托管数据库:关系型数据库如 Postgres 和 MySQL,使用 Hyperdrive(推荐)显著加速访问;以及 NoSQL 数据库如 MongoDB。
- 无服务器数据库,包括 Supabase、PlanetScale 和 Prisma。
Cloudflare 为 Workers 提供两种原生 SQL 数据库选项,两者均由 SQLite 支持,并通过 Workers 绑定(binding) 访问,而不是网络连接。
D1 是 Cloudflare 自有的基于 SQL 的无服务器数据库。它针对从 Workers 进行全球访问进行了优化,可通过多个较小的(10GB)数据库横向扩展,例如按用户、按租户或按实体划分的数据库。与部分无服务器数据库类似,D1 的定价基于查询和存储成本。
Durable Objects 提供更底层的构建块:基于 SQLite 的 Durable Object 嵌入私有 SQLite 数据库(最多 10 GB),你通过 SQL 存储 API(ctx.storage.sql.exec)同步查询。因为存储与计算共置,这适合按用户、按租户或按实体的 SQL 状态以及分布式系统协调。D1 本身构建在 Durable Objects 之上。
| 数据库 | 库或驱动 | 连接方式 |
|---|---|---|
| D1 | Workers 绑定(binding),可与 Prisma ↗、Drizzle ↗ 及其他 ORM 集成 | Workers 绑定(binding)、REST API |
| Durable Objects | SQL 存储 API(ctx.storage.sql) |
Workers 绑定(binding) |
传统数据库使用原生驱动通过 TCP 套接字连接。TCP 是许多数据库用于客户端连接的事实标准协议,这些驱动也与你常用的 ORM 库和查询构建器广泛兼容。
PostgreSQL 和 MySQL 等关系型数据库使用其原生 SQL 驱动通过 TCP 连接。
这也包括与 PostgreSQL 或 MySQL 兼容的无服务器数据库,如 Supabase、Neon 或 PlanetScale(MySQL 或 PostgreSQL), 可通过原生 TCP 套接字和 Hyperdrive 或无服务器基于 HTTP 的驱动(详见下文)连接。
| 数据库 | 集成 | 库或驱动 | 连接方式 |
|---|---|---|---|
| Postgres | 直接连接 | node-postgres ↗、Postgres.js ↗ | 通过数据库驱动的 TCP 套接字,使用 Hyperdrive 获得最佳性能(可选,推荐) |
| MySQL | 直接连接 | mysql2 ↗、mysql ↗ | 通过数据库驱动的 TCP 套接字,使用 Hyperdrive 获得最佳性能(可选,推荐) |
MongoDB 是面向文档的数据库,使用其原生 Node.js 驱动通过 TCP 连接。Hyperdrive 不支持 MongoDB,因此要池化连接并降低延迟,请将客户端持久化在 Durable Object 中。设置说明请参阅连接到 MongoDB。
| 数据库 | 集成 | 库或驱动 | 连接方式 |
|---|---|---|---|
| MongoDB | 直接连接 | mongodb ↗、mongoose ↗ | 通过原生驱动的 TCP Socket |
无服务器数据库可能提供对底层数据库的直接连接,或提供基于 HTTP 的代理和驱动(也称为无服务器驱动)。
对于 PostgreSQL 和 MySQL 无服务器数据库,你可以使用熟悉的原生数据库驱动和 ORM 直接连接底层数据库,并使用 Hyperdrive(推荐)加速连接并池化数据库连接。使用 Hyperdrive 时,连接池在所有 Cloudflare 区域中统一管理,并针对 Workers 的使用进行了优化。
你也可以使用无服务器驱动库连接数据库提供商管理的基于 HTTP 的代理。这些库同样可以为传统 SQL 数据库提供连接池,并减少建立安全连接所需的往返次数,与 Hyperdrive 类似。
| 数据库 | 库或驱动 | 连接方式 |
|---|---|---|
| PlanetScale ↗ | Hyperdrive (MySQL)、Hyperdrive (PostgreSQL)、@planetscale/database ↗ | mysql2、mysql、node-postgres、Postgres.js,或通过客户端库的 API |
| Supabase ↗ | Hyperdrive、@supabase/supabase-js ↗ | node-postgres、Postgres.js,或通过客户端库的 API |
| Prisma ↗ | prisma ↗ | 通过客户端库的 API |
| Neon ↗ | Hyperdrive、@neondatabase/serverless ↗ | node-postgres、Postgres.js,或通过客户端库的 API |
| Hasura ↗ | API | 通过 fetch() 的 GraphQL API |
| Upstash Redis ↗ | @upstash/redis ↗ | 通过客户端库的 API |
| TiDB Cloud ↗ | @tidbcloud/serverless ↗ | 通过客户端库的 API |
安装必要的包后,使用这些包提供的 API 连接数据库并执行操作。请参阅各服务的详细链接获取具体说明。
如果数据库需要身份验证,请使用 Wrangler secrets 安全存储凭据。为此,使用以下 wrangler secret 命令在 Cloudflare Workers 项目中创建 secret:
wrangler secret put <SECRET_NAME>然后,使用以下代码片段在代码中检索 secret 值:
const secretValue = env.<SECRET_NAME>;使用 secret 值对外部服务进行身份验证。例如,如果外部服务需要 API 密钥或数据库用户名和密码进行身份验证,请使用相关服务的库或 API 提供这些信息。
对于需要 mTLS 身份验证的服务,请使用 mTLS 证书 呈现客户端证书。
- 了解如何使用 Hyperdrive 连接现有 PostgreSQL 数据库。
- 发现可与 Workers 配合使用的其他存储选项。
- 使用 Cloudflare D1 创建你的第一个数据库。