アイキャッチ画像: 稼働中の機器が並ぶデータセンターのサーバーラック。写真提供: 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アドレス | 時刻順 | レガシーシステム |
| 4 | 122ビットの乱数 | ランダム | ほとんどのアプリのデフォルト |
| 7 | Unixタイムスタンプ(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つあります。
- 大規模テーブルでの重いシーケンシャルスキャン。 UUIDは16バイト、
bigintは8バイト。数テラバイト級のテーブルではインデックスサイズの差がメモリとIOに効いてきます。 - 人間が入力・読み上げる識別子。 電話でUUIDを読み上げる人はいません。予約コード、注文番号、エラーコードは短く曖昧さがないべきです。
- アプリ層で作成時刻順にソートする設計。 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で完全に問題ありません——正しさと移植性は、挿入速度の最後の数パーセントより重要です。
| キー種別 | サイズ | 挿入性能 | 情報漏えい | 典型的な用途 |
|---|---|---|---|---|
| bigserial | 8B | 最良 | 作成順・規模 | 内部テーブル、小規模アプリ |
| UUID v4 | 16B | 良好(大規模で断片化) | なし | 公開ID、トークン、クライアント生成 |
| UUID v7 | 16B | ほぼシーケンシャル | 作成時刻のみ | データベース主キー |
UUIDへの移行:実践的な手順
新規テーブルなら答えは1行です。id uuid primary key default gen_random_uuid()。既存の bigserial テーブルの移行なら、答えは通常「移行しない」。動いている連番テーブルは動かし続けるのが正しく、移行リスクは外部キーと「整数である」と仮定したアプリケーションコードに集中します。多くのシステムが採用する現実的な中間解——外部APIではUUIDを公開しつつ内部は整数のまま——は、追加型の移行です:
- UUIDカラムを追加(
uuid型、NULL許容、デフォルトなし)を既存IDの隣に - バックフィル
UPDATE ... SET uuid = gen_random_uuid() WHERE uuid IS NULLをバッチ化して長いロックを回避 - 一意インデックスを追加し、カラムを
NOT NULLにして新規行用のサーバー側デフォルトを設定 - APIではUUIDを公開し、外部キーは内部的に整数IDを参照し続ける。外部システムは安定した不透明な識別子を見て、内部結合は高速なまま
- 必要な場合のみ、後の個別にテストした移行で外部キーを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() |
| Python | uuid.uuid4() / uuid.uuid7()(3.14+) |
| Go | github.com/google/uuid — uuid.New() |
| Java | java.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 v4 | 128ビット、16進数 | 不可 | ランダム | 公開ID、トークン |
| UUID v7 | 128ビット、16進数 | 可(ms) | ランダム+時刻 | DB主キー |
| ULID | 128ビット、Crockford base32 | 可(ms) | ランダム+時刻 | ログ、短いソート可能ID |
| NanoID | 126ビット、URL用アルファベット | 不可 | ランダム | 短い不透明ID |
| ObjectId | 96ビット、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月時点の上流ドキュメントに基づきます。
