Workers KV

Workers KV 是一個「鍵值（key-value）」資料庫（鍵值指的是把資料存成「名稱 → 值」的配對，再用名稱來查回它）。它是為「讀取」而生的：一旦資料被快取到使用者附近，再讀取就快得驚人。

這裡沒有資料表、也沒有 SQL。你只要用 put('user:42', '...') 來存、用 get('user:42') 來讀。值會被複製到 Cloudflare 的全球網路上，讓讀取永遠靠近你的使用者。

當你要一遍又一遍讀取同一小塊資料——一個設定開關、一份快取的 API 回應、一段登入工作階段——用完整的 SQL 資料庫太大材小用了。KV 讓這些讀取幾乎瞬間完成，而且全球都能取得。

建立一個「命名空間（namespace，指一桶獨立的鍵值配對）」，把它綁到 Worker，接著就能寫入和讀取值。

1. 建立命名空間

   Wrangler 會印出一組 id——複製起來給綁定用。

   bashcontent_copy複製

   npx wrangler kv namespace create MY_KV

2. 綁定到 Worker

   把這段加進 wrangler.jsonc，讓這個資料庫能用 env.MY_KV 取用。

   jsoncontent_copy複製

   {
     "kv_namespaces": [
       {
         "binding": "MY_KV",
         "id": "<paste-your-id-here>"
       }
     ]
   }

3. 在程式碼裡寫入與讀取

   put 存入一個值；get 把它讀回來。expirationTtl 選項會在指定秒數後自動刪掉這個 key。

   jscontent_copy複製

   export default {
     async fetch(request, env) {
       await env.MY_KV.put("greeting", "Hello!", {
         expirationTtl: 3600,
       });
   
       const value = await env.MY_KV.get("greeting");
       return new Response(value ?? "not found");
     },
   };

4. 用 CLI 先塞一筆值

   你也可以直接從終端機寫入 key。

   bashcontent_copy複製

   npx wrangler kv key put --binding MY_KV "greeting" "Hello!" --remote

5. 部署上線

   發布 Worker，全球同步上線。

   bashcontent_copy複製

   npx wrangler deploy

• 免費額度：每天 10 萬次讀取、1,000 次寫入、1,000 次刪除、1,000 次列出操作，外加 1 GB 儲存。
• key 最多 512 位元組；value 最多 25 MiB；每個帳號最多 1,000 個命名空間。
• 用 session: 或 cache: 這類清楚的 key 前綴，把 key 分類整理好。
• 讀取比寫入便宜——多靠快取，並讓 TTL 自動清掉過期資料。