Deno KV 发布公告

我们很高兴地推出 Deno KV，这是一个强一致性的键值数据库，在全球 35 个区域进行全局复制，以实现低延迟读取。

Deno Deploy 旨在提供最简单、最快速的方式来在边缘部署和运行 JavaScript、TypeScript 和 Wasm。然而，先前在 Deno Deploy 上创建有状态的应用程序需要连接到外部云数据库，这涉及到额外的配置步骤、本地测试挑战，并且如果数据存储不是地理复制的，可能会损害使用边缘计算的优势。

通过今天的公告，我们正在为 Deno 带来一个全局集成的数据库，使您能够轻松开发功能齐全的应用程序，同时克服这些障碍。

在这篇文章中，我们将讨论 Deno KV 的关键方面

• 本地运行或托管
• 简单而强大
• 原子事务
• 一致性和性能
• 用例和示例
• 下一步是什么

如果您有兴趣使用 Deno KV，请加入候补名单。

注意：Deno KV 目前处于 beta 测试阶段，长期数据持久性无法保证。在生产应用程序中使用 Deno KV 时，请记住这一点。

注意：Deno KV 目前处于公开 beta 测试阶段。

本地运行或托管

Deno KV 无缝集成到开源 Deno 运行时中，允许您在本地运行它，或者作为零配置的托管服务部署它。

在本地运行时，Deno KV 由 SQLite 支持，为本地开发、测试或单区域生产系统提供轻量级且易于使用的解决方案。

当您将应用程序部署到 Deno Deploy 时，Deno KV 数据库会自动由 FoundationDB 支持。此托管解决方案由 Deno 公司运营，确保高性能和可靠性，而无需您进行手动配置或维护。

简单而强大

Deno KV 是一流的原语，仅公开少量方法，您可以使用这些方法来存储、检索、删除和枚举数据。Deno KV 专为 JavaScript 设计，可以存储任何 JavaScript 结构化可序列化值，例如对象、数组、BigInts、日期等等。

const kv = await Deno.openKv();

const key = ["users", crypto.randomUUID()];
const value = { name: "Alice", created: new Date() };
await kv.set(key, value);

const result = await kv.get(key);
console.log(result.value);
// { name: "Alice", created: 2023-05-01T09:24:07.620Z }

使用 kv.list() 操作列出与特定选择器匹配的所有键。在下面的示例中，选择了所有以特定前缀开头的键。

await kv.set(["users", "alice"], { birthday: "January 1, 1990" });
await kv.set(["users", "sam"], { birthday: "February 14, 1985" });
await kv.set(["users", "taylor"], { birthday: "December 25, 1970" });

// List out all entries with keys starting with `["users"]`
const iter = kv.list({ prefix: ["users"] });
for await (const entry of iter) {
  console.log(entry.key);
  console.log(entry.value);
}

list 操作从存储中批量检索数据，默认为 500 个键。要实现分页，请将 iter.cursor 属性传递回后续的 kv.list() 调用中。

在文档中了解有关可用方法的更多信息.

原子事务

对于许多应用程序来说，可靠的数据库事务是必要的。这在 Deno KV 中是可行的，可以使用 kv.atomic() 创建事务，这些事务在多个键上具有强一致性，并且默认情况下立即持久化

const kv = await Deno.openKv();
const change = 10;

const bob = await kv.get(["balance", "bob"]);
const liz = await kv.get(["balance", "liz"]);
if (bob.value < change) {
  throw "not enough balance";
}

const success = await kv.atomic()
  .check(bob, liz) // balances did not change
  .set(["balance", "bob"], bob.value - change)
  .set(["balance", "liz"], liz.value + change)
  .commit();

了解有关我们如何处理事务的更多信息。

一致性和性能

Deno KV 是一个强一致性数据库，提供外部一致性，其中包括

• 可串行化：事务的最高隔离级别，确保并发事务执行结果与这些事务的顺序执行等效。
• 线性一致性：保证操作（如读取和写入）看起来是瞬时的，并且实时发生。一旦写入操作完成，所有后续的读取操作都会返回更新后的值，从而确保强大的实时排序。

您可以使用 consistency: "eventual" 选项为单独的读取操作放宽一致性约束

// Read with eventual consistency from the nearest region
await db.get(["my-key"], { consistency: "eventual" });

// Read with strong consistency from the primary region
await db.get(["my-key"], { consistency: "strong" });

此选项允许系统从全局副本和缓存中提供读取服务，以实现最小的延迟。

以下是我们在最受欢迎的区域中 beta 测试版的平均延迟数据。预计在公开 beta 测试版和 GA 版本中会有改进。

用例和示例

Deno KV 是管理应用程序状态的多功能解决方案，使其成为各种用例的理想选择。以下是一些展示 Deno KV 潜力的应用程序示例

• 实时协作：Deno KV 可以跨多个客户端存储和同步数据，从而实现文档编辑或多人游戏等任务的无缝协作。通常在实时应用程序中，Deno 的 BroadcastChannel 用于帮助同步状态。
• 用户数据管理：使用 Deno KV 存储和管理用户生成的内容，例如博客文章和评论。通过使用全局复制的数据库，您可以确保快速访问，无论用户身在何处。
• 身份验证：Deno KV 可以存储用户凭据、角色和权限，从而为您的应用程序实现安全高效的身份验证。

作为一个基本示例，请浏览这个 playground，了解使用 Deno KV 创建全局一致的持久计数器是多么简单

import { serve } from "/std@0.155.0/http/server.ts";

const db = await Deno.openKv();

serve(async (req: Request) => {
  await db.atomic().sum(["views"], 1n).commit();
  const res = await db.get(["views"]);
  const views = res.value.value;
  return new Response(`Views: ${views}`);
});

以下是我们构建的一些更高级的演示应用程序，以说明 Deno KV 的功能

• 多人井字棋 (源代码, 演示)：一个简单的在线多人游戏。
• Pixel-page (源代码, 演示)：一个协作绘图应用程序，演示了实时同步和用户数据管理。
• 共享待办事项列表 (源代码, 演示)：一个任务管理应用程序，说明了 Deno KV 存储和管理用户生成数据的能力。
• KV sketchbook (源代码, 演示)：一个基于 Web 的 sketchbook，突出了 Deno KV 存储和检索用户创建的草图的能力，展示了用户数据管理。

这些示例让您了解了使用 Deno KV 可以实现的功能。凭借其简洁性、可扩展性和全局复制，Deno KV 是开发人员轻松构建有状态应用程序的强大工具。

下一步是什么

我们的使命是使 Deno Deploy 成为部署和运行 API 服务器、Web 应用程序和边缘函数的首选平台。提供全局复制的持久数据存储是朝着该目标迈出的重要一步。在未来几个月，我们将推出更多功能，以进一步简化构建和部署应用程序的过程，只需几行代码即可完成。

在 beta 测试期间，用户可以免费享受高达 1GB 的存储空间。我们将尽快公布定价详情。

其他资源

• Deno 手册中关于 KV 的条目
• Deploy KV 文档
• API 参考
• Dahl 在 NodeCongress 上的演讲

如果您有兴趣使用 Deno KV，请加入候补名单。

不要错过任何更新 — 在 Twitter 上关注我们。