Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
PostgreSQL 18で考えるUUID主キー
Search
Kazuhiro Seo
July 26, 2026
Programming
520
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
PostgreSQL 18で考えるUUID主キー
Kazuhiro Seo
July 26, 2026
More Decks by Kazuhiro Seo
See All by Kazuhiro Seo
GitHub ActionsとAWSをOIDC認証で連携する
kazuhiro1982
1
230
Gradleとちょっと仲良くなろう
kazuhiro1982
0
130
JavaとWebAssembly
kazuhiro1982
0
160
SpringBoot 3.0 のNative Imageを試してみた
kazuhiro1982
0
460
セッションデータの管理にSpring Sessionを利用する
kazuhiro1982
0
3.6k
AWSのLake Formation Governed Tablesを触ってみた
kazuhiro1982
0
460
VS CodeとRemote Containerで開発環境もコード管理しよう
kazuhiro1982
1
770
SpringBootをコンテナで動かしてみる
kazuhiro1982
0
440
Serverless FrameworkでWebサイトの更新を検知して通知する
kazuhiro1982
0
540
Other Decks in Programming
See All in Programming
片田舎のおっさん、 Swift Buildのダイアモンド問題解決の不具合修正PRを出すが、解決方法がキャッシュをしないようにすることであり、ビルド時間が伸びると言われてマージされないので高速化もする/swiftbuild
yimajo
0
360
AIの中の人になってみる
htkym
0
160
FDEとは、何者なのか?
masapyon1212
0
140
GraphRAGのKnowledge Graphを 直接!見る/View-GraphRAG's-KnowledgeGraph-directly!
tyumugi1113
0
220
Gmail/Google DriveをトリガーにAIエージェントを動かそう! / Run AI agents with Gmail/Google Drive as triggers!
har1101
3
460
Seeing Through Serverless: Observability for AWS Lambda with ADOT and CloudWatch Application Signals
seike460
PRO
1
120
XHTMLが残したもの
yosuke_furukawa
PRO
1
390
まだ間に合う!今年の夏こそSchemeのマクロ展開器を完全理解!
omasanori
0
630
Kiroで創り、AgentCoreで繋ぐ!AWSで実践する「AI-DLC」から「AIエージェント統合」までの最新地図
licux
2
310
「つくるAI」だけではバグは見つからない ~テストに必要な「見つけるAI」を分離させる戦略~
mfunaki
0
230
Pythonの実行はどこまで賢くなったのか? CPythonとPyPyから見る最適化のしくみ
curekoshimizu
4
2.8k
初めての模倣学習とVLA
natsutan
0
470
Featured
See All Featured
Leadership Guide Workshop - DevTernity 2021
reverentgeek
1
360
Odyssey Design
rkendrick25
PRO
2
800
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
35
2.6k
Breaking role norms: Why Content Design is so much more than writing copy - Taylor Woolridge
uxyall
1
390
Navigating Team Friction
lara
192
16k
Exploring anti-patterns in Rails
aemeredith
3
490
The Power of CSS Pseudo Elements
geoffreycrofte
82
6.5k
Designing Powerful Visuals for Engaging Learning
tmiket
1
530
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
234
17k
How to optimise 3,500 product descriptions for ecommerce in one day using ChatGPT
katarinadahlin
PRO
2
3.8k
Money Talks: Using Revenue to Get Sh*t Done
nikkihalliwell
0
490
Building an army of robots
kneath
306
46k
Transcript
PostgreSQL 18で考える UUID主キー v4とv7でインデックスの動きはどう変わるか root internal PostgreSQL 18で考えるUUID主キー internal internal
internal internal
自己紹介 妹尾 一弘 株式会社カオナビ サーバーサイドエンジニア JavaDoの方から来ました PostgreSQL 18で考えるUUID主キー
Agenda 最新のPostgreSQL 18でUUID v7が標準関数として導入 UUIDは主キーに向いている? UUID v4は性能に課題があるとされる UUID v7で改善するらしい [デモ]
インデックスの内部の動作の違いを可視化してみる PostgreSQL 18で考えるUUID主キー
PostgreSQL 18でUUID v7が標準関数になった select uuidv4(); select uuidv7(); -- UUIDからtimestampを抽出 select
uuid_extract_timestamp(uuidv7()); -- UUIDからversionを抽出 select uuid_extract_version(uuidv7()); PostgreSQL 18で考えるUUID主キー
UUIDとは Universally Unique Identifier どこで誰が生成しても、重複が事実上ほぼ発生しないID 019f55b0-69ab-7f6e-907f-d3c0d448b852 分散システムなどで重宝する 推測困難性を利用するためにも用いられる IDが予測しやすいと総当り攻撃などのリスクが上がる https://example.com/app/users/02
https://example.com/app/users/03 ※ UUIDで完全に攻撃を防げるわけではない PostgreSQL 18で考えるUUID主キー
UUIDはDBの主キーとしてそのまま使えるのか 観点 bigint identity キー幅 8 bytes 16 bytes 生成場所
DB中心 DB/アプリ 外部公開 推測されやすい 推測されにくい 挿入順 ほぼ単調増加 v4: ランダム / v7: 時刻順 主な価値 DB効率 分散生成・統合 PostgreSQL 18で考えるUUID主キー UUID
UUID v4を主キーに用いた時の課題 値のランダム性が強いため、 INSERT先のインデックスが分散する 多くのleaf pageを触る キャッシュが効きにくい ページ分割が散る インデックスが膨らむ PostgreSQL
18で考えるUUID主キー
UUID v4はランダム、 UUID v7は時刻順に近い UUID v4 UUID v7 基本はランダム 先頭にUnix
epochミリ秒 生成時刻を持たない 時刻順に近く並ぶ 推測困難性が高い DBのキー順に局所性が出る DBのキー順は散る 作成時刻の露出には注意 PostgreSQL 18で考えるUUID主キー
UUID v7は先頭48bitにUnix epochミリ秒を持つ unix_ts_ms 48 bits ver 4 rand_a 12
bits var 2 先頭が時刻なので、 B-treeのキー順として 「新しい IDほど右側」に寄りやすい PostgreSQL 18で考えるUUID主キー rand_b 62 bits
PostgreSQLの主キー B-treeではleaf pageが観測単位になる root INSERT時の流れ internal internal internal internal internal
キーが入るleaf pageを探す 空いていれば追加する 満杯ならsplitする 1つのleaf pageに複数のインデックス情報が格納される ※ デフォルトで8kB PostgreSQL 18で考えるUUID主キー
leaf pageへのアクセスが増えると性能に響きやすい キャッシュ効率 dirty page index size 局所性 拡散 肥大化
同じページを触るほど共 有バッファに残りやすい 広範囲を少しずつ汚すと 書き戻し対象も散る 分割と空き領域が増える と同じ行数でも大きくな る PostgreSQL 18で考えるUUID主キー
デモ: pageinspectでleaf pageを定点観測 PostgreSQL 18.4 / Docker uuidv4() と uuidv7()
の2テーブル 50,000行、1,000行ごとにスナップショット pageinspectのbt_page_stats()でページ情報を取得 PostgreSQL 18で考えるUUID主キー
実測では v7が触るleaf pageはかなり少なかった 指標 UUID v4 UUID v7 平均 更新ページ数
/ 回 126.92 4.82 最大 更新ページ数 / 回 266 5 leaf page数 276 192 平均 充填率 62.80% 89.89% インデックスサイズ 2.17 MiB 1.52 MiB レコード数 / 秒 510k 559k このデモでは、 v7は右端付近の数ページだけを触り続けた PostgreSQL 18で考えるUUID主キー
v4は散る、 v7は右端に寄る UUID v4 UUID v7 既存leaf pageの広い範囲が変化 leaf densityが下がる
index sizeが大きくなる 右端付近の少数leaf pageに集中 leaf densityが高い index sizeが小さくなりやすい 大規模化するとキャッシュ効 率に響きやすい UUIDの利便性とB-tree局所性を 両立しやすい PostgreSQL 18で考えるUUID主キー
結論: UUID v7は主キー候補として現実的な選択肢 採用しやすい UUIDを主キー・公開IDにしたい DB外でIDを生成したい UUID v4のランダム挿入が気になる 生成時刻の露出を許容できる 慎重に見る
DB性能とサイズ効率が必要 FK/JOINが非常に多い 生成時刻の露出が問題 単一DB中心ならbigint、UUIDが必要ならv7を第一候補にする。 PostgreSQL 18で考えるUUID主キー
まとめ PostgreSQL 18でuuidv7()を標準関数として試しやすくなった v4とv7の違いは、主キーB-treeのleaf page局所性に現れる 実測ではv7の更新対象leaf pageが大幅に少なかった UUIDを使いたい新規設計では、v7をまず検討する価値がある PostgreSQL 18で考えるUUID主キー
ありがとうございました PostgreSQL 18で考えるUUID主キー
APPENDIX 補足: 検証用テーブル定義 CREATE UNLOGGED TABLE v7_events ( id uuid
PRIMARY KEY DEFAULT uuidv7(), insert_no bigint NOT NULL, payload text NOT NULL ); PostgreSQL 18で考えるUUID主キー
APPENDIX 補足: pageinspectで見ているもの 列 意味 デモでの用途 blkno 物理ブロック番号 ページ識別 live_items
ページ内アイテム数 変化検知 free_size 空き領域 充填率 btpo_prev / next leaf pageリンク B-tree論理順 PostgreSQL 18で考えるUUID主キー
APPENDIX 補足: 今回のデモの制限 ローカルDocker環境なので、絶対性能の結論ではない WAL量、checkpoint、shared_buffers、並列INSERT競合は深掘りしていない 簡易B-tree図は親子関係を厳密に再構築していない 本番採用前には実データ量・並列度・インデックス構成で再測定する PostgreSQL 18で考えるUUID主キー
REFERENCES 参考資料 PostgreSQL 18 Documentation: UUID Functions RFC 9562: Universally
Unique IDentifiers PostgreSQL Documentation: pageinspect https://www.postgresql.org/docs/18/functions-uuid.html https://www.rfc-editor.org/rfc/rfc9562.html https://www.postgresql.org/docs/current/pageinspect.html PostgreSQL 18で考えるUUID主キー