ブログ一覧に戻る

PostgreSQL 19 RC1 の ON CONFLICT DO SELECT と REPACK CONCURRENTLY を実測

PostgreSQL 19 の RC1 が 2026年10月15日に公開されました。Supabase など Postgres を使う Web アプリの開発者向けに、リリースノートの中で日々のコードに効きそうな2つの機能、INSERT ... ON CONFLICT DO SELECT と REPACK (CONCURRENTLY) を、RC1 を自分でビルドして動かして確かめました。あわせて、「19 に入る」と紹介する情報を見かけた SQL/PGQ(グラフクエリ)が実際に入っているかも確認しています。結論を先に書くと、前2つは条件つきで使えそうで、SQL/PGQ は RC1 には入っていませんでした。

TL;DR

  • ON CONFLICT DO SELECT は、既存行を返すだけの get-or-create で、DO UPDATE SET name = EXCLUDED.name という回避策と比べて、行バージョンを増やさず(xmin が変わらない)、UPDATE トリガーも発火しませんでした。10,000 キーに対する 100,000 回の衝突で、WAL は約 27.5MB から約 0.9MB、スループットは約 2,200 tps から約 10,500 tps(いずれも単一クライアント、3回の中央値付近)でした。
  • ただし衝突しても bigserial の採番は消費されます。100,000 回の衝突でシーケンスは 100,000 進みました。
  • REPACK (CONCURRENTLY) は、テーブル書き換え中も更新が止まりませんでした。更新の最大遅延は VACUUM FULL / REPACK が約 0.9〜1.1 秒だったのに対し、CONCURRENTLY は 56〜66ms でした(600,000 行・約 270MB のテーブル、毎秒 400 件の更新を流しながら)。更新の取りこぼしもありませんでした。
  • REPACK (CONCURRENTLY) には主キー(または replica identity の索引)が必要で、UNLOGGED テーブル・トランザクションブロック内・max_repack_replication_slots = 0 では実行できません。
  • SQL/PGQ(CREATE PROPERTY GRAPH、GRAPH_TABLE)は 19 RC1 では構文エラーでした。

背景:なぜ今この2つを確かめるのか

PostgreSQL 19 は 2026年10月18日時点で RC1 です(RC1 のお知らせ)。RC は正式版の直前の候補版で、ここから機能が増えることは通常ありませんが、正式版までに挙動が変わる可能性はゼロではありません。この記事の数値と挙動は RC1 のものです。

2つを選んだ理由は、手元のアプリで「あの回避策を書き換えられるのか」が具体的に判断できるからです。

  • get-or-create(タグやカテゴリを「あれば取得、なければ作成」)は、これまで DO NOTHING + 再 SELECT か、DO UPDATE で何もしない更新を書いて行を返す、という回避策が定番でした。
  • テーブルの肥大化を解消する VACUUM FULL は ACCESS EXCLUSIVE ロックを取り、実行中は読み書きが止まります。リリースノートでは、REPACK コマンドが VACUUM FULL と CLUSTER を統一するもので、CONCURRENTLY オプションでロックを短くできる、と説明されています。

検証環境

項目内容
実行日2026年10月18日
OSUbuntu 24.04、x86_64、4 vCPU(クラウドのサンドボックス、root から postgres ユーザーに切り替えて実行)
PostgreSQL19rc1(postgresql-19rc1.tar.bz2 を公式サイトから取得し、sha256 を照合してソースからビルド。--without-icu)
主な設定shared_buffers=256MB、maintenance_work_mem=256MB、autovacuum=off、wal_level=logical、max_repack_replication_slots=2
計測ツール同梱の pgbench(単一クライアントの衝突負荷と、4クライアント・毎秒400件のレート制御付き更新)

共有環境のため、絶対値より比を見てください。計測はすべて同じマシン・同じ設定で、各条件3回ずつ行いました。

実験1:ON CONFLICT DO SELECT

書き方と挙動

CREATE TABLE tag(
  id bigserial PRIMARY KEY,
  name text UNIQUE NOT NULL,
  hits int DEFAULT 0
);

-- 19: 既存行をそのまま返す
INSERT INTO tag(name) VALUES ('a')
  ON CONFLICT (name) DO SELECT
  RETURNING id, name;

DO SELECT の後ろには FOR UPDATE などの行ロック指定と WHERE 条件を付けられます(公式のINSERT のリファレンスの構文どおりです)。同じ行に対して既存の回避策と並べると、次の違いがありました。

方法衝突時に返る行xmin(行バージョン)UPDATE トリガー
DO NOTHING RETURNING id返らない(0行)変化なし発火しない
DO UPDATE SET name = EXCLUDED.name RETURNING id返る668 → 669 に増える発火する
DO SELECT RETURNING id返る668 のまま発火しない

挙動の細部で、確かめられたことを挙げます。

  • DO SELECT ... WHERE tag.hits > 5 のように条件を付け、条件を満たさないと、衝突しても行は返りません(0行)。
  • 1つの文に同じキーを2回入れた場合、DO UPDATE は「ON CONFLICT DO UPDATE command cannot affect row a second time」でエラーになりますが、DO SELECT は同じ行を2回返しました。
  • 衝突対象(ON CONFLICT (name) または ON CONSTRAINT)の指定は必須で、省略すると「requires inference specification or constraint name」のエラーになります。DO NOTHING のように対象を省略はできません。
  • 複数行を一度に入れると、既存の行も新規の行も RETURNING に出ます。どちらだったかを区別するには別の手がかりが必要です(私は xmax の値が0かどうかで見ましたが、これは内部の挙動に頼る方法なので、アプリのコードに書く前に別の設計を考えるほうが安全です)。

負荷をかけた結果

10,000 件のタグがある表に、ランダムなキーで 100,000 回、必ず衝突する INSERT を単一クライアントで流しました。DO NOTHING は「INSERT して、返らなければ SELECT する」CTE(共通テーブル式)で書いています。表は毎回作り直し、autovacuum は止めています。

方式tps(3回)平均レイテンシ生成 WAL実行後のヒープサイズ
DO UPDATE(何もしない更新)2,088 / 2,185 / 2,4100.42〜0.48 ms約 27.5 MB約 760〜770 KB
DO NOTHING + 再 SELECT6,762 / 6,316 / 6,2100.15〜0.16 ms約 0.9 MB約 450 KB(増加なし)
DO SELECT9,858 / 10,581 / 11,1620.09〜0.10 ms約 0.9 MB約 450 KB(増加なし)

DO UPDATE は衝突のたびに新しい行バージョンを書くため、WAL もヒープも増えました。DO NOTHING + 再 SELECT と DO SELECT は WAL もヒープも増えず、DO SELECT のほうが速くなりました。

注意点が1つあります。DO NOTHING + 再 SELECT と DO SELECT の約 0.9MB の WAL は、衝突しても bigserial の採番が消費されることが原因と考えられます。実行後のシーケンスの値は 110,000(初期データ 10,000 + 衝突 100,000)で、100,000 回の衝突で 100,000 進んでいました。WAL の内訳までは調べていないので、採番が原因と断定はしていません。「衝突しても id が飛ぶ」点は従来の ON CONFLICT と同じで、DO SELECT でも変わりません。id が連番であることを前提にした設計は避けてください。

実験2:REPACK と REPACK (CONCURRENTLY)

検証の組み立て

600,000 行の生存行を持ち、肥大化させた表を用意しました(2,000,000 行を挿入し、id % 10 < 7 の行を削除して VACUUM。表は約 270MB のまま)。そこに4クライアントで毎秒 400 件(pgbench -R 400)の UPDATE events SET hits = hits + 1 WHERE id = <生存行> を流し、開始8秒後に次のいずれかを実行しました。

VACUUM FULL events;
REPACK events;
REPACK (CONCURRENTLY) events;

各条件3回ずつ、毎回同じ状態の表を作り直しています。

結果

コマンド実行時間実行後のテーブルサイズ更新の最大遅延100ms 超の更新数
VACUUM FULL0.99 / 1.11 / 1.12 秒82 MB974 / 1,096 / 1,109 ms369 / 438 / 428
REPACK0.98 / 0.98 / 1.01 秒82 MB941 / 940 / 968 ms361 / 331 / 381
REPACK (CONCURRENTLY)0.94 / 0.90 / 1.08 秒82 MB66 / 56 / 58 ms0 / 0 / 0
  • VACUUM FULL と REPACK(CONCURRENTLY なし)は、実行時間とほぼ同じ約1秒、更新が止まりました。pgbench はレートを制御して予定時刻からの遅れもレイテンシに含めるため、止まった後の積み残しが「100ms 超」の件数として現れています。
  • REPACK (CONCURRENTLY) は同じ約1秒の実行中も更新が通り、最大遅延は 56〜66ms でした。
  • 整合性の確認として、実行後の sum(hits) と pgbench が報告した処理済みトランザクション数が全9回で一致しました(例:15,873 と 15,873)。CONCURRENTLY でも更新の取りこぼしや二重適用は見つかりませんでした。
  • どの方法でもテーブルは 270MB から 82MB になりました。

重要な限界として、この表は小さく、操作が約1秒で終わるため、ロックが止める時間も約1秒です。大きな表では差がもっと大きくなると考えられますが、私は測っていません。また、書き込みが多い本番の負荷や、レプリカを含む構成では確かめていません。

使えない条件(公式ドキュメントと実機の確認)

REPACK のリファレンスに CONCURRENTLY を使えない条件が列挙されています。そのうち次を実機で確かめました。

-- 主キーなし
ERROR:  cannot execute REPACK (CONCURRENTLY) on relation "nopk"
DETAIL:  Relation "nopk" has no identity index.

-- トランザクションブロック内
ERROR:  REPACK (CONCURRENTLY) cannot run inside a transaction block

-- UNLOGGED テーブル
ERROR:  cannot execute REPACK (CONCURRENTLY) on relation "ul"
DETAIL:  This operation is only supported for permanent relations.

-- max_repack_replication_slots = 0
ERROR:  REPACK can only be used if "max_repack_replication_slots" > 0

wal_level については、replica に設定して再起動しても REPACK (CONCURRENTLY) は成功しました。リリースノートに、wal_level が replica のときは必要に応じて論理デコードを自動で有効にし、実効値を effective_wal_level で確認できる、という趣旨の記載があります。この挙動とあわせて、logical に変更せずに使える可能性がありますが、私が確かめたのは effective_wal_level が replica と表示される状態で成功したところまでです。

ドキュメントには、このほか次の注意も書かれています(私は未検証です)。CONCURRENTLY は MVCC 安全ではなく、開始前のスナップショットを使う並行トランザクションからは、完了後にテーブルが空に見えることがあります。実行中に別のトランザクションが同じテーブルへ DDL を実行すると失敗することがあります。並行して更新・削除された行が約1億400万行を超えると失敗します。

なお、旧コマンドの VACUUM FULL と CLUSTER は引き続き使えました。

実験3:SQL/PGQ は 19 RC1 に入っていない

SQL/PGQ(SQL 標準のプロパティグラフクエリ)を 19 の機能として紹介する情報を見かけたため、RC1 で確かめました。

CREATE PROPERTY GRAPH g VERTEX TABLES (person);
ERROR:  syntax error at or near "PROPERTY"

SELECT * FROM GRAPH_TABLE (g MATCH (p IS person) COLUMNS (p.name));
ERROR:  syntax error at or near "MATCH"

RC1 のリリースノート原稿(doc/src/sgml/release-19.sgml)にも graph の語は1件もありませんでした。このバージョンでは SQL/PGQ は使えません。今後のバージョンで入るかどうかは、私は確認していません。紹介記事や動画の「19 に入る」という記述は、公式のリリースノートで確認してから信じるほうが安全です。

考察とハマりどころ

  • DO SELECT は get-or-create の読み取り専用版として使えますが、採番は消費されます。 既存の DO UPDATE SET x = EXCLUDED.x を置き換える場合の利点は、行バージョンと WAL が増えないこと、UPDATE トリガーが走らないことです。トリガーに依存した処理(更新日時の自動更新や監査ログ)が、これまで「衝突時に副作用として」走っていたなら、置き換えるとその副作用も消えます。
  • FOR UPDATE を付けた DO SELECT の挙動は、行ロックを取る前提の設計では別途確認が必要です。 私は FOR UPDATE 付きで構文が通り、行が返ることを確かめましたが、他セッションとの競合は検証していません。
  • REPACK (CONCURRENTLY) は「ロックゼロ」ではありません。 最後に ACCESS EXCLUSIVE ロックでファイルを入れ替えます。今回の最大遅延 56〜66ms は、その入れ替えの待ち時間を含む値です。長いトランザクションが残っているとこのロックの取得が待たされる可能性がありますが、今回は測っていません。
  • ディスク容量に余裕が必要です。 ドキュメントのとおり、REPACK は表と全索引の一時コピーを作るため、表と索引の合計サイズ分の空き容量が要ります。
  • Supabase など、マネージドの Postgres で使えるかは別の問題です。 この記事はセルフビルドの RC1 で確かめたもので、各サービスがいつ 19 に対応し、REPACK に必要な権限(MAINTAIN)や設定を開放するかは確認していません。

まとめ

PostgreSQL 19 RC1 では、ON CONFLICT DO SELECT が get-or-create の回避策を、行バージョンと WAL を増やさずに置き換えられ、REPACK (CONCURRENTLY) が小さな表では更新を止めずに肥大化を解消できました。採番の消費、トリガーの副作用の消失、主キー必須などの条件は、使う前に自分の環境で確かめてください。SQL/PGQ は RC1 には入っていません。数値はいずれも2026年10月18日時点の RC1 とこのサンドボックスでの結果で、正式版や本番環境で同じになるとは限りません。

参考資料

この記事は、AI エージェントによる調査・検証・下書きをもとに、筆者が内容を確認して公開しています。