{"canonical_url":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/","content_markdown":"# 成長するデータモデルの時系列順キー\n\nB‑treeインデックスの断片化を抑え、クエリを高速化するため、PostgreSQL 18の時系列順UUID v7をエンティティキーとして採用した。\n\n2025\n\n**状況.** 各エンティティには一意なIDが必要で、反射的にはランダムUUIDが選ばれる。しかしランダムIDはB‑treeの各所へ入り、挿入が散らばってインデックスが断片化し、テーブル増加とともに書き込みも範囲走査も不利になる。成長を続ける基盤へ、最初からその緩やかな損失を組み込むことは避けたかった。\n\n**課題.** UUIDの全体での一意性を保ちつつ、ランダムさによる断片化をなくす必要があった。\n\n**行動.** 先頭ビットが時刻で、新しい行がインデックスに散らばらず順に入るUUID v7を標準にした。PostgreSQL 18のネイティブuuidv7()を小さなuuid_generate_v7()で包み、Azure Flexible Serverでも同じ呼び出しを使えるようにした。スキーマ全体のエンティティ主キーの既定値とした。特殊な技術ではなく、早く決めれば安く、後付けでは難しい種類の判断だった。\n\n**結果.** UUID v7が設定上のキー規約となり、新しい識別子に時系列順の性質を持たせた。断片化の抑制とクエリ高速化は設計目標であり、この事例には同じ処理負荷での導入前後のベンチマークは記録されていない。\n\n---\n\n- 役割: データベースエンジニア\n- カテゴリー: [バックエンド開発](https://engineer.company/ja/categories/backend/), [データベース](https://engineer.company/ja/categories/databases/), [PostgreSQL](https://engineer.company/ja/categories/postgresql/), [データエンジニアリング](https://engineer.company/ja/categories/data-engineering/), [性能改善](https://engineer.company/ja/categories/performance/)\n- サービス: [データベース設計・モデリング](https://engineer.company/ja/services/database-design/), [データベース性能改善](https://engineer.company/ja/services/database-performance/)\n\n\u003chttps://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/\u003e\n","date_modified":"2026-11-15T19:47:44Z","description":"PostgreSQL 18で時系列順のUUID v7キーを採用し、B-treeの断片化を減らして、エンティティのテーブルへの挿入と範囲クエリを改善することを狙った。","formats":{"gemtext":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/index.gmi","gopher":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/gophermap","html":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/","json":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/index.json","markdown":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/index.md","pdf":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/index.pdf"},"kind":"page","language":"ja","title":"断片化抑制にUUID v7キーを採用","url":"https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/","version":1}