D1 là gì? Database SQL nhẹ cho app nhỏ trên Workers What is D1? Lightweight SQL for small apps on Workers What is D1? Lightweight SQL for small apps on Workers

Khi nào app cần SQL thay vì chỉ KV hoặc R2? When does an app need SQL instead of only KV or R2? When does an app need SQL instead of only KV or R2?

Workers KV giống tủ khóa–giá trị: đọc nhanh theo key, không có JOIN hay query phức tạp. R2 lưu file (ảnh, PDF, backup). Nhưng nhiều tính năng cần bảng quan hệ: “mỗi user có nhiều đăng ký workshop”, “đếm số người theo sự kiện”, “lọc bình luận theo ngày”. Đó là lúc SQL hợp lý. Workers KV is like a key–value locker: fast reads by key, no JOINs or complex queries. R2 stores files (images, PDFs, backups). Many features need relational tables: “each user has many workshop signups,” “count attendees per event,” “filter comments by date.” That is when SQL makes sense. Workers KV is like a key–value locker: fast reads by key, no JOINs or complex queries. R2 stores files (images, PDFs, backups). Many features need relational tables: “each user has many workshop signups,” “count attendees per event,” “filter comments by date.” That is when SQL makes sense.

D1 là dịch vụ SQL của Cloudflare, dựa trên SQLite, gắn với Workers qua binding. Các bài trên blog.cloudflare.com về D1 thường nhấn mạnh: bạn viết SQL quen thuộc, chạy gần logic ứng dụng trên edge — không phải tự dựng cluster database chỉ để lưu vài nghìn dòng. D1 is Cloudflare’s SQL service, built on SQLite, bound to Workers. D1 posts on blog.cloudflare.com often stress: you write familiar SQL, run it near app logic at the edge — without building a database cluster for a few thousand rows. D1 is Cloudflare’s SQL service, built on SQLite, bound to Workers. D1 posts on blog.cloudflare.com often stress: you write familiar SQL, run it near app logic at the edge — without building a database cluster for a few thousand rows.

Ví dụ trên hub này: form đăng ký workshop ghi vào bảng `signups` với `event_id`, `email`, `created_at`. Admin xem danh sách theo sự kiện — một câu `SELECT` đơn giản. KV vẫn hữu ích cho feature flag hoặc cache, nhưng không thay thế query quan hệ. Example on this hub: a workshop signup form writes to a `signups` table with `event_id`, `email`, `created_at`. An admin lists rows per event — a simple `SELECT`. KV still helps for feature flags or cache, but it does not replace relational queries. Example on this hub: a workshop signup form writes to a `signups` table with `event_id`, `email`, `created_at`. An admin lists rows per event — a simple `SELECT`. KV still helps for feature flags or cache, but it does not replace relational queries.

D1 hoạt động cùng Workers như thế nào? How does D1 work alongside Workers? How does D1 work alongside Workers?

Bạn tạo database D1 trong dashboard hoặc bằng `wrangler d1 create`. Trong `wrangler.toml`, khai báo binding — ví dụ `DB` — rồi trong Worker gọi `env.DB.prepare("SELECT ...").bind(...).all()`. Request người dùng chạy code Worker; Worker đọc/ghi D1 trong cùng luồng xử lý. Create a D1 database in the dashboard or with `wrangler d1 create`. Declare a binding in `wrangler.toml` — e.g. `DB` — then in the Worker call `env.DB.prepare("SELECT ...").bind(...).all()`. User requests run Worker code; the Worker reads and writes D1 in the same request path. Create a D1 database in the dashboard or with `wrangler d1 create`. Declare a binding in `wrangler.toml` — e.g. `DB` — then in the Worker call `env.DB.prepare("SELECT ...").bind(...).all()`. User requests run Worker code; the Worker reads and writes D1 in the same request path.

Schema thay đổi qua migrations: file SQL trong thư mục `migrations/`, áp dụng local bằng `wrangler d1 migrations apply <name> --local` và production khi deploy. Điều này giống workflow Rails hoặc Django — chỉ nhẹ hơn vì database nhỏ và gắn edge. Schema changes go through migrations: SQL files under `migrations/`, applied locally with `wrangler d1 migrations apply <name> --local` and to production on deploy. This feels like Rails or Django workflows — lighter because the database is small and edge-attached. Schema changes go through migrations: SQL files under `migrations/`, applied locally with `wrangler d1 migrations apply <name> --local` and to production on deploy. This feels like Rails or Django workflows — lighter because the database is small and edge-attached.

Local dev: `wrangler dev` có thể dùng D1 local với dữ liệu giả. Trên hub, nếu `/api/workshop-events` trả `dbReady: false`, thường là chưa chạy migrations local — không phải lỗi “SQL khó”. Local dev: `wrangler dev` can use local D1 with sample data. On this hub, if `/api/workshop-events` returns `dbReady: false`, you often have not run local migrations — not “SQL is hard.” Local dev: `wrangler dev` can use local D1 with sample data. On this hub, if `/api/workshop-events` returns `dbReady: false`, you often have not run local migrations — not “SQL is hard.”

Ba pattern phổ biến cho app nhỏ Three common patterns for small apps Three common patterns for small apps

Một — đăng ký sự kiện hoặc waitlist: bảng `signups` với unique constraint trên email + event để tránh trùng. Hai — kết quả quiz hoặc khảo sát: lưu `answers` JSON hoặc cột chuẩn hóa, aggregate bằng SQL. Ba — metadata nội dung: bài blog draft, tag, trạng thái publish — khi bạn không muốn rebuild static site mỗi lần sửa một trường. One — event signup or waitlist: a `signups` table with a unique constraint on email + event to prevent duplicates. Two — quiz or survey results: store `answers` as JSON or normalized columns, aggregate with SQL. Three — content metadata: draft posts, tags, publish state — when you do not want to rebuild a static site for every field edit. One — event signup or waitlist: a `signups` table with a unique constraint on email + event to prevent duplicates. Two — quiz or survey results: store `answers` as JSON or normalized columns, aggregate with SQL. Three — content metadata: draft posts, tags, publish state — when you do not want to rebuild a static site for every field edit.

D1 không phải lựa chọn cho analytics hàng tỷ dòng hoặc workload ghi cực nặng đồng thời. Blog và docs Cloudflare thường gợi ý: bắt đầu D1 cho MVP, khi scale hoặc cần Postgres đầy đủ thì đồng bộ hoặc chuyển dần — nhưng nhiều side project không bao giờ cần bước đó. D1 is not for billion-row analytics or extreme concurrent write loads. Cloudflare blog and docs often suggest: start with D1 for an MVP, sync or migrate when you need full Postgres at scale — though many side projects never need that step. D1 is not for billion-row analytics or extreme concurrent write loads. Cloudflare blog and docs often suggest: start with D1 for an MVP, sync or migrate when you need full Postgres at scale — though many side projects never need that step.

Bắt đầu an toàn: migrations, backup và secrets Start safely: migrations, backups, and secrets Start safely: migrations, backups, and secrets

Luôn version schema bằng migrations — không sửa bảng production tay trong dashboard rồi quên. Test query trên dataset nhỏ local trước. Với email hoặc PII, cân nhắc mã hóa cột nhạy cảm và retention policy; D1 không tự thay bạn tuân thủ GDPR hay luật địa phương. Always version schema with migrations — do not hand-edit production tables in the dashboard and forget. Test queries on a small local dataset first. For email or PII, consider encrypting sensitive columns and retention policies; D1 does not automatically make you GDPR or local-law compliant. Always version schema with migrations — do not hand-edit production tables in the dashboard and forget. Test queries on a small local dataset first. For email or PII, consider encrypting sensitive columns and retention policies; D1 does not automatically make you GDPR or local-law compliant.

Đọc trang sản phẩm D1 và lộ trình Developer Platform trên hub, rồi mở bài gốc trên blog.cloudflare.com khi cần chi tiết replication hoặc pricing mới. Câu hỏi tự kiểm tra: “Query này có cần JOIN hoặc aggregate không?” Nếu có, D1 hoặc SQL bên ngoài hợp lý hơn KV. Read the D1 product page and Developer Platform track on this hub, then open original blog.cloudflare.com posts for replication or pricing updates. Self-check: “Does this query need JOINs or aggregates?” If yes, D1 or external SQL fits better than KV. Read the D1 product page and Developer Platform track on this hub, then open original blog.cloudflare.com posts for replication or pricing updates. Self-check: “Does this query need JOINs or aggregates?” If yes, D1 or external SQL fits better than KV.

Hình minh họa Cloudflare Cloudflare visuals Cloudflare visuals

Sơ đồ Reference Architecture chính thức và (khi có) ảnh Dashboard — giúp đối chiếu khi học. Official Reference Architecture diagrams and (when available) Dashboard screenshots — useful while you learn. Official Reference Architecture diagrams and (when available) Dashboard screenshots — useful while you learn.

Học tiếp trên hub (on-page backlinks) Keep learning on this hub (on-page links) Keep learning on this hub (on-page links)

• D1 là gì? (trang sản phẩm) What is D1? (product page) What is D1? (product page)
• Workers — nơi chạy logic SQL Workers — where SQL logic runs Workers — where SQL logic runs
• Lộ trình Developer Platform Developer Platform track Developer Platform track
• Use case: app serverless Use case: build a serverless app Use case: build a serverless app
• Roadmap Developer Developer roadmap Developer roadmap

Nguồn tham khảo (blog.cloudflare.com) Sources (blog.cloudflare.com) Sources (blog.cloudflare.com)

Nội dung được viết lại để dễ hiểu hơn; luôn đọc bài gốc trên blog.cloudflare.com và docs chính thức khi cần chi tiết kỹ thuật hoặc cập nhật mới nhất. Content is rewritten for clarity; always read the original posts on blog.cloudflare.com and official docs for technical detail or the latest updates. Content is rewritten for clarity; always read the original posts on blog.cloudflare.com and official docs for technical detail or the latest updates.

• The Cloudflare Blog — D1 topics ↗
• The Cloudflare Blog — Workers topics ↗