# 成長するデータモデルの時系列順キー

B‑treeインデックスの断片化を抑え、クエリを高速化するため、PostgreSQL 18の時系列順UUID v7をエンティティキーとして採用した。

2025

状況. 各エンティティには一意なIDが必要で、反射的にはランダムUUIDが選ばれる。しかしランダムIDはB‑treeの各所へ入り、挿入が散らばってインデックスが断片化し、テーブル増加とともに書き込みも範囲走査も不利になる。成長を続ける基盤へ、最初からその緩やかな損失を組み込むことは避けたかった。

課題. UUIDの全体での一意性を保ちつつ、ランダムさによる断片化をなくす必要があった。

行動. 先頭ビットが時刻で、新しい行がインデックスに散らばらず順に入るUUID v7を標準にした。PostgreSQL 18のネイティブuuidv7()を小さなuuid_generate_v7()で包み、Azure Flexible Serverでも同じ呼び出しを使えるようにした。スキーマ全体のエンティティ主キーの既定値とした。特殊な技術ではなく、早く決めれば安く、後付けでは難しい種類の判断だった。

結果. UUID v7が設定上のキー規約となり、新しい識別子に時系列順の性質を持たせた。断片化の抑制とクエリ高速化は設計目標であり、この事例には同じ処理負荷での導入前後のベンチマークは記録されていない。

役割: データベースエンジニア
=> /ja/categories/backend/ カテゴリー: バックエンド開発
=> /ja/categories/databases/ カテゴリー: データベース
=> /ja/categories/postgresql/ カテゴリー: PostgreSQL
=> /ja/categories/data-engineering/ カテゴリー: データエンジニアリング
=> /ja/categories/performance/ カテゴリー: 性能改善
=> /ja/services/database-design/ サービス: データベース設計・モデリング
=> /ja/services/database-performance/ サービス: データベース性能改善

=> https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/ このページのウェブ版
