# D1

Create managed, serverless databases with SQL semantics

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/d1/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Cloudflare D1](https://cloudflaredoc.ubitools.com/d1/index.md): 在 Cloudflare 全球网络上构建无服务器 SQL 数据库，并从 Workers 和 Pages 项目中查询它们。

## 快速入门

- [快速入门](https://cloudflaredoc.ubitools.com/d1/get-started/index.md): 创建您的第一个 D1 数据库，定义 schema，并从 Cloudflare Worker 查询它。

## Workers Binding API

- [Workers Binding API](https://cloudflaredoc.ubitools.com/d1/worker-api/index.md): 使用 D1 Binding API 从 Cloudflare Worker 查询 D1 数据库，支持预编译语句、批处理和类型安全的结果。
- [D1 Database](https://cloudflaredoc.ubitools.com/d1/worker-api/d1-database/index.md): 使用 D1Database 绑定从 Worker 准备语句、执行查询、批处理操作和转储 D1 数据库。
- [预编译语句方法](https://cloudflaredoc.ubitools.com/d1/worker-api/prepared-statements/index.md): 使用 run、all、first 和 raw 方法绑定参数并运行 D1 预编译语句。
- [返回对象](https://cloudflaredoc.ubitools.com/d1/worker-api/return-object/index.md): 了解 D1 Worker Binding API 查询方法返回的 D1Result 和 D1ExecResult 对象。

## Wrangler 命令

- [Wrangler 命令](https://cloudflaredoc.ubitools.com/d1/wrangler-commands/index.md): 使用 Wrangler CLI 命令创建、管理和查询 D1 数据库。

## REST API

- [REST API](https://cloudflaredoc.ubitools.com/api/resources/d1/subresources/database/methods/create/index.md): 使用 Cloudflare REST API 以编程方式管理和查询 D1 数据库。

## 示例

- [示例](https://cloudflaredoc.ubitools.com/d1/examples/index.md): 浏览演示常见 D1 数据库操作和模式的代码示例。
- [从 Hono 查询 D1](https://cloudflaredoc.ubitools.com/d1/examples/d1-and-hono/index.md): 从 Hono Web 框架查询 D1
- [从 Remix 查询 D1](https://cloudflaredoc.ubitools.com/d1/examples/d1-and-remix/index.md): 从 Remix 应用查询 D1 数据库。
- [从 SvelteKit 查询 D1](https://cloudflaredoc.ubitools.com/d1/examples/d1-and-sveltekit/index.md): 从 SvelteKit 应用查询 D1 数据库。
- [导出并保存 D1 数据库](https://cloudflaredoc.ubitools.com/workflows/examples/backup-d1/index.md): 导出 D1 数据库并使用 Workflows 将备份保存到 R2 存储。
- [从 Python Workers 查询 D1](https://cloudflaredoc.ubitools.com/d1/examples/query-d1-from-python-workers/index.md): 了解如何从 Python Worker 查询 D1

## 教程

- [教程](https://cloudflaredoc.ubitools.com/d1/tutorials/index.md): D1 分步教程，涵盖构建应用、导入数据和使用读复制。
- [构建评论 API](https://cloudflaredoc.ubitools.com/d1/tutorials/build-a-comments-api/index.md): 使用 D1 为静态博客站点添加评论。创建 D1 数据库 并使用 Hono 构建 JSON API，支持创建和检索 评论。
- [构建员工目录应用](https://cloudflaredoc.ubitools.com/d1/tutorials/build-a-staff-directory-app/index.md): 使用 D1 构建员工目录。用户访问员工信息；管理员在应用内添加新员工。
- [使用代理 Worker 构建访问 D1 的 API](https://cloudflaredoc.ubitools.com/d1/tutorials/build-an-api-to-access-d1/index.md): 本教程展示如何创建 API，使您能够安全地对 D1 数据库运行查询。该 API 可用于自定义访问控制 和/或 限制可查询的表。
- [使用 Prisma ORM 查询 D1](https://cloudflaredoc.ubitools.com/d1/tutorials/d1-and-prisma-orm/index.md): 本教程展示如何从头开始设置和部署访问 D1 数据库的 Cloudflare Worker。
- [使用 REST API 批量导入 D1](https://cloudflaredoc.ubitools.com/d1/tutorials/import-to-d1-with-rest-api/index.md): 本教程介绍如何使用 REST API 将数据库导入 D1。
- [为电商网站使用 D1 读复制](https://cloudflaredoc.ubitools.com/d1/tutorials/using-read-replication-for-e-com/index.md): D1 读复制是一项功能，允许您将 D1 数据库复制到多个区域。这对您的电商网站很有用，因为它降低读取延迟并提升读取吞吐量。

## 演示与架构

- [演示与架构](https://cloudflaredoc.ubitools.com/d1/demos/index.md): 探索使用 D1 数据库的演示应用和参考架构。

## best-practices

- [导入和导出数据](https://cloudflaredoc.ubitools.com/d1/best-practices/import-export-data/index.md): 将现有 SQLite 表导入 D1，或导出 D1 数据库供本地使用。
- [本地开发](https://cloudflaredoc.ubitools.com/d1/best-practices/local-development/index.md): 使用 Wrangler 在本地运行 D1，在部署到 production 之前测试 Worker 和数据库。
- [查询数据库](https://cloudflaredoc.ubitools.com/d1/best-practices/query-d1/index.md): 通过 Workers Binding API、REST API 或 Wrangler 命令使用 SQL 语句查询 D1。
- [全球读复制](https://cloudflaredoc.ubitools.com/d1/best-practices/read-replication/index.md): 通过在全球各区域复制 D1 数据库来降低读取延迟并扩展吞吐量。
- [远程开发](https://cloudflaredoc.ubitools.com/d1/best-practices/remote-development/index.md): 使用 Cloudflare 仪表板 playground 针对 D1 数据库进行远程开发。
- [重试查询](https://cloudflaredoc.ubitools.com/d1/best-practices/retry-queries/index.md): 通过指数退避重试写入查询来处理 D1 的瞬时错误。
- [从 Pages 使用 D1](https://cloudflaredoc.ubitools.com/pages/functions/bindings/#d1-databasesindex.md): 使用 Pages Functions 将 D1 数据库绑定到 Cloudflare Pages 项目。
- [使用索引](https://cloudflaredoc.ubitools.com/d1/best-practices/use-indexes/index.md): 在频繁查询的列上创建索引以提高 D1 查询性能。

## configuration

- [数据位置](https://cloudflaredoc.ubitools.com/d1/configuration/data-location/index.md): 通过设置位置提示或管辖区域约束来控制 D1 存储数据的位置。
- [环境](https://cloudflaredoc.ubitools.com/d1/configuration/environments/index.md): 为 staging 和 production Wrangler 环境配置独立的 D1 数据库。

## observability

- [审计日志](https://cloudflaredoc.ubitools.com/d1/observability/audit-logs/index.md): 查看对 D1 数据库所做配置更改的审计日志条目。
- [计费](https://cloudflaredoc.ubitools.com/d1/observability/billing/index.md): 跟踪 D1 计费指标，包括账户中所有数据库的读取行数、写入行数和存储用量。
- [调试 D1](https://cloudflaredoc.ubitools.com/d1/observability/debug-d1/index.md): 捕获异常并记录 D1 数据库查询返回的错误消息。
- [指标和分析](https://cloudflaredoc.ubitools.com/d1/observability/metrics-analytics/index.md): 通过仪表板或 GraphQL Analytics API 检查 D1 查询量、延迟和存储大小。

## platform

- [Alpha 数据库迁移指南](https://cloudflaredoc.ubitools.com/d1/platform/alpha-migration/index.md): 将 D1 alpha 数据库迁移到可用于 production 的存储后端。
- [限制](https://cloudflaredoc.ubitools.com/d1/platform/limits/index.md): D1 账户和数据库在存储、查询、行大小和 SQL 语句方面的限制。
- [定价](https://cloudflaredoc.ubitools.com/d1/platform/pricing/index.md): D1 基于读取行数、写入行数和存储的定价，采用按需计费模式。
- [发布说明](https://cloudflaredoc.ubitools.com/d1/platform/release-notes/index.md): 跟踪 D1 功能更新、错误修复和重大变更。
- [选择数据或存储产品](https://cloudflaredoc.ubitools.com/workers/platform/storage-options/index.md): 比较 Cloudflare 存储产品（包括 D1、KV、R2 和 Durable Objects），找到适合您需求的方案。

## reference

- [备份（旧版）](https://cloudflaredoc.ubitools.com/d1/reference/backups/index.md): 使用 Wrangler 为 D1 alpha 数据库创建、列出、下载和恢复基于快照的旧版备份。
- [社区项目](https://cloudflaredoc.ubitools.com/d1/reference/community-projects/index.md): 探索社区构建的 ORM、查询构建器和与 D1 集成的工具。
- [数据安全](https://cloudflaredoc.ubitools.com/d1/reference/data-security/index.md): D1 对静态数据和传输中的数据进行加密，并涵盖 Cloudflare 的 SOC 2 和 ISO 27001 合规认证。
- [常见问题](https://cloudflaredoc.ubitools.com/d1/reference/faq/index.md): 关于 D1 定价、限制和用量的常见问题。
- [生成列](https://cloudflaredoc.ubitools.com/d1/reference/generated-columns/index.md): 在 D1 中定义虚拟或存储生成列，以根据其他列、SQL 函数或 JSON 数据自动计算值。
- [术语表](https://cloudflaredoc.ubitools.com/d1/reference/glossary/index.md): D1 文档中使用的关键术语定义。
- [迁移](https://cloudflaredoc.ubitools.com/d1/reference/migrations/index.md): 使用 Wrangler 创建、列出和应用 SQL 迁移文件来对 D1 数据库 schema 进行版本管理。
- [Time Travel 和备份](https://cloudflaredoc.ubitools.com/d1/reference/time-travel/index.md): 使用 Time Travel 时间点恢复，将 D1 数据库恢复到过去 30 天内的任意分钟。

## sql-api

- [定义外键](https://cloudflaredoc.ubitools.com/d1/sql-api/foreign-keys/index.md): 通过定义和延迟外键约束，在 D1 表之间强制执行关系完整性。
- [查询 JSON](https://cloudflaredoc.ubitools.com/d1/sql-api/query-json/index.md): 使用内置 SQLite JSON 函数提取、插入和操作存储在 D1 中的 JSON 数据。
- [SQL 语句](https://cloudflaredoc.ubitools.com/d1/sql-api/sql-statements/index.md): D1 中支持的 SQL 语句、PRAGMA 命令和 SQLite 扩展。