Cloudflare D1 と BigQuery

つなぎ方

Cloudflare D1 と BigQuery は、接続文字列ではなく、Cloudflare や Google の OAuth の同意でつなぎます。読み取り専用のユーザーを作る必要はなく、Cloudflare Tunnel も使いません。

1. 1

   管理画面の「DB接続」で「接続を追加」を押し、接続経路に「インターネット」を、「接続方法」に「Cloudflare D1」か「BigQuery」を選びます。

2. 2

   「Cloudflare と連携」か「Google と連携」を押し、開いた画面で読み取りの権限に同意します。

3. 3

   Cloudflare D1 は D1 データベースを、BigQuery は Google Cloud のプロジェクトを一覧から選んで登録します。登録のときに、読み取れることと、書き込めないことを確かめます。

Cloudflare D1

• 求める権限: D1、アカウントの分析、アカウントの設定の読み取りだけです。書き込みは Cloudflare の側で断られます。
• 読める範囲: 権限は D1 ごとではなくアカウントごとなので、連携したアカウントの D1 はすべて読める状態になります。監視と調査に使うのは、登録した D1 だけです。
• AI が読むもの: テーブル・列・インデックスの定義 (sqlite_master と pragma)、読み取りのクエリの結果、Cloudflare の GraphQL Analytics にあるクエリごとの統計 (回数、所要時間、読んだ行数と書いた行数)。
• 連携の取り消し: Cloudflare のダッシュボードのプロフィールから、いつでも取り消せます。

BigQuery

• 求める権限: BigQuery の読み取りだけです。書き込みは Google の側で断られます。
• 読める範囲: 連携した Google アカウントが見られるデータです。範囲を絞るには、監視専用の Google アカウントを用意し、プロジェクトでジョブを実行する権限 (BigQuery ジョブユーザー) と、監視したいデータセットを読む権限 (BigQuery データ閲覧者) だけを与えてから連携してください。
• AI が読むもの: データセットごとの INFORMATION_SCHEMA にある表と列の定義、表の行数・容量・最終更新、読み取りのクエリの結果、リージョンごとの INFORMATION_SCHEMA.JOBS にあるジョブの履歴 (費用、失敗、所要時間、スロット)。
• 連携の取り消し: Google アカウントの「サードパーティ製のアプリとサービス」から、いつでも取り消せます。

BigQuery の料金

監視と調査のクエリは選んだプロジェクトで実行され、読んだデータ量に応じた BigQuery の料金はそのプロジェクトに付きます。この料金は、Scandock の料金とは別に Google Cloud から請求されます。

1回のクエリで課金されるデータ量は 1 GiB までに制限しています。超えるクエリは、BigQuery が実行せずに断ります (料金は付きません)。

接続文字列でつなぐ DB との違い

• SQL の対処: 管理者の接続がないため、書き込みを伴う SQL の対処は使えません (通知などの対処は使えます)。
• AI のクエリ: Cloudflare D1 では SELECT・EXPLAIN・WITH、BigQuery では SELECT と WITH の1文に限って実行します (WITH は本体が SELECT のもの)。