# D1

SQL セマンティクスのマネージドサーバーレスデータベースを作成します

> 以下のリンクは、各ページの Markdown 版を直接指します。 任意のページは、`index.md` サフィックスなしの URL に `Accept: text/markdown` ヘッダーを付けて取得することもできます（例: `curl -H "Accept: text/markdown" https://developers.cloudflare.com/d1/`）。
>
> その他の Cloudflare 製品は、[Cloudflare ドキュメントディレクトリ](https://developers.cloudflare.com/llms.txt) を参照してください。

## 概要

- [Cloudflare D1](https://developers.cloudflare.com/d1/index.md): Cloudflare のグローバルネットワーク上にサーバーレス SQL データベースを構築し、Workers と Pages のプロジェクトからクエリします。

## はじめに

- [はじめに](https://developers.cloudflare.com/d1/get-started/index.md): 最初の D1 データベースを作成し、スキーマを定義して、Cloudflare Worker から照会します。

## Workers Binding API

- [Workers Binding API](https://developers.cloudflare.com/d1/worker-api/index.md): Cloudflare Worker から D1 Binding API を使い、プリペアドステートメント、バッチ処理、型安全な結果で D1 データベースをクエリします。
- [D1 Database](https://developers.cloudflare.com/d1/worker-api/d1-database/index.md): D1Database バインディングを使い、Worker からステートメントの準備、クエリの実行、バッチ操作、D1 データベースのダンプを行います。
- [プリペアドステートメントのメソッド](https://developers.cloudflare.com/d1/worker-api/prepared-statements/index.md): パラメーターをバインドし、run、all、first、raw メソッドで D1 のプリペアドステートメントを実行します。
- [戻り値のオブジェクト](https://developers.cloudflare.com/d1/worker-api/return-object/index.md): D1 Worker Binding API のクエリメソッドが返す D1Result と D1ExecResult オブジェクトについて説明します。

## Wrangler コマンド

- [Wrangler コマンド](https://developers.cloudflare.com/d1/wrangler-commands/index.md): Wrangler CLI コマンドで、D1 データベースの作成、管理、クエリを行います。

## REST API

- [REST API](https://developers.cloudflare.comhttps://developers.cloudflare.com/api/resources/d1/subresources/database/methods/create/index.md): Cloudflare REST API を使って、D1 データベースをプログラムから管理し、クエリします。

## 例

- [例](https://developers.cloudflare.com/d1/examples/index.md): D1 データベースの一般的な操作とパターンを示すコード例を参照します。
- [Hono から D1 をクエリする](https://developers.cloudflare.com/d1/examples/d1-and-hono/index.md): Hono ウェブフレームワークから D1 をクエリします。
- [Remix から D1 をクエリする](https://developers.cloudflare.com/d1/examples/d1-and-remix/index.md): Remix アプリケーションから D1 データベースをクエリします。
- [SvelteKit から D1 にクエリする](https://developers.cloudflare.com/d1/examples/d1-and-sveltekit/index.md): SvelteKit アプリケーションから D1 データベースにクエリします。
- [D1 データベースのエクスポートと保存](https://developers.cloudflare.com/workflows/examples/backup-d1/index.md): Workflows を使って D1 データベースをエクスポートし、バックアップを R2 ストレージに保存します。
- [Python Workers から D1 をクエリする](https://developers.cloudflare.com/d1/examples/query-d1-from-python-workers/index.md): Python Worker から D1 をクエリする方法を学びます

## チュートリアル

- [チュートリアル](https://developers.cloudflare.com/d1/tutorials/index.md): アプリケーションの構築、データのインポート、読み取りレプリケーションの利用に関する D1 の手順解説です。
- [Comments API を構築する](https://developers.cloudflare.com/d1/tutorials/build-a-comments-api/index.md): D1 を使って静的ブログサイトにコメントを追加します。D1 データベースを作成し、 コメントの作成と取得ができる JSON API を Hono で構築します。
- [スタッフディレクトリアプリケーションを構築する](https://developers.cloudflare.com/d1/tutorials/build-a-staff-directory-app/index.md): D1 でスタッフディレクトリを構築します。ユーザーは従業員情報を参照でき、管理者はアプリ内で新しい従業員を追加できます。
- [プロキシ Worker を使って D1 にアクセスする API を構築する](https://developers.cloudflare.com/d1/tutorials/build-an-api-to-access-d1/index.md): このチュートリアルでは、D1 データベースに対して安全にクエリを実行できる API の作成方法を説明します。アクセス制御のカスタマイズや、クエリ可能なテーブルの制限に使えます。
- [Prisma ORM で D1 をクエリする](https://developers.cloudflare.com/d1/tutorials/d1-and-prisma-orm/index.md): D1 データベースにアクセスする Cloudflare Worker を、いちからセットアップしてデプロイする手順です。
- [REST API で D1 に一括インポートする](https://developers.cloudflare.com/d1/tutorials/import-to-d1-with-rest-api/index.md): このチュートリアルでは、REST API を使ってデータベースを D1 にインポートします。
- [E コマースサイトで D1 の読み取りレプリケーションを使う](https://developers.cloudflare.com/d1/tutorials/using-read-replication-for-e-com/index.md): D1 の読み取りレプリケーションは、D1 データベースを複数リージョンに複製する機能です。E コマースサイトでは、読み取りレイテンシを下げ、読み取りスループットを上げられます。

## デモとアーキテクチャ

- [デモとアーキテクチャ](https://developers.cloudflare.com/d1/demos/index.md): D1 データベースを使うデモアプリケーションとリファレンスアーキテクチャを確認できます。

## best-practices

- [データのインポートとエクスポート](https://developers.cloudflare.com/d1/best-practices/import-export-data/index.md): 既存の SQLite テーブルを D1 にインポートするか、D1 データベースをローカル利用向けにエクスポートします。
- [ローカル開発](https://developers.cloudflare.com/d1/best-practices/local-development/index.md): Wrangler で D1 をローカル実行し、本番へデプロイする前に Worker とデータベースをテストします。
- [データベースのクエリ](https://developers.cloudflare.com/d1/best-practices/query-d1/index.md): Workers Binding API、REST API、Wrangler コマンドから SQL 文で D1 をクエリします。
- [グローバル読み取りレプリケーション](https://developers.cloudflare.com/d1/best-practices/read-replication/index.md): D1 データベースを世界各地のリージョンに複製し、読み取りレイテンシを下げ、スループットをスケールします。
- [リモート開発](https://developers.cloudflare.com/d1/best-practices/remote-development/index.md): Cloudflare ダッシュボードの playground を使って、リモートの D1 データベースに対して開発します。
- [クエリを再試行する](https://developers.cloudflare.com/d1/best-practices/retry-queries/index.md): 一時的な D1 エラーが発生したときは、指数バックオフで書き込みクエリを再試行します。
- [Pages から D1 を使う](https://developers.cloudflare.com/pages/functions/bindings/index.md#d1-databases): Pages Functions を使って、Cloudflare Pages プロジェクトに D1 データベースをバインドします。
- [インデックスを使う](https://developers.cloudflare.com/d1/best-practices/use-indexes/index.md): よく照会する列にインデックスを作成して、D1 のクエリ性能を上げます。

## configuration

- [データの所在地](https://developers.cloudflare.com/d1/configuration/data-location/index.md): ロケーションヒントや管轄（jurisdiction）の制約を設定して、D1 がデータを保存する場所を制御します。
- [環境](https://developers.cloudflare.com/d1/configuration/environments/index.md): ステージングと本番の Wrangler 環境向けに、別々の D1 データベースを設定します。

## observability

- [監査ログ](https://developers.cloudflare.com/d1/observability/audit-logs/index.md): D1 データベースに対する設定変更の監査ログエントリを確認します。
- [課金](https://developers.cloudflare.com/d1/observability/billing/index.md): アカウント全体の読み取り行数、書き込み行数、ストレージ使用量など、D1 の課金メトリクスを確認します。
- [D1 のデバッグ](https://developers.cloudflare.com/d1/observability/debug-d1/index.md): D1 データベースのクエリから返る例外を捕捉し、エラーメッセージを記録します。
- [メトリクスと分析](https://developers.cloudflare.com/d1/observability/metrics-analytics/index.md): ダッシュボードまたは GraphQL Analytics API で、D1 のクエリ量、レイテンシ、ストレージサイズを確認します。

## platform

- [アルファデータベースの移行ガイド](https://developers.cloudflare.com/d1/platform/alpha-migration/index.md): D1 のアルファデータベースを、本番利用可能なストレージバックエンドへ移行します。
- [制限](https://developers.cloudflare.com/d1/platform/limits/index.md): D1 のアカウントおよびデータベースの制限です。ストレージ、クエリ、行サイズ、SQL ステートメントが含まれます。
- [料金](https://developers.cloudflare.com/d1/platform/pricing/index.md): D1 の料金は、読み取り行数、書き込み行数、ストレージに基づき、スケールツーゼロで課金されます。
- [リリースノート](https://developers.cloudflare.com/d1/platform/release-notes/index.md): D1 の機能追加、バグ修正、破壊的変更を時系列で確認できます。
- [データまたはストレージ製品を選ぶ](https://developers.cloudflare.com/workers/platform/storage-options/index.md): D1、KV、R2、Durable Objects など、Cloudflare のストレージ製品を比較して、用途に合うものを選びます。

## reference

- [バックアップ（レガシー）](https://developers.cloudflare.com/d1/reference/backups/index.md): Wrangler を使い、D1 のアルファデータベース向けに、レガシーなスナップショットベースのバックアップを作成、一覧、ダウンロード、復元します。
- [コミュニティプロジェクト](https://developers.cloudflare.com/d1/reference/community-projects/index.md): D1 と連携するコミュニティ製の ORM、クエリビルダー、ツールを紹介します。
- [データセキュリティ](https://developers.cloudflare.com/d1/reference/data-security/index.md): D1 は保存時と転送時にデータを暗号化し、Cloudflare の SOC 2 および ISO 27001 コンプライアンス認証の対象です。
- [よくある質問](https://developers.cloudflare.com/d1/reference/faq/index.md): D1 の料金、制限、利用に関するよくある質問です。
- [生成列](https://developers.cloudflare.com/d1/reference/generated-columns/index.md): D1 で仮想または格納型の生成列を定義し、ほかの列、SQL 関数、JSON データから値を自動計算します。
- [用語集](https://developers.cloudflare.com/d1/reference/glossary/index.md): D1 ドキュメント全体で使う主な用語の定義です。
- [マイグレーション](https://developers.cloudflare.com/d1/reference/migrations/index.md): 作成・一覧・適用を Wrangler で行う SQL マイグレーションファイルで、D1 のデータベーススキーマをバージョン管理します。
- [Time Travel とバックアップ](https://developers.cloudflare.com/d1/reference/time-travel/index.md): Time Travel のポイントインタイムリカバリーを使い、直近 30 日以内の任意の分に D1 データベースを復元します。

## sql-api

- [外部キーを定義する](https://developers.cloudflare.com/d1/sql-api/foreign-keys/index.md): D1 のテーブル間で参照整合性を強制するため、外部キー制約を定義し、遅延できます。
- [JSON を照会する](https://developers.cloudflare.com/d1/sql-api/query-json/index.md): SQLite 組み込みの JSON 関数で、D1 に保存した JSON データを抽出、挿入、操作します。
- [SQL ステートメント](https://developers.cloudflare.com/d1/sql-api/sql-statements/index.md): D1 で利用できる、対応済みの SQL ステートメント、PRAGMA コマンド、SQLite 拡張です。