跳至主要内容

常见问题

何时应为 Prisma Accelerate 启用静态 IP？​

当你的安全设置需要 IP 白名单或你正在实施仅允许受信任 IP 访问的防火墙时，请为 Accelerate 启用静态 IP，以确保受控且安全的数据库连接。

Result of enabling static IP Accelerate with a database using IP allowlisting

了解更多关于如何在 Platform Console 中为 Accelerate 启用静态 IP。

信息

什么是静态 IP？

静态 IP 地址是固定的 IPv4 或 IPv6 地址。与可能无法预测地更改的动态 IP 地址不同，来自静态 IP 地址的流量可以轻松识别。

What is a static IP

ℹ️ 要在你现有或新的项目环境中为 Accelerate 启用静态 IP 支持，你的工作空间需要升级到我们的 Pro 或 Business 计划。请查看定价页面了解更多信息。

为什么有时会看到意外的缓存行为？​

当 Accelerate 观察到来自项目的较高负载时，其缓存性能最佳。许多缓存操作，例如向缓存提交数据和刷新过期数据，都是异步发生的。在对 Accelerate 进行基准测试时，我们建议使用循环或负载测试方法进行。这将更好地模拟高负载场景，并减少低频率操作带来的异常值。

Prisma 操作通过 HTTP 发送到 Accelerate。因此，对 Accelerate 的第一个请求必须建立 HTTP 握手，并可能因此产生额外的延迟。我们正在探索未来减少这种初始请求延迟的方法。

Accelerate 的定价是多少？​

你可以在我们的Accelerate 定价页面找到更多详情。

VS Code 无法识别 $extends 方法​

如果你将 Prisma Client 扩展程序添加到当前在 VS Code 中打开的现有项目中，编辑器可能无法立即识别 $extends 方法。

这可能是由于 TypeScript 服务器尚未识别重新生成的 Prisma Client 导致的问题。要解决此问题，你需要重新启动 TypeScript。

  1. 在 VS Code 中，打开命令面板。你可以按 F1 或选择 视图 > 命令面板 来实现。
  2. 输入 typescript 并选择并运行 TypeScript: Restart TS server 命令。

VS Code 现在应该可以识别 $extends 方法了。

Accelerate 的缓存节点可在哪些区域使用？​

Accelerate 运行在 Cloudflare 的网络上，缓存命中来自 Cloudflare 的 300+ 个位置。你可以在这里找到 Accelerate 缓存节点可用的区域：https://www.cloudflare.com/network/。

Accelerate 的连接池可在哪些区域使用？​

未指定缓存策略或发生缓存未命中时，Prisma Client 查询将通过 Accelerate 的连接池路由。目前，查询可以通过 16 个可用区域中的任意一个所选区域路由。

目前，可用区域列表如下：

  • 亚太地区，孟买（ap-south-1）
  • 亚太地区，首尔（ap-northeast-2）
  • 亚太地区，新加坡（ap-southeast-1）
  • 亚太地区，悉尼（ap-southeast-2）
  • 亚太地区，东京（ap-northeast-1）
  • 加拿大，中部（ca-central-1）
  • 欧洲，法兰克福（eu-central-1）
  • 欧洲，爱尔兰（eu-west-1）
  • 欧洲，伦敦（eu-west-2）
  • 欧洲，巴黎（eu-west-3）
  • 欧洲，斯德哥尔摩（eu-north-1）
  • 南美洲，圣保罗（sa-east-1）
  • 美国东部，北弗吉尼亚（us-east-1）
  • 美国东部，俄亥俄（us-east-2）
  • 美国西部，北加州（us-west-1）
  • 美国西部，俄勒冈（us-west-2）

你还可以在设置 Accelerate 时查看可用区域，或者访问 Prisma Cloud Platform 仪表盘 中 Accelerate 下的设置选项卡中的区域部分。

Accelerate 如何知道要从哪个区域获取缓存？​

在底层，Accelerate 使用 Cloudflare，它使用任播（Anycast）进行网络寻址和路由。传入的请求将被路由到其网络中离用户最近且有能力高效处理请求的数据中心或“节点”。要了解其工作原理，我们建议查阅任播。

如何使 Accelerate 上的缓存失效？​

如果你使用的是付费计划，可以通过 $accelerate.invalidate API 按需使缓存失效，或者可以在项目级别使整个缓存失效，每天最多五次。此限制取决于你的计划。你可以在 Accelerate 配置页面管理此操作。

Accelerate 的一致性模型是什么？​

Accelerate 没有一致性模型。它不是一个分布式系统，不需要节点达成共识（因为数据仅存储在离用户最近的缓存节点中）。然而，Accelerate 缓存节点中缓存的数据不会传播到其他节点，因此 Accelerate 在设计上不需要一致性模型。

Accelerate 实现了读穿式缓存策略，特别适用于读密集型工作负载。

缓存提供的数据的新鲜度取决于你在查询中定义的缓存策略。有关选择适合你查询的缓存策略的更多信息，请参阅此部分。

Accelerate 与其他缓存工具（如 Redis）有何不同？​

  • Accelerate 是一种专门的缓存，允许你通过缓存策略在代码的查询级别优化数据访问。另一方面，Redis 和 Memcached 等工具是通用缓存，旨在具有适应性和灵活性。
  • Accelerate 是一种托管服务，可减少构建和维护缓存服务的时间、风险和工程工作。
  • 默认情况下，Accelerate 是全球分布的，从而降低了查询的延迟。其他缓存工具需要额外的配置才能在全球范围内可用。

何时不应使用 Accelerate 的缓存功能？​

Accelerate 是一个全局数据缓存和连接池，允许你在代码的查询级别优化数据访问。虽然使用 Accelerate 进行缓存可以极大地提升应用程序的性能，但它并非始终是你的用例的最佳选择。

如果你的应用程序属于以下情况，Accelerate 的全局缓存功能可能不适合：

  • 你的应用程序仅在特定区域内使用，并且你的应用程序服务器和数据库都位于同一区域的同一网络中。例如，如果你的应用程序服务器和数据库在同一区域和网络中，数据库查询可能会快得多。但是，如果你的应用程序服务器与数据库位于不同的区域或网络中，Accelerate 会加快你的查询速度，因为数据将缓存在最接近你的应用程序的数据中心。

  • 你仅需要通用缓存。Accelerate 是一个连接池和一个专门的缓存，它仅缓存代码中的数据库查询响应。通用缓存（如 Redis）允许你缓存来自多个源的数据，例如外部 API，而 Accelerate 目前不支持此功能。如果你对通用缓存感兴趣，请通过我们的 Discord 社区向我们提供反馈。

  • 你的应用程序数据在检索时始终需要是最新的，这使得难以建立合理的缓存策略。

即使不使用 Accelerate 的全局缓存，你仍然可以极大地受益于其连接池，尤其是在无服务器或边缘函数中，在这些环境中很难管理和扩展数据库连接。你可以在此处了解有关无服务器挑战的更多信息。

我可以将 Accelerate 与其他 ORM/查询构建器/驱动程序一起使用吗？​

不可以。我们目前没有支持其他 ORM/查询构建器或驱动程序的计划。但是，如果你对支持其他库感兴趣，请随时联系我们并在我们的 Discord 社区的 #help-and-questions 频道中告知我们。

配置 cacheStrategy 时，ttl 参数的最大允许值是多少？​

生存时间（Time-to-live） (ttl) 参数最多可以设置为一年。但是，需要注意的是，如果缓存中的条目不经常访问，它们可能会被逐出。

根据我们的实验，我们看到缓存条目会持续约 18 小时。虽然条目如果活跃访问可能会在缓存中保留更长时间，但不能保证。

注意：即使是经常访问的条目，也可能会偶尔从缓存中被逐出。无论其活动水平如何，条目都不太可能存活一个月或更长时间。

为什么 Accelerate 在服务中断期间不会回退到直接连接字符串？​

在极少数情况下，如果发生服务中断，回退到直接连接将绕过连接池。这可能会耗尽数据库的可用连接，并在数据库级别导致其他问题。

如果发生服务中断，建议在状态页面上验证。你可以联系 Prisma 的支持渠道寻求帮助。

注意：此外，值得注意的是，某些边缘函数运行时环境可能不支持与 Prisma ORM 的直接连接。有关详细信息，请参阅我们的边缘函数文档。

交互式事务中的每个查询是否单独计费？​

是的，交互式事务根据事务中的单个操作计费。事务本身的开始、提交或回滚不收费。例如，在以下查询中，有两个可计费查询：

await prisma.$transaction(async (tx) => {
  await tx.user.deleteMany({ where: { name: 'John Doe' } });
  await tx.user.createMany({ data });
});

然而，使用用于顺序客户端操作的 $transaction API 时，无论数组中有多少查询，它都只算作一个可计费查询。例如：

await prisma.$transaction([
  prisma.user.deleteMany({ where: { name: 'John Doe' } }),
  prisma.user.createMany({ data }),
]);

如果你不需要交互式事务，可以通过使用顺序操作事务来节省成本并提高性能。顺序操作事务在 Accelerate 上表现更好，因为它们在一次到数据库的往返中执行，而交互式事务需要为开始、提交和事务上的每个单独操作进行单独的往返。

我可以增加 Accelerate 查询时长和响应大小限制吗？​

是的，你可以根据你的订阅计划增加 Accelerate 限制。以下是可配置的限制：

限制StarterPro 计划Business 计划
查询超时最多 10 秒最多 20 秒最多 60 秒
交互式事务超时最多 15 秒最多 30 秒最多 90 秒
响应大小最多 5 MB最多 10 MB最多 20 MB

查看定价页面了解更多关于可用计划及其相应限制的详细信息。

警告

虽然你可以根据订阅计划增加这些限制，但仍建议优化你的数据库操作。在我们的故障排除指南中了解更多信息。

使缓存查询结果失效需要多长时间？​

由于缓存需要在全球范围内清除，因此难以提供具体的时间范围。然而，缓存数据最终是一致的，通常在几秒钟内传播到所有 PoP。在极少数情况下，可能需要更长时间。

这里有一个演示应用程序，用于测试缓存查询结果失效所需的时间。

Invalidate（失效）和 Revalidate（重新验证）有什么区别？​

Invalidate（失效）：缓存条目被删除，下次请求时将获取新数据，导致缓存未命中。这会移除过期数据，但在缓存重新填充之前可能导致响应变慢。

Revalidate（重新验证）：缓存条目被主动更新，确保下次请求使用缓存中的新鲜数据。这使缓存保持有效，并通过避免缓存未命中维护更快的响应时间。

什么是按需缓存失效？​

按需缓存失效允许应用程序在特定缓存数据更改时立即更新，而不是等待常规缓存刷新周期。这使得信息保持准确并为用户提供最新数据。

何时应使用缓存失效 API？​

缓存失效 API 在数据一致性不能等待缓存标准过期或重新验证时至关重要。主要用例包括：

  • 内容更新：当发生关键更改（例如已发布的文章编辑、产品更新或配置文件修改）需要立即可见时。
  • 库存管理：在实时应用程序（如库存或预订系统）中，库存水平、可用性或预订状态必须反映最新信息。
  • 高优先级数据：对于时间敏感的数据，例如突发新闻或紧急通知，用户必须立即看到最新信息。

在这些场景中使用按需缓存失效有助于仅刷新必要的数据，在确保用户获得准确最新信息的同时保持系统性能。

Accelerate 如何计算计费查询？​

Accelerate 在 Prisma Client 调用级别计算查询。单个 Prisma 查询可能在底层转换为多个 SQL 语句，但出于计费目的，它仅算作一个查询。这确保了直接、可预测的计费，反映了 Prisma Client 的使用情况，而不是底层 SQL 操作的复杂性。

无论查询是从缓存还是从数据库提供，都会进行计数。即使从缓存中检索到查询，它仍然计入你的查询限制。

如何从 GitHub 登录切换到电子邮件和密码登录？​

如果你之前使用 GitHub 注册，并希望切换到电子邮件和密码登录，请按照以下步骤操作：

1. 验证你的 GitHub 电子邮件地址​

  • 检查与你的 GitHub 帐户关联的主要电子邮件地址（例如，从你的 GitHub 个人资料或通知设置中）。

2. 创建一个新的电子邮件/密码帐户​

  • 前往电子邮件/密码注册页面。
  • 使用与你的 GitHub 帐户关联的相同的电子邮件地址创建新帐户。
  • 我们的系统将自动将你的新电子邮件/密码帐户与你现有的数据关联起来。

3. 测试你的登录​

  • 退出并尝试使用你刚刚创建的电子邮件和密码登录。

注意：如果你遇到任何问题，请联系我们的支持团队以获取帐户关联方面的帮助。