导航|地址|刷新
Query D1 from Hono

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/d1/llms.txt
Use this file to discover all available pages before exploring further.

Docs Directory API SDKs Changelog

Search

Log in

D1

/

Overview

Getting started

Best practices

Import and export data

Query a database

Retry queries

Use indexes

Local development

Remote development

Use D1 from Pages ↗

Global read replicationBeta

Workers Binding API

Overview

D1 Database

Prepared statement methods

Return objects

SQL API

SQL statements

Define foreign keys

Query JSON

Wrangler commands

REST API ↗API

Configuration

Data location

Environments

Observability

Debug D1

Metrics and analytics

Billing

Audit Logs

Examples

Export and save D1 database ↗

Query D1 from Remix

Query D1 from Hono

Query D1 from SvelteKit

Query D1 from Python Workers

Tutorials

Demos and architectures

Platform

Pricing

Limits

Alpha database migration guide

Choose a data or storage product ↗

Release notes

Reference

Migrations

Time Travel and backups

Community projects

Generated columns

Data security

Backups (Legacy)

FAQs

Glossary

Agent resources

Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

D1 llms.txt ↗

D1 llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗

Home

/D1

/Examples

/Query D1 from Hono

Query D1 from Hono

Query D1 from the Hono web framework

Last updated Apr 21, 2026|Copy as Markdown|View as Markdown|Agent setup

Hono is a fast web framework for building API-first applications, and it includes first-class support for both Workers and Pages.

When using Workers:

Ensure you have configured your Wrangler configuration file to bind your D1 database to your Worker.

You can access your D1 databases via Hono's Context ↗ parameter: bindings ↗ are exposed on context.env. If you configured a binding named DB, then you would access D1 Workers Binding API methods via c.env.DB.

Refer to the Hono documentation for Cloudflare Workers ↗.

If you are using Pages Functions:

Bind a D1 database to your Pages Function.

Pass the --d1 BINDING_NAME=DATABASE_ID flag to wrangler dev when developing locally. BINDING_NAME should match what call in your code, and DATABASE_ID should match the database_id defined in your Wrangler configuration file: for example, --d1 DB=xxxx-xxxx-xxxx-xxxx-xxxx.

Refer to the Hono guide for Cloudflare Pages ↗.

The following examples show how to access a D1 database bound to DB from both a Workers script and a Pages Function:

import { Hono } from "hono";// This ensures c.env.DB is correctly typedtype Bindings = { DB: D1Database;};const app = new Hono<{ Bindings: Bindings }>();// Accessing D1 is via the c.env.YOUR_BINDING propertyapp.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 youexport default app;

import { Hono } from "hono";import { handle } from "hono/cloudflare-pages";// This ensures c.env.DB is correctly typedtype Bindings = { DB: D1Database;};const app = new Hono<{ Bindings: Bindings }>().basePath("/api");// Accessing D1 is via the c.env.YOUR_BINDING propertyapp.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 functionexport const onRequest = handle(app);

PreviousQuery D1 from Remix NextQuery D1 from SvelteKit

Was this helpful?

YesNo

Edit pageReport issue

On this page

Overview

Edit pageReport issue

Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search

Company
AboutCareersInvestorsPressPress kitGlobal network

Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG

Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse

Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog

Developers
DocumentationLearning centerCommunity

Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform

Start BuildingLog In

© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices

Docs

------
导航页打开网址