跳至主要內容

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 用戶端後,也可以在 Node 中使用 Deno 中提供的相同 API。

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

更多資訊

更多關於如何使用 Deno KV 模組的資訊,請參閱專案的 README 頁面