跳至主要内容

在 Node.js 中使用 KV

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

安装和使用

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

npm install @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

您项目的database-id可以在Deno Deploy 仪表板中找到,位于项目的“KV”选项卡下。

Connection string locations in Deploy

更多信息

有关如何在 Node 中使用 Deno KV 模块的更多信息,请访问该项目的README 页面