Mac 用 Cloudflare D1 クライアント

D1 接続にはデータベース名または UUID、Cloudflare アカウント ID、API トークンの三つが必要です。トークンは API Token 欄に入力し、macOS キーチェーン に保存します。すべてのリクエストが HTTPS で Cloudflare API に向かうため、ホスト、ポート、SSL 設定や SSH トンネルはありません。

Custom token テンプレートから Account > D1 > Edit 権限のトークンを作成し、一度だけ表示されるときにコピーしてください。そのトークンは接続先だけでなく、アカウント内のすべての D1 データベースにアクセスできます。

d1://account-id/database-name URL のインポートでアカウントとデータベースを入力できます。トークンは URL に含まれないため、後で貼り付けてください。

ツールバーの切り替え欄にはアカウントの D1 データベースを一覧表示し、再接続せずに切り替えられます。データベースの作成・削除もできます。各タブは開いたときのデータベースに留まります。

クエリは SQLite 方言を使います。EXPLAIN QUERY PLAN は図で表示し、行の編集は保存までグリッドに保留します。Preview SQL で先に文を確認できます。

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

Structure タブ はテーブルの作成・削除、カラムの追加・削除、インデックスの作成・削除を行い、WHERE 条件付き部分インデックスにも対応します。Preview SQL は保存前に DDL を表示します。Triggers タブでトリガーを作成、編集、削除でき、テーブルはサイドバーから名前変更できます。

カラム順や外部キーの変更にはテーブル再構築が必要です。D1 では文がそれぞれ別のリクエストで、再構築を一つにまとめるトランザクションがないため、TablePro は再構築スクリプトを生成し、ユーザーに実行を任せます。

TablePro は D1 のインポートに対応しません。wrangler d1 execute の --file オプションで SQL ファイルを読み込み、結果をここで閲覧できます。エクスポート は D1 テーブルやクエリ結果を CSV、JSON、SQL、XLSX、Markdown、HTMLとXML に書き込みます。

iPhone と iPad アプリには Cloudflare D1 ドライバーがありません。Mac から同期した Cloudflare D1 接続は一覧に表示しますが、開けません。