D1 資料庫入門：用 AI 設計你的第一個資料表

English · 繁中 · Español · 日本語 · Português (BR)

作者： Danko Peng（@dankopeng）
更新： 2026 年 3 月
閱讀時間： 約 8 分鐘

---

你的 app 需要記住東西

用戶註冊了，你要記住他們的帳號。他們發了一篇文章，你要存起來。他們買了東西，你要記錄訂單。

資料庫就是你 app 的長期記憶。

Cloudflare D1 是 Cloudflare 提供的資料庫服務——技術上是 SQLite，但跑在 Cloudflare 的邊緣網路上，和你的 Workers 在同一個地方，讀寫速度極快。

---

資料表是什麼？

資料庫裡的資料用「表」（table）來組織，就像 Excel 試算表：

users 表：

id	email	name	created_at
1	danko@example.com	Danko	2026-03-01
2	user2@example.com	Alice	2026-03-02

每一欄是一個「欄位」（column），每一行是一筆「記錄」（row）。

---

用 AI 設計資料表

這是 Vibe Coding 最實用的場景之一。你不需要自己想 SQL 語法，直接告訴 AI：

「我需要一個儲存部落格文章的資料表，要有標題、內容、作者、發布狀態、建立時間。用 Cloudflare D1 的 SQLite 語法。」

AI 會生成類似這樣的 SQL：

CREATE TABLE posts (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  title TEXT NOT NULL,
  slug TEXT NOT NULL UNIQUE,
  content TEXT,
  author_id INTEGER NOT NULL,
  status TEXT NOT NULL DEFAULT 'draft',
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (author_id) REFERENCES users(id)
);

你不需要完全看懂每一行，但理解基本概念能讓你更好地判斷 AI 的輸出。

---

基本概念解釋

PRIMARY KEY：每筆記錄的唯一識別碼。就像每個人的身分證號碼，不會重複。

NOT NULL：這個欄位不能是空的。標題不能是空的，所以加 NOT NULL。

DEFAULT：沒有填值時的預設值。status 預設是 'draft'（草稿），created_at 預設是當前時間。

FOREIGN KEY：關聯到另一個表。author_id 關聯到 users 表的 id，表示「這篇文章是誰寫的」。

---

在 Cloudflare Workers 裡查詢 D1

建立資料表之後，在 Workers 裡這樣操作資料：

// 新增一筆商品
await env.DB.prepare(`
  INSERT INTO products (name, price, stock)
  VALUES (?, ?, ?)
`).bind(name, price, stock).run()

// 讀取所有上架商品
const products = await env.DB.prepare(`
  SELECT * FROM products
  WHERE stock > 0
  ORDER BY created_at DESC
  LIMIT 10
`).all()

你不需要自己寫這些——告訴 AI「幫我在 D1 查詢所有庫存大於零的商品，按建立時間倒序」，AI 會生成正確的 code。

---

用 AI 查詢資料的常見指令

幾個你可以直接告訴 AI 的需求：

查詢：

「從 posts 表讀取最新 10 筆已發布文章，包含作者名稱」

新增：

「在 orders 表新增一筆訂單記錄，欄位有 user_id、amount、status」

更新：

「把 post id = 5 的 status 改成 published」

刪除：

「刪除 user_id = 123 的所有草稿文章」

AI 生成的 SQL 記得用參數化查詢（? 佔位符），防止 SQL Injection——這在資安篇有說過。

---

SQL 速查表

不需要記住所有 SQL 語法，遇到不懂的貼給 AI 問。但這幾個模式你會一直用到：

查詢（SELECT）

-- 取得所有商品
SELECT * FROM products

-- 只取特定欄位
SELECT id, name, price FROM products

-- 加條件篩選
SELECT * FROM products WHERE stock > 0

-- 排序
SELECT * FROM products ORDER BY created_at DESC

-- 限制筆數
SELECT * FROM products LIMIT 10

-- 分頁
SELECT * FROM products LIMIT 10 OFFSET 20

-- 多個條件
SELECT * FROM products WHERE stock > 0 AND price < 500

新增（INSERT）

INSERT INTO products (name, price, stock)
VALUES ('薰衣草皂', 280, 50)

更新（UPDATE）

-- 更新特定記錄（記得加 WHERE，否則會更新全部）
UPDATE products SET stock = 45 WHERE id = 1

-- 更新多個欄位
UPDATE orders SET status = 'shipped', updated_at = CURRENT_TIMESTAMP WHERE id = 5

刪除（DELETE）

-- 刪除特定記錄（記得加 WHERE）
DELETE FROM products WHERE id = 1

關聯查詢（JOIN）

-- 取得訂單時同時取得用戶資料
SELECT orders.id, orders.amount, users.email
FROM orders
JOIN users ON orders.user_id = users.id
WHERE orders.status = 'paid'

在 Cloudflare Workers 裡用參數化查詢（防止 SQL Injection）：

// 用 ? 佔位符，不要直接拼字串
const product = await env.DB.prepare(
  'SELECT * FROM products WHERE id = ?'
).bind(productId).first()

const products = await env.DB.prepare(
  'SELECT * FROM products WHERE stock > ? ORDER BY created_at DESC LIMIT ?'
).bind(0, 10).all()

---

D1 的限制

免費額度：

• 儲存：5GB
• 每天讀取：100,000 次
• 每天寫入：50,000 次

對大多數起步的 app 非常夠用。

D1 不適合的場景：

• 需要複雜的地理分布寫入（D1 寫入會同步到其他節點，但主寫入點是單一的）
• 需要即時的高並發寫入（每秒數千次寫入）
• 需要複雜的全文搜尋（SQLite 的全文搜尋功能有限）

對 90% 的 indie app 來說，D1 完全夠用。

---

總結

D1 是你 app 的長期記憶，用來儲存用戶、文章、訂單等結構化資料。

對 Vibe Coder 來說，最實用的用法是：

1. 用自然語言告訴 AI 你需要什麼資料表
2. AI 生成 SQL，確認沒問題
3. 貼到 bootstrap SQL 或直接執行
4. 用 env.DB.prepare() 查詢，AI 幫你寫查詢語句

---

Danko Peng
X · YouTube · Threads

---

👉 回到教程首頁

想直接上手完整的 Cloudflare 全棧模板？
👉 vibefast.app — 早鳥 $99，2026 年 8 月 1 日漲至 $199。