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

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

---

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

<https://engineer.company/ja/portfolio/quicker-answers-from-a-better-choice-of-key/>
