跳到主要内容
在本页

在 Node.js 中使用 KV

通过我们的 npm 上的官方客户端库 支持在 Node.js 中连接到 Deno KV 数据库。您可以在下面找到此选项的使用说明。

安装和使用 跳转到标题

使用您喜欢的 npm 客户端,使用以下命令之一为 Node.js 安装客户端库。

npm install @deno/kv
pnpm add @deno/kv
yarn add @deno/kv

将包添加到 Node 项目后,您可以导入 openKv 函数(支持 ESM import 和 CJS require 方式的使用)

import { openKv } from "@deno/kv";

// Connect to a KV instance
const kv = await openKv("<KV Connect URL>");

// Write some data
await kv.set(["users", "alice"], { name: "Alice" });

// Read it back
const result = await kv.get(["users", "alice"]);
console.log(result.value); // { name: "Alice" }

默认情况下,用于身份验证的访问令牌来自 DENO_KV_ACCESS_TOKEN 环境变量。您也可以显式传递它

import { openKv } from "@deno/kv";

const kv = await openKv("<KV Connect URL>", { accessToken: myToken });

Deno KV 客户端初始化后,Deno 中可用的相同 API 也可在 Node 中使用。

KV 连接 URL 跳转到标题

在 Deno 之外连接到 KV 数据库需要一个 KV 连接 URL。托管在 Deno Deploy 上的数据库的 KV 连接 URL 将采用以下格式:https://api.deno.com/databases/<database-id>/connect

您可以在 Deno Deploy 仪表板 上的项目“KV”选项卡中找到项目的 database-id

Connection string locations in Deploy

更多信息 跳转到标题

有关如何为 Node 使用 Deno KV 模块的更多信息,请参阅项目的 README 页面