跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

PlanetScale Postgres 与 MySQL

最后更新 查看 MarkdownAgent 设置

创建 PlanetScale Postgres 或 MySQL 数据库,配合全球分布的 Workers 应用使用。

Cloudflare 与 PlanetScale ↗ 合作,为 Workers 提供 PlanetScale 托管的 Postgres 和 MySQL(Vitess)数据库。Hyperdrive 通过内置数据库连接池和查询缓存,将 Workers 连接到 PlanetScale 数据库,提升性能。

兼顾两款产品的优势:面向 Workers 全球分布构建,并针对区域数据访问进行优化。在 Cloudflare 仪表板中创建 PlanetScale 数据库即可开始。

前往 Create a PlanetScale database(创建 PlanetScale 数据库) ↗

从命令行创建数据库

你也可以使用 PlanetScale CLI ↗(pscale)从命令行创建由 Cloudflare 计费的 PlanetScale 数据库,并使用 Wrangler 授权请求的 Cloudflare 计费侧。这需要 pscale v0.313.0 或更高版本。

生成计费授权:

npx wrangler hyperdrive planetscale signature

这会打印一个 JSON payload:

{
	"account_id": "<ACCOUNT_ID>",
	"timestamp": "<TIMESTAMP>",
	"signature": "<SIGNATURE>"
}

pscale database create 通过 --cloudflare-billing 标志接受此 payload。传入 @- 会让 PlanetScale CLI 从标准输入读取,我们建议这样做,而不是将签名作为命令行参数传递:

npx wrangler hyperdrive planetscale signature | \
  pscale database create <DATABASE_NAME> \
    --org <PLANETSCALE_ORG> \
    --engine postgresql \
    --cloudflare-billing @- \
    --format json

pscale database create 默认使用 Vitess,因此 Postgres 数据库请传入 --engine postgresql;当输出由 Agent 消费时,建议使用 --format json。

你的 PlanetScale 凭据仅在你与 pscale 之间传递。Wrangler 只授权 Cloudflare 计费侧。

该签名是一个经过加密签名的令牌,用于授权创建记入你 Cloudflare 账户的数据库。请将其视为凭据,不要分享。

pscale database create 支持的选项请参阅 PlanetScale 文档 ↗。

Workers 与 PlanetScale

使用 Workers,可在 Cloudflare 覆盖 330+ 城市的全球网络上构建并部署应用。一步部署后,新地区的用户即可访问你的应用,无需部署区域基础设施。

Workers 计算靠近用户运行,延迟低。PlanetScale Postgres 为你的应用控制面或不适合 Cloudflare 边缘分布模型的集中式数据提供区域数据库。可用于客户、计费、账户设置等关系型数据记录。

Hyperdrive 是 Workers 与 PlanetScale 之间的连接桥梁。它池化数据库连接,并对符合条件的读查询使用 Cloudflare Cache,即使数据库集中部署,应用也能保持快速。

你能获得什么?

从用户请求到 Workers、Hyperdrive 缓存、连接池和 PlanetScale 的请求流。
  1. 靠近用户运行。 用户发送请求时,Cloudflare 将其路由到附近位置。Worker 在该位置运行,请求处理从靠近用户处开始。

  2. 本地检查缓存读。 在处理 Worker 请求的同一 Cloudflare 服务器上,Hyperdrive 在个位数毫秒(p90 4ms)内建立数据库连接,数据库客户端/驱动可立即发送查询。Hyperdrive 的连接建立会在同一本地机器上完成 TCP ↗ 连接启动、TLS ↗ 加密和客户端认证,消除到数据库的网络往返和延迟。连接就绪后,若 Worker 发送可缓存读查询且结果已缓存,Hyperdrive 会在该位置直接返回,无需离开。

  3. 需要时转发并在中间缓存。 若无本地缓存结果,或查询不可缓存,Hyperdrive 通过 Cloudflare 网络将查询发送到靠近 PlanetScale 数据库的位置。Hyperdrive 在到达数据库前还会检查该位置的另一层缓存;该缓存由多次数据库请求填充,类似分层缓存,提高缓存命中率。

  4. 仅在必要时查询 PlanetScale。 若两层缓存均无结果,Hyperdrive 使用已有连接池向 PlanetScale 发送查询。写入和其他不可缓存查询会到达 PlanetScale,数据库保持权威数据源。多层缓存降低数据库整体负载。

Hyperdrive 在应用写入 PlanetScale 时不会使缓存读结果失效。若应用对身份验证、会话、权限或其他关键路径需要写后读一致性,请为这些读操作使用单独的禁用缓存 Hyperdrive 配置。请参阅查询缓存指南。

PlanetScale 开发者体验

Postgres 或 MySQL

选择 PlanetScale Postgres 或 MySQL,继续使用熟悉的数据库驱动、对象关系映射(ORM)库和 SQL 工具。

性能与可靠性

在 PlanetScale 基础设施上运行生产数据库,其性能与可靠性承诺支撑了可信的客户工作负载 ↗。

现代开发工作流

使用开发分支 ↗测试数据库变更,查询洞察 ↗了解查询性能,以及 Model Context Protocol (MCP) 服务器 ↗让 Agent 访问数据库洞察数据,无需数据库管理员(DBA)。

Cloudflare 计费

从 Cloudflare 仪表板创建 PlanetScale 数据库时,通过 Cloudflare 账户计费——Cloudflare 发票上会显示 PlanetScale 使用量的明细。通过 Cloudflare 创建和使用数据库的 PlanetScale 定价与直接向 PlanetScale 购买相同。更多定价细节请参阅 PlanetScale 定价 ↗。可通过 PlanetScale 仪表板 ↗查看各数据库的计费用量。

常见问题

如何获得 PlanetScale 数据库支持?

通过 Cloudflare 创建的 PlanetScale 数据库支持由 PlanetScale 在其 Standard 级别支持或你购买的 PlanetScale 支持计划下提供。如需 PlanetScale 数据库帮助,请参阅 PlanetScale Support ↗,或通过 PlanetScale 支持门户 ↗ 直接联系 PlanetScale 支持团队。

PlanetScale 数据库如何计费?

对于按量付费 Cloudflare 账户,PlanetScale 数据库从创建到删除期间按日计费。无论是否执行查询或存储数据,数据库都会产生费用。

连接 MySQL

将 Hyperdrive 连接到 PlanetScale MySQL 数据库。

快速入门

创建 Hyperdrive 配置并从 Workers 查询数据库。

这篇文档对您有帮助吗?