ระดับ 4c · บทที่ 3/5

KV และ R2 — ค่าที่อ่านบ่อย กับไฟล์ขนาดใหญ่ที่ไม่มีค่า egress

⏱ 55 นาทีลองในCloudflare ↗

เป้าหมาย

เลือกได้ว่าข้อมูลไหนควรอยู่ KV ไหนควรอยู่ R2 (และไหนควรไป D1 ในบทถัดไป) สร้าง namespace/bucket ด้วย wrangler ผูก binding เขียน Worker ที่อ่าน-เขียนทั้งสองอย่าง และเข้าใจผลของ eventual consistency

เลือกที่เก็บ

KV R2 D1 (บท 04)
รูปแบบ key → value (สูงสุด 25 MiB) object storage (S3-compatible) SQL (SQLite)
เด่น อ่านเร็วมากทั่วโลก (cache ที่ edge) ไฟล์ใหญ่, ไม่มีค่า egress query, join, transaction
ความสอดคล้อง eventual — เขียนแล้วที่อื่นอาจยังเห็นค่าเก่าสักพัก strong (อ่านหลังเขียนเห็นทันที) strong ใน DB หลัก
เขียน ช้า/จำกัด: 1 ครั้ง/วินาทีต่อ key ได้เยอะ ได้เยอะ (ทีละ DB)
เหมาะกับ config, feature flag, redirect map, cache ผล API, session ที่อ่านเยอะ รูป, วิดีโอ, backup, ไฟล์ผู้ใช้อัปโหลด, ไฟล์ export ข้อมูลที่มีความสัมพันธ์, ตัวนับ, รายการคำสั่งซื้อ
ไม่เหมาะ ตัวนับ, ข้อมูลที่ต้องอ่านหลังเขียนทันที ค้นหาตามเงื่อนไข ไฟล์ใหญ่

ตัวนับยอดวิว/สต็อกสินค้าห้ามใช้ KV — เขียนชนกันหาย + เกิน 1 write/s/key → ใช้ D1 หรือ Durable Objects (ระดับ 5c)

ตัวเลขที่ต้องรู้

KV Free
อ่าน 100,000 / วัน
เขียน (คนละ key) 1,000 / วัน
เขียน key เดิม 1 / วินาที (ทุกแพลน)
cacheTtl ขั้นต่ำ 30 วินาที
R2 (Standard) ฟรีต่อเดือน เกินแล้ว
storage 10 GB-เดือน $0.015 / GB-เดือน
Class A (เขียน, list) 1 ล้านครั้ง คิดตามจำนวน
Class B (อ่าน) 10 ล้านครั้ง คิดตามจำนวน
egress (ดาวน์โหลดออก) ฟรีเสมอ ฟรี
เทียบ S3: ค่าโอนข้อมูลออกอินเทอร์เน็ตมักเป็นก้อนใหญ่สุดของบิลไฟล์สื่อ — R2 ไม่มีส่วนนี้ (free tier ใช้กับ Standard เท่านั้น ไม่ใช่ Infrequent Access)

API ที่ใช้บ่อย

// KV
await env.LINKS.get(key);                         // string | null
await env.LINKS.get(key, { type: "json", cacheTtl: 300 });
await env.LINKS.put(key, value, { expirationTtl: 3600, metadata: { by: "admin" } });
await env.LINKS.list({ prefix: "promo-" });       // { keys, list_complete, cursor }
await env.LINKS.delete(key);

// R2
await env.FILES.put(key, request.body, { httpMetadata: { contentType: "image/png" } });
const obj = await env.FILES.get(key);             // R2ObjectBody | null
await env.FILES.head(key);                        // metadata อย่างเดียว ไม่ดึง body
await env.FILES.list({ prefix: "uploads/", limit: 100 });
await env.FILES.delete(key);

ลองเลย 🧪

⚠️ R2 ต้องเปิดใช้ในแดชบอร์ดก่อน (มักต้องผูกวิธีชำระเงินแม้ใช้ไม่เกินโควตาฟรี) — ใช้แค่ไฟล์ทดสอบเล็กๆ และลบทิ้งตอนจบจะไม่มีค่าใช้จ่าย

ทดลอง A — สร้างโปรเจกต์ + KV + R2

cd ~/cloud-ladder
npm create cloudflare@latest -- edge-store --type=hello-world --lang=ts --no-deploy --git
cd edge-store
npx wrangler kv namespace create LINKS
npx wrangler r2 bucket create edge-store-files-[ชื่อเล่นคุณ]

ผลที่ควรเห็น (ย่อ):

✨ Success!
... add the following to your configuration file ...
  "kv_namespaces": [ { "binding": "LINKS", "id": "f0e1d2c3b4a5..." } ]
✅ Created bucket 'edge-store-files-ton' with default storage class of Standard.

wrangler.jsonc (วาง id ที่ได้จริง)

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "edge-store",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-01",
  "observability": { "enabled": true },
  "kv_namespaces": [{ "binding": "LINKS", "id": "[KV_NAMESPACE_ID]" }],
  "r2_buckets": [{ "binding": "FILES", "bucket_name": "edge-store-files-[ชื่อเล่นคุณ]" }]
}
echo 'ADMIN_TOKEN="local-dev-only-token"' > .dev.vars
grep -q '^.dev.vars' .gitignore || echo '.dev.vars*' >> .gitignore
npx wrangler types

ทดลอง B — ลิงก์ย่อ (KV) + อัปโหลดไฟล์ (R2) แทนที่ src/index.ts

const json = (data: unknown, status = 200) => Response.json(data, { status });

function isAdmin(request: Request, env: Env): boolean {
  const a = new TextEncoder().encode(request.headers.get("authorization") ?? "");
  const b = new TextEncoder().encode(`Bearer ${env.ADMIN_TOKEN}`);
  if (!env.ADMIN_TOKEN) return false;   // ยังไม่ได้ตั้ง secret → ปฏิเสธเสมอ
  return a.byteLength === b.byteLength && crypto.subtle.timingSafeEqual(a, b);
}

export default {
  async fetch(request, env): Promise<Response> {
    const url = new URL(request.url);
    const [, area = "", ...rest] = url.pathname.split("/");
    const key = decodeURIComponent(rest.join("/"));
    const write = ["PUT", "DELETE"].includes(request.method);
    if (write && !isAdmin(request, env)) return json({ error: "unauthorized" }, 401);

    // ---------- /s/<slug> : ลิงก์ย่อใน KV ----------
    if (area === "s" && key) {
      if (request.method === "PUT") {
        const target = (await request.text()).trim();
        if (!/^https:\/\//.test(target)) return json({ error: "target ต้องขึ้นต้นด้วย https://" }, 400);
        await env.LINKS.put(key, target, { metadata: { createdAt: new Date().toISOString() } });
        return json({ slug: key, target }, 201);
      }
      if (request.method === "DELETE") {
        await env.LINKS.delete(key);
        return json({ deleted: key });
      }
      const target = await env.LINKS.get(key, { cacheTtl: 60 });
      return target ? Response.redirect(target, 302) : json({ error: "ไม่พบลิงก์" }, 404);
    }

    // ---------- /files/<key> : ไฟล์ใน R2 ----------
    if (area === "files") {
      if (!key && request.method === "GET") {
        const listed = await env.FILES.list({ limit: 50 });
        return json(listed.objects.map((o) => ({ key: o.key, size: o.size, uploaded: o.uploaded })));
      }
      if (request.method === "PUT") {
        const obj = await env.FILES.put(key, request.body, {
          httpMetadata: { contentType: request.headers.get("content-type") ?? "application/octet-stream" },
        });
        return json({ key: obj?.key, size: obj?.size, etag: obj?.etag }, 201);
      }
      if (request.method === "DELETE") {
        await env.FILES.delete(key);
        return json({ deleted: key });
      }
      const obj = await env.FILES.get(key);
      if (!obj) return json({ error: "ไม่พบไฟล์" }, 404);
      const headers = new Headers();
      obj.writeHttpMetadata(headers);
      headers.set("etag", obj.httpEtag);
      headers.set("cache-control", "public, max-age=300");
      return new Response(obj.body, { headers });
    }

    return json({ error: "not found" }, 404);
  },
} satisfies ExportedHandler<Env>;
npx tsc --noEmit && npx wrangler dev

อีก terminal (ข้อมูลตอน dev อยู่ในเครื่อง ไม่แตะของจริง)

T="Authorization: Bearer local-dev-only-token"
curl -s -X PUT -H "$T" --data "https://developers.cloudflare.com/kv/" http://localhost:8787/s/kv-docs
curl -sI http://localhost:8787/s/kv-docs | grep -iE "^HTTP|^location"
echo "สวัสดี R2" > hello.txt
curl -s -X PUT -H "$T" -H "Content-Type: text/plain; charset=utf-8" --data-binary @hello.txt http://localhost:8787/files/notes/hello.txt
curl -s http://localhost:8787/files/notes/hello.txt
curl -s http://localhost:8787/files/
curl -s -o /dev/null -w "%{http_code}\n" -X PUT --data "x" http://localhost:8787/files/hack.txt

ผลที่ควรเห็น:

{"slug":"kv-docs","target":"https://developers.cloudflare.com/kv/"}
HTTP/1.1 302 Found
Location: https://developers.cloudflare.com/kv/
{"key":"notes/hello.txt","size":22,"etag":"..."}
สวัสดี R2
[{"key":"notes/hello.txt","size":22,"uploaded":"2026-10-09T..."}]
401

ทดลอง C — ขึ้นของจริง แล้วสังเกต eventual consistency

npx wrangler deploy
openssl rand -hex 24 | tee /dev/tty | npx wrangler secret put ADMIN_TOKEN   # จดค่าที่แสดงไว้ใช้ทดสอบ แล้ว clear terminal
npx wrangler kv key put --binding LINKS promo "https://example.com/promo" --remote
npx wrangler kv key get --binding LINKS promo --remote
npx wrangler r2 object put "edge-store-files-[ชื่อเล่นคุณ]/notes/hello.txt" --file hello.txt --content-type "text/plain; charset=utf-8" --remote
curl -sI "https://edge-store.[your-subdomain].workers.dev/s/promo" | grep -i "^location"

ผลที่ควรเห็น: https://example.com/promo จาก kv key get และ header location: https://example.com/promo — ถ้าแก้ค่า promo แล้วเรียกทันที บาง request อาจยังได้ค่าเก่า (เพราะ cacheTtl 60 วินาที + การกระจายค่าทั่วโลกต้องใช้เวลา) นี่คือ eventual consistency

เก็บกวาด

npx wrangler r2 object delete "edge-store-files-[ชื่อเล่นคุณ]/notes/hello.txt" --remote
npx wrangler delete
npx wrangler r2 bucket delete edge-store-files-[ชื่อเล่นคุณ]
npx wrangler kv namespace list | grep -B1 -A1 LINKS          # ดู id
npx wrangler kv namespace delete --namespace-id [KV_NAMESPACE_ID]
rm hello.txt

(bucket ต้องว่างก่อนถึงลบได้ — ถ้าอัปโหลดผ่าน API ไว้หลายไฟล์ ให้ลบทุก object ก่อน)

กับดักที่เจอบ่อย

อาการ สาเหตุ / แก้
แก้ค่าใน KV แล้วบางคนยังเห็นค่าเก่า eventual consistency + cacheTtl → อย่าใช้ KV กับข้อมูลที่ต้องเห็นทันที
429 / ค่าตัวนับหาย เขียน key เดียวกันถี่เกิน 1 ครั้ง/วินาที → D1 หรือ Durable Objects
wrangler kv key put แล้ว Worker บน production ไม่เห็น ลืม --remote → ค่าไปอยู่ใน storage จำลองในเครื่อง
อัปโหลด R2 จาก stream แล้ว error เรื่องความยาว body ไม่มี Content-Length → ส่งแบบรู้ขนาด (--data-binary) หรืออ่านเป็น ArrayBuffer ก่อน
ใครก็อัปโหลด/ลบไฟล์ได้ endpoint เขียนไม่มี auth → ตรวจ token ทุก method ที่ไม่ใช่ GET
ลบ bucket ไม่ได้ ยังมี object ค้าง → ลบให้หมดก่อน
เปิด r2.dev URL ทิ้งไว้ public ทั้ง bucket และไม่มี WAF/cache ของโซน → ถ้าจะ public ใช้ custom domain หรือเสิร์ฟผ่าน Worker

สรุปจำง่าย

KV = อ่านเยอะ เขียนน้อย ยอมช้าได้สักพัก — R2 = ไฟล์ ไม่มีค่า egress — ตัวนับ/ข้อมูลสัมพันธ์ไป D1 — คำสั่ง wrangler กับข้อมูลจริงใส่ --remote เสมอ — endpoint เขียนต้องมี auth