~/VibeHandbook
PDF Gratis
≡
Baca BukunyaReferensiFilosofiUnduhTanya Jawab

Cloudflare

developers.cloudflare.com ↗

Workers KV

Apa itu ini

Bayangkan sebuah kamus raksasa: kamu mencari sebuah kata (key/kunci) dan langsung mendapatkan artinya (value/nilai). Workers KV adalah penyimpanan KV (key-value / kunci-nilai) global yang dibangun dengan cara seperti itu, dan dirancang untuk pembacaan (reads). Kamu menulis sebuah nilai satu kali, lalu Cloudflare menyalinnya ke seluruh jaringannya sehingga Worker mana pun, di mana pun, bisa membacanya dengan latensi yang sangat rendah (hampir tanpa menunggu). Sistem ini bersifat eventually consistent (konsisten pada akhirnya): setelah sebuah penulisan (write), nilai baru akan terlihat di mana-mana dalam jangka waktu singkat. Jeda singkat itu adalah trade-off (kompromi) demi kecepatan dan jangkauan global.

Kelebihan

  • Pembacaan yang sangat cepat dan berlatensi rendah dari mana saja di (jaringan tepi).
  • Direplikasi secara global secara otomatis — tidak ada region yang perlu dikelola.
  • (Application Programming Interface — sekumpulan kecil perintah yang kamu panggil) yang sederhana: get, put, delete, list, dengan TTL (Time To Live — berapa lama sebuah nilai disimpan sebelum kedaluwarsa secara otomatis) opsional.
  • Murah dalam skala besar untuk beban kerja yang didominasi pembacaan; ada tingkatan gratis yang bisa dipakai.
  • Terhubung langsung ke Workers dan Pages Functions.

Trade-off (kompromi)

  • Eventually consistent — bukan untuk data yang harus benar tepat setelah penulisan.
  • Penulisan (writes) lebih lambat dan dibatasi lajunya (rate-limited) dibandingkan pembacaan.
  • Ukuran nilai (value) dibatasi (sekitar 25 MB); ini bukan penyimpanan massal seperti R2.
  • Tidak ada query atau relasi — sifatnya murni kunci ke nilai.

Kapan menggunakannya

Gunakan KV untuk konfigurasi, feature flag (penanda fitur), respons API yang di-cache, tabel routing, pencarian sesi ( lookups), dan data apa pun yang sebagian besar hanya dibaca dan kamu bisa tolerir jika agak "basi" beberapa detik.

Kecocokan dengan vibe coding

KV adalah kemenangan mudah bagi sebuah yang menambahkan caching atau konfigurasi ke sebuah Worker: satu binding, lalu get/put. Tegaskan bahwa sistem ini eventually consistent, supaya agent tidak menggunakan KV di tempat yang butuh jaminan read-after-write (baca-setelah-tulis). Untuk kasus itu, arahkan ke D1 atau Durable Object. Cuplikan kode di bawah ini menghubungkan sebuah namespace dan mengisi sebuah nilai awal.

# wrangler.toml
[[kv_namespaces]]
binding = "CONFIG"
id = "your-kv-namespace-id"

npx wrangler kv namespace create CONFIG
npx wrangler kv key put --binding=CONFIG "theme" "dark"