*検証日: 2026-11-10
はじめに
Cloudflare D1 には、データベースを作るときにプライマリの置き場所を伝える location hint(--primary-location-hint)というオプションがあります。日本から使うなら apac を付けたくなりますが、次のような話を聞きました。
apacを指定すると日本以外(香港やシンガポールなど)に作られることがある。何も指定しないほうが東京か大阪に作られやすい。
D1 では、作ったあとにプライマリの場所を変えられません。最初にどう作るかで、その後ずっとレイテンシが変わってしまいます。そこで実際に DB を作り、どこに置かれたかを確かめ、Worker から速度も測りました。
まとめ
- 位置を指定しなかった DB は 8 個すべてが日本(東京 4、大阪 4)に置かれた。
apacを指定した DB で日本に置かれたのは 8 個中 3 個。残りは香港 3、ソウル 1、シンガポール 1。- 東京の Worker からの往復時間(RTT、中央値)は、東京 約 10ms、大阪 約 17ms、ソウル 約 40ms、香港 約 58ms、シンガポール 約 80ms。
- 日本からアクセスするなら、location hint は付けないほうがよい。
環境
- 実行場所: 日本(WSL2)。Worker は NRT(東京)で動いた。
wrangler4.151.0cf1.0.0-beta.28(Cloudflare 公式の新しい CLI。npx cfで使える)
cf コマンドについて
cf は npm の cf パッケージとして公開されている、Cloudflare 公式の CLI です(リポジトリは cloudflare/cf)。wrangler でログインしていれば、その認証がそのまま使えました。
npm i -D cf
npx cf d1 list
npx cf d1 create --name mydb [--primary-location-hint apac]
npx cf d1 query <DATABASE_ID> --sql 'SELECT 1'
npx cf d1 delete <DATABASE_ID> --force # 非対話で実行するときは --force が必要
DB の所在地を確認する方法
クエリ結果の meta に、そのクエリを処理した場所が入っています。
"meta": {
"served_by": "v3-prod",
"served_by_region": "APAC",
"served_by_colo": "NRT",
"served_by_primary": true,
...
}
served_by_primary: true のときの served_by_colo が、プライマリのあるデータセンター(IATA コード)です。同じ DB に何度問い合わせても値は変わらなかったので、DB 本体の場所を表していると判断しました。
この値は wrangler でも確認できます(--json を付けると見やすくなります)。
npx wrangler d1 execute <DB_NAME> --remote --command 'SELECT 1' --json
注意点として、作成時のレスポンスに入る created_in_region は "APAC" までしか分かりません。そのため、国や都市を知るにはクエリを 1 回実行する必要があります。
検証 1:どこに作られるか
位置を指定しない DB と、--primary-location-hint apac を付けた DB を交互に 8 個ずつ作りました。
for i in $(seq 1 8); do
npx cf d1 create --name d1rt-nohint-$i
npx cf d1 create --name d1rt-apac-$i --primary-location-hint apac
done
その後、各 DB に SELECT 1 を 3 回ずつ送り、served_by_colo を記録しました。どの DB も 3 回とも同じ値でした。
| DB | colo | DB | colo | |
|---|---|---|---|---|
| nohint-1 | NRT | apac-1 | HKG | |
| nohint-2 | KIX | apac-2 | KIX | |
| nohint-3 | KIX | apac-3 | KIX | |
| nohint-4 | KIX | apac-4 | SIN | |
| nohint-5 | KIX | apac-5 | ICN | |
| nohint-6 | NRT | apac-6 | HKG | |
| nohint-7 | NRT | apac-7 | KIX | |
| nohint-8 | NRT | apac-8 | HKG |
集計
| 作成方法 | NRT 東京 | KIX 大阪 | HKG 香港 | ICN ソウル | SIN シンガポール |
|---|---|---|---|---|---|
| 指定なし | 4 | 4 | – | – | – |
apac |
0 | 3 | 3 | 1 | 1 |
位置を指定しない場合は、作成リクエストを送った場所に近いデータセンターが選ばれるようです。CLI のヘルプにも「省略すると、できるだけ現在のユーザーに近い場所に作る」と書かれています。一方 apac は「アジア太平洋のどこか」という意味のヒントで、地域内のいくつかのデータセンターに振り分けられていると考えられます。
検証 2:速度
16 個の DB をすべてバインドした Worker をデプロイしました。Worker の中から各 DB に SELECT 1 を 30 回連続で送り、1 回ごとの往復時間を測っています(最初に 1 回空打ちしてから計測)。
export default {
async fetch(req, env) {
const n = Number(new URL(req.url).searchParams.get("n") || 20);
const out = { workerColo: req.cf?.colo, n, dbs: [] };
for (const [k, db] of Object.entries(env)) {
if (!k.startsWith("DB_")) continue;
await db.prepare("SELECT 1").first(); // warm-up
const t = []; let colo;
for (let i = 0; i < n; i++) {
const s = Date.now();
const r = await db.prepare("SELECT 1").run();
t.push(Date.now() - s);
colo = r.meta.served_by_colo;
}
t.sort((a, b) => a - b);
out.dbs.push({ db: k, colo, min: t[0], p50: t[n >> 1], p90: t[Math.floor(n * 0.9)], max: t[n - 1] });
}
return Response.json(out);
},
};
Workers の中では
Date.now()の値が I/O を待つ間にしか進みません。D1 呼び出しの前後で測る使い方なら、正しく計れます。
計測は 3 回行い、Worker は 3 回とも NRT(東京) で動きました。
結果(単位: ms、p50 は 3 回分)
| DB | colo | p50(1回目/2回目/3回目) | min | max |
|---|---|---|---|---|
| nohint-1 | NRT | 11 / 9 / 10 | 7 | 41 |
| nohint-6 | NRT | 10 / 10 / 9 | 7 | 52 |
| nohint-7 | NRT | 10 / 9 / 10 | 6 | 60 |
| nohint-8 | NRT | 11 / 11 / 12 | 8 | 52 |
| nohint-2 | KIX | 15 / 16 / 17 | 13 | 60 |
| nohint-3 | KIX | 16 / 16 / 16 | 14 | 41 |
| nohint-4 | KIX | 17 / 19 / 16 | 14 | 29 |
| nohint-5 | KIX | 15 / 17 / 17 | 14 | 40 |
| apac-2 | KIX | 16 / 19 / 18 | 14 | 46 |
| apac-3 | KIX | 18 / 21 / 18 | 15 | 38 |
| apac-7 | KIX | 19 / 20 / 18 | 15 | 26 |
| apac-5 | ICN | 39 / 41 / 40 | 37 | 74 |
| apac-1 | HKG | 57 / 58 / 57 | 53 | 101 |
| apac-6 | HKG | 58 / 61 / 58 | 53 | 107 |
| apac-8 | HKG | 59 / 59 / 58 | 53 | 121 |
| apac-4 | SIN | 81 / 84 / 77 | 72 | 163 |
場所ごとの目安(東京の Worker から、1 クエリあたり)
| DB の場所 | p50 |
|---|---|
| NRT 東京 | 約 10ms |
| KIX 大阪 | 約 16〜18ms |
| ICN ソウル | 約 40ms |
| HKG 香港 | 約 58ms |
| SIN シンガポール | 約 80ms |
この差は クエリ 1 回ごとに かかります。1 回のリクエストで 5 回クエリを順に投げる API なら、東京なら約 50ms で済むところ、香港では約 290ms、シンガポールでは約 400ms かかる計算です。
考察
- 日本から使うサービスなら、location hint は付けずに日本から作成する のが最もよい結果でした。東京と大阪のどちらになるかは選べませんが、どちらでも 10〜20ms 程度です。
apacを付けると、日本に置かれる確率は今回の試行では 3/8 でした。残りは 40〜80ms のレイテンシになり、損をするだけです。- 作成リクエストをどこから送るかで結果が変わる可能性があります。CI など海外のランナーで DB を作る場合は、作成後に
served_by_coloを必ず確認したほうが安全です。 - 既に日本の外に作ってしまった DB は、場所を移せません。新しい DB を位置指定なしで作り、
wrangler d1 exportとwrangler d1 execute --fileでデータを移すことになります。 - 今回は試行数が各 8 個と少ないので、割合はあくまで目安です。