本文へスキップ

Cloudflare D1 クライアント

Cloudflare アカウント内の D1 データベースを参照し、Cloudflare の API 経由で SQLite クエリを実行できます。

概要

クエリ言語
SQL
ドライバー
初回使用時にダウンロード
接続方法
サービスの API

API トークンで接続

D1 のデータベース名か UUID、Cloudflare アカウント ID、API Token を入力します。トークンは macOS Keychain に保存します。通信は HTTPS なので、ホスト、ポート、TLS 設定、SSH トンネルはありません。

Account > D1 > Edit 権限でトークンを作成し、表示されたときにコピーします。このトークンは選んだデータベースだけでなく、アカウント内のすべての D1 データベースにアクセスできます。d1://account-id/database-name URL をインポートするとアカウントとデータベースが入力されます。トークンは URL に含まれないため、後から貼り付けてください。

データベースの切り替えとクエリ

再接続せずにアカウント内の D1 データベースを切り替えられます。切り替えメニューではデータベースの作成と削除もでき、開いているタブは元のデータベースを維持します。クエリは SQLite の方言を使い、EXPLAIN QUERY PLAN は図で表示します。

各文は単独で成立するように書いてください。一つの文で設定した PRAGMA や作成した一時テーブルは、次の文では消えています。各文は実行時にコミットされ、ロールバックはできません。Cloudflare がリクエストをレート制限すると、エラーに再試行までの待機時間が含まれます。

テーブル、インデックスとトリガー

Structure タブはテーブルの作成と削除、列の追加と削除、インデックスの作成と削除を行い、WHERE 条件付きの部分インデックスにも対応します。Triggers タブではトリガーの作成、編集、削除ができ、テーブルはサイドバーから名前を変更できます。

列の並べ替えや外部キーの変更にはテーブルの再構築が必要です。各文は別々のリクエストで、再構築を一つにまとめるトランザクションがないため、TablePro は再構築スクリプトを生成し、実行はユーザーに任せます。

このページでは Cloudflare D1 固有の内容を扱います。Safe Mode、AI アシスタント、MCP サーバーなど TablePro のその他の機能は機能ページで紹介しています。

その他

  • データの移動

    D1 のテーブルやクエリ結果を CSV、JSON、SQL、XLSX、Markdown、HTML と XML でエクスポートできます。SQL ファイルを読み込むには wrangler d1 execute を --file オプション付きで実行し、結果をここで閲覧してください。

  • 制限

    • 各文は個別の HTTP リクエストです。セッション状態は引き継がれず、トランザクションも非対応です。
  • D1 の Sessions API を使いますか?

    使いません。各文はセッションもブックマークもない独立したリクエストで送るため、同じタブでも別のタブでも、前の文の状態は引き継がれません。

  • Wrangler のインストールは必要ですか?

    閲覧、クエリ、編集には不要です。TablePro は Cloudflare の API と直接通信します。Wrangler が必要なのは SQL ファイルを読み込むときだけです。

TablePro を入手

このページの機能はすべて無料です。