Hono から D1 をクエリする

Hono は API ファーストのアプリケーション向けの高速なウェブフレームワークで、Workers と Pages の両方を最初からサポートしています。

Workers を使う場合:

Wrangler 設定ファイルで、D1 データベースを Worker にバインドしてください。
D1 データベースには、Hono の Context ↗ パラメーター経由でアクセスできます。バインディング ↗ は context.env に公開されます。バインディング名を DB にした場合、D1 Workers Binding API のメソッドは c.env.DB から呼び出します。
Cloudflare Workers ↗ 向けの Hono ドキュメントを参照してください。

Pages Functions を使っている場合:

D1 データベースを Pages Function にバインドします。
ローカル開発では wrangler dev に --d1 BINDING_NAME=DATABASE_ID フラグを渡します。BINDING_NAME はコード内の呼び出し名と一致させ、DATABASE_ID は Wrangler 設定ファイルの database_id と一致させます。例: --d1 DB=xxxx-xxxx-xxxx-xxxx-xxxx。
Cloudflare Pages ↗ 向けの Hono ガイドを参照してください。

次の例は、DB にバインドした D1 データベースへ、Workers スクリプトと Pages Function の両方からアクセスする方法を示します。

import { Hono } from "hono";

// This ensures c.env.DB is correctly typed
type Bindings = {
	DB: D1Database;
};

const app = new Hono<{ Bindings: Bindings }>();

// Accessing D1 is via the c.env.YOUR_BINDING property
app.get("/query/users/:id", async (c) => {
	const userId = c.req.param("id");
	try {
		let { results } = await c.env.DB.prepare(
			"SELECT * FROM users WHERE user_id = ?",
		)
			.bind(userId)
			.run();
		return c.json(results);
	} catch (e) {
		return c.json({ err: "Failed to query user" }, 500);
	}
});

// Export our Hono app: Hono automatically exports a
// Workers 'fetch' handler for you
export default app;

import { Hono } from "hono";
import { handle } from "hono/cloudflare-pages";

// This ensures c.env.DB is correctly typed
type Bindings = {
	DB: D1Database;
};

const app = new Hono<{ Bindings: Bindings }>().basePath("/api");

// Accessing D1 is via the c.env.YOUR_BINDING property
app.get("/query/users/:id", async (c) => {
	const userId = c.req.param("id");
	try {
		let { results } = await c.env.DB.prepare(
			"SELECT * FROM users WHERE user_id = ?",
		)
			.bind(userId)
			.run();
		return c.json(results);
	} catch (e) {
		return c.json({ err: "Failed to query user" }, 500);
	}
});

// Export the Hono instance as a Pages onRequest function
export const onRequest = handle(app);