アイキャッチ画像: 稼働中の機器が並ぶデータセンターのサーバーラック。写真提供: Cookiecutter(Pexels、無料利用可)

あらゆるシステムのあらゆるレコードには、衝突せず、中央の管理台帳を必要とせず、必要以上に情報を漏らさない「名前」が必要です。UUIDはその名前です。任意のマシンが、いつでも、誰にも断らず独立に発行できる128ビットの識別子。現代の分散システムのデフォルト主キーであり、データベース、ログ、APIレスポンス、モバイルプッシュ通知で目にするIDの土台となっています。

本ガイドでは、UUIDの構造、バージョンごとの違い、実践的な選び方を解説します。いますぐUUIDを生成したい方は、無料のUUIDジェネレーターをご利用ください——完全にブラウザ内で動作します。

UUIDの構造

UUIDは128ビットの値で、慣例的に5つのグループ・36文字で表記されます。xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。バージョンは第3グループの13桁目の16進数にエンコードされており、...-4xxx-... はバージョン4、...-7xxx-... はバージョン7を意味します。形式は RFC 4122(2005年)で定義され、RFC 9562(2024年)でバージョン6・7・8が追加されました。

実際に使われているバージョン:

バージョン生成方法ソート順典型的な用途
1タイムスタンプ+MACアドレス時刻順レガシーシステム
4122ビットの乱数ランダムほとんどのアプリのデフォルト
7Unixタイムスタンプ(ms)+乱数時刻順データベース主キー

バージョン3・5(名前ベース、MD5/SHA-1)は目的が異なります。名前から決定的なUUIDを導出するため、同じ入力からは常に同じIDが得られます。コンテンツアドレッシングには有用ですが、エンティティごとの一意性が必要なレコードにはほぼ使われません。

v4:ランダムのデフォルト

バージョン4は128ビットのうち122ビットをランダムに設定します。取りうる値は2¹²²通り——およそ5.3 × 10³⁶。衝突の計算式は覚えておく価値があります。古くからの心配を一掃してくれるからです。毎秒10億個のUUIDを生成し続けても、衝突確率が50%に達するまで約8,500万年かかります。ランダムUUIDは実際には衝突しません。失敗するのは土台の乱数生成器が弱い場合だけで、それがUUIDジェネレーターが Math.random() ではなくWeb Crypto API(crypto.randomUUID / crypto.getRandomValues)を使う理由です。

v4が正しいデフォルトになるケース:

  • APIトークンやセッションID — ランダム性が作成順を隠すため、アカウントやセッションの作成時期がIDから漏れません
  • クライアント生成ID — オフラインでレコードを作るモバイルアプリやブラウザには、サーバー往復なしで発行できるIDが必要です
  • 公開されるID — URL内の連番IDはサービス規模を暴露しますが、v4 UUIDは何も暴露しません

v7:データベース向けのアップグレード

v4の弱点はデータベースの中で現れます。ランダムIDが主キーになると、行がインデックスのランダムな位置に挿入されます。主キーインデックスがBツリーであるPostgreSQLやInnoDB(MySQL)では、ランダムな挿入順はインデックスを断片化し、書き込み増幅を増やし、大規模になると挿入を測定可能なほど遅くします。UUIDv7は上位ビットにミリ秒単位のUnixタイムスタンプを置くことでこれを解決します。時間的に近いIDはソート順でも近くなり、挿入がインデックスの末尾に集中——ほぼシーケンシャルな書き込み性能を、UUIDの一意性を保ったまま実現します。

2026年の実践的な指針:新しいデータベースの主キーにはサーバー側でv7を使う。PostgreSQLは gen_random_uuid()(最近のバージョンではデフォルトでv7を返します)や uuid-ossp 拡張の uuidv7() でネイティブ生成できます。フレームワークがv7未対応ならv4で構いません——性能差が問題になるのは数百万行の規模であって数千行ではなく、早すぎる最適化よりスキーマの正しさの方が価値があります。

UUIDを使うべきでない場面

UUIDは無料ではありません。コストは実在し、別の識別子が勝つ場面が3つあります。

  1. 大規模テーブルでの重いシーケンシャルスキャン。 UUIDは16バイト、bigint は8バイト。数テラバイト級のテーブルではインデックスサイズの差がメモリとIOに効いてきます。
  2. 人間が入力・読み上げる識別子。 電話でUUIDを読み上げる人はいません。予約コード、注文番号、エラーコードは短く曖昧さがないべきです。
  3. アプリ層で作成時刻順にソートする設計。 IDの順序に依存するクエリがあるならv4よりv7を。あるいは created_at カラムを追加して、IDから順序を導くのをやめましょう。

AI/LLMスタックにおけるUUID

UUIDは現代のAIインフラの至る所に登場します。知っておくべき3つのパターン:

冪等性キー。 Stripe流のAPIはリクエストごとにクライアント生成のUUIDを受け取り、リトライで二重課金が起きないようにします。LLMプラットフォームも同じパターンです。リクエストごとにUUIDを生成すれば、ネットワークリトライが安全になります。

ランID・トレースID。 LangChain/OpenTelemetry流のトレース、エージェントの実行、バッチジョブはすべてUUIDを持ちます。分散トレーシングは、サービスをまたいでこれらのIDを照合するだけでログをつなぎ合わせます。

バッチファイルのキー。 OpenAI互換のバッチジョブはファイルやジョブをプラットフォーム生成のIDで参照します。自前パイプラインを組むなら、ジョブIDにv4 UUIDを発行すれば並行ワーカーが衝突しません。

上記すべてに、UUIDジェネレーターがRFC 9562準拠のv4 IDを一括生成します——テストデータの投入、フィクスチャ作成、一度に大量のIDが必要なペイロード構築に便利です。JSONフォーマッターと組み合わせて、IDを整形式のリクエスト本文に組み立てましょう。

全バージョン一覧:1・3・5・6・8——なぜほとんど使われないか

仕様には8つのバージョンが存在しますが、実際に使われるのは4つ。残りも、現場で見分けられるように知っておく価値があります:

  • v1(時刻+MAC): オリジナル。タイムスタンプとマシンのMACアドレスから生成。時刻順ですが、生成マシンのネットワークIDが漏れる——後のバージョンを生んだプライバシー上の欠陥です。古いJavaやSQL Serverのシステム(newsequentialid() はv1の変種)で今も見かけます。
  • v3/v5(名前ベース): 名前空間(DNS、URL、OID、X.500)内の名前から導出される決定的UUID。同じ入力からは永遠に同じ出力。新規用途ではv3(MD5)よりv5(SHA-1)を選びます。最大の用途はコンテンツアドレッシングと重複排除——同一入力を同一IDに対応付けたい場面です。
  • v6(v1の並び替え): v1のタイムスタンプの意味論を保ちつつ、ソートしやすいようビットを並べ替えたもの。実用上はv7が取って代わり、ほぼ使われません。
  • v7(時刻+乱数): 前述の現代の主力。ミリ秒精度によりIDが作成順にソートされ、データベースが喜びます。
  • v8(ベンダー独自): バージョンニブルだけ固定されたカスタム形式。シャードIDやリージョンコードなど、独自の意味論を標準準拠の殻の中に埋め込みたいときに使います。
  • v2(DCEセキュリティ): ローカルドメインとUIDを含む歴史的なもの。実質的に廃止されています。

決定木は実務上2分岐に収束します。クライアント側とセキュリティ重視の識別子はv4、サーバー側のデータベースキーはv7。 それ以外はすべてニッチです。

UUIDの性能:神話と測定

UUIDについては2つの言説が流布しています。1つは真実、1つは誇張です:

真実の側:ランダム主キーはインデックスを断片化する。 Bツリーインデックスはページをソート済みに保つため、ランダムなキーの挿入はランダムなページに落ち、ページ分割と不均一な成長を引き起こします。効果は大規模になると測定可能で——公開ベンチマークでは、UUIDv4の挿入スループットは数千万行規模で連番キーを大きく下回り、UUIDv7は bigserial の数パーセント以内に収まります。メカニズム自体に異論はなく、差が出るのは規模だけです。

誇張の側:UUIDはクエリを劇的に遅くする。 主キーによるポイント検索では、16バイトのUUIDと8バイトのbigintの差は小さい。実際のコストは3箇所に現れます:インデックスサイズ(バイト数2倍)、非常に幅の広いテーブルでの結合性能、書き込み集中負荷での挿入スループット。テーブルが100万行でトラフィックが中程度なら、v4で完全に問題ありません——正しさと移植性は、挿入速度の最後の数パーセントより重要です。

キー種別サイズ挿入性能情報漏えい典型的な用途
bigserial8B最良作成順・規模内部テーブル、小規模アプリ
UUID v416B良好(大規模で断片化)なし公開ID、トークン、クライアント生成
UUID v716Bほぼシーケンシャル作成時刻のみデータベース主キー

UUIDへの移行:実践的な手順

新規テーブルなら答えは1行です。id uuid primary key default gen_random_uuid()。既存の bigserial テーブルの移行なら、答えは通常「移行しない」。動いている連番テーブルは動かし続けるのが正しく、移行リスクは外部キーと「整数である」と仮定したアプリケーションコードに集中します。多くのシステムが採用する現実的な中間解——外部APIではUUIDを公開しつつ内部は整数のまま——は、追加型の移行です:

  1. UUIDカラムを追加(uuid 型、NULL許容、デフォルトなし)を既存IDの隣に
  2. バックフィル UPDATE ... SET uuid = gen_random_uuid() WHERE uuid IS NULL をバッチ化して長いロックを回避
  3. 一意インデックスを追加し、カラムを NOT NULL にして新規行用のサーバー側デフォルトを設定
  4. APIではUUIDを公開し、外部キーは内部的に整数IDを参照し続ける。外部システムは安定した不透明な識別子を見て、内部結合は高速なまま
  5. 必要な場合のみ、後の個別にテストした移行で外部キーをUUIDに切り替える

この「内部は整数、外部はUUID」パターンは、API設計より先に育ったシステムの標準解です。スキーマ変換のインデックスコストを払わずに、v4のセキュリティ特性を得られます。

現場のUUID:URL・ログ・すべての言語

URL。 UUIDは設計上URLセーフです——16進数とハイフンだけで、パーセントエンコードが必要な文字を含みません。RESTパス(/users/019b2f1a-...)、クエリパラメータ、署名付きリンクに登場します。身につけるべき習慣は1つ:どこでも正規形の小文字を使うこと。大文字小文字の混在は技術的には同一ですが、素朴な等価チェックやキャッシュキーを壊します。

ログとトレーシング。 分散システムにおけるUUIDの第二の人生は相関IDです。リクエストのエッジで同じIDを生成し、全サービスに引き回せば、12個のログストリームを横断する1回のgrepで1ユーザーの旅路を再構成できます。OpenTelemetryはこれをトレースIDとして形式化しています——128ビット、UUIDと同じサイズで、(W3C Trace Context標準では)v4と密接に関連する形式です。まだトレーシングがなければ、リクエストごとにv4 UUIDを生成して全サービスでログするだけでも、5%のコストで80%の価値が得られます。

すべての言語に生成器が同梱。 2026年、これはライブラリ不要です:

言語ワンライナー
JavaScript(ブラウザ/Node 20+)crypto.randomUUID()
Pythonuuid.uuid4() / uuid.uuid7()(3.14+)
Gogithub.com/google/uuid — uuid.New()
Javajava.util.UUID.randomUUID()
SQL(PostgreSQL)gen_random_uuid()

v7に限って言えば:Python 3.14が uuid.uuid7() を追加し、最近のPostgreSQLは gen_random_uuid() がv7を返し、GoとJavaは標準のサードパーティライブラリが必要です。UUIDジェネレーターはv4を一括生成します——何も明かさないIDを素早く必要なときの選択肢です。

v5による決定的ID。 コンテンツアドレッシングのシステムから盗む価値のあるパターンが1つあります。文書ごとにランダムIDを保存する代わりに、uuid5(NAMESPACE_URL, canonical_url) を計算する——同じURLは、どのマシンでも、永遠に同じIDを生みます。重複排除はただで付いてきます。「この文書を見たことがあるか」が「このIDが存在するか」に変わります。コンテンツのフィンガープリント、キャッシュキー、冪等インポート——同一入力に同一IDを対応付けたい場面すべてに使えます。

UUIDのセキュリティ上の注意点

UUIDはセキュリティ機構ではありませんが、正しく選ぶことはセキュリティの一部です:

推測不能性だけに安全性を依存させない。 v4 UUIDは実用上推測不能です——しかしそれは識別子であって秘密ではありません。「クライアントがUUIDを知っている」ことを認可として扱うAPIは、ログ、リファラーヘッダー、ブラウザ履歴経由の列挙と漏えいに対して脆弱です。不透明なIDには必ず本来の認可チェックを組み合わせましょう。UUIDが防ぐのは推測だけであり、推測は最も弱い攻撃です。

連番や導出可能なIDを公開しない。 この分野の古典的脆弱性がIDOR(安全でない直接オブジェクト参照)です。/invoices/1042 は数字を増やすだけの列挙を招きますが、/invoices/<v4-uuid> は列挙を実行不可能にします。これが公開APIでUUIDを使う最も強い実務上の理由であり、v1のMACアドレス漏えいが後のバージョンを動機づけるほど重大だった理由でもあります。

暗号学的に安全な生成器を使う。 Math.random() は識別子には不十分です——一部のブラウザ実装では出力が実用上予測可能でした。crypto.randomUUID() と crypto.getRandomValues() を使いましょう。サーバー側も同じルールです:プラットフォームのCSPRNGを使い、汎用乱数関数は使わない。

UUIDに秘密や余計な意味を詰め込まない。 v4のランダムビットは122ビットで固定です。ユーザーIDやタイムスタンプを詰め込むと、安全性の源であるランダム性が減ります。意味論を埋め込みたいなら意図的にv7(タイムスタンプ)やv8(ベンダー定義)を使うか、別フィールドに分けましょう。

UUIDが登場してはいけない場所。 IDそのものが所持証明になる場面——パスワードリセットトークン、ワンタイムダウンロードリンク、APIシークレット——は、レコード識別子の形式をしていない大きな乱数(256ビットトークン)を使うべきです。UUIDは「私はIDです」と世界に宣言しますが、リセットトークンはそう宣言すべきではありません。

UUID vs ULID vs NanoID vs ObjectId

UUIDが唯一の選択肢ではありません。4つの代替形式が常に登場し、違いが小さいため選び間違えやすいのが実情です:

形式サイズ/アルファベットソート可能衝突モデル最適な用途
UUID v4128ビット、16進数不可ランダム公開ID、トークン
UUID v7128ビット、16進数可(ms)ランダム+時刻DB主キー
ULID128ビット、Crockford base32可(ms)ランダム+時刻ログ、短いソート可能ID
NanoID126ビット、URL用アルファベット不可ランダム短い不透明ID
ObjectId96ビット、16進数可(秒)時刻+カウンタ+ランダムMongoDBデフォルト

実践的な判断ルール:

  • ULIDは本質的にUUID v7をより高密度で読みやすい表記にしたもの(26文字、大文字小文字を区別せず、テキストとしてソート可能)。人がログやチケットでIDを読む場面で、別カラムなしに時刻順が欲しいならULID
  • NanoIDはコンパクトさとURL親和性で勝ちます——紛らわしい文字(0/O/1/l/I)をアルファベットから除外。短いコード、共有リンク、36文字のUUIDが重く感じるユーザー向けの場面に
  • ObjectIdはMongoDBの12バイト形式:4バイト時刻、5バイトランダム、3バイトカウンタ。MongoDBで暮らすならこれを使い、移植性を設計するならv7を
  • UUID v7はリレーショナルDBの最良デフォルトであり続けます:標準化され、2026年時点で広くサポートされ、UUIDツールのエコシステムと相互運用できます

正直なまとめ:不透明さならv4、DBキーならv7、読みやすいログならULID、短いリンクならNanoID。4形式4用途、そして最も手が伸びる1つにジェネレーターがあります。

よくある質問


バージョン詳細はRFC 9562(2024年)に基づく。PostgreSQLのgen_random_uuid()の挙動は2026年11月時点の上流ドキュメントに基づきます。