UUIDとは
UUID(Universally Unique Identifier)は、550e8400-e29b-41d4-a716-446655440000 のような128ビット(16進数32桁)の識別子です。中央で番号を管理しなくても、世界中で重複しない ID を各自で作れるのが特徴です。Microsoft の環境では GUID とも呼ばれますが、同じものです。
v4 と v7 の違い
| バージョン | 中身 | 向いている用途 |
|---|---|---|
| v4 | 122ビットがランダム | 推測されたくない ID、一般的な用途 |
| v7 | 先頭48ビットがミリ秒単位の時刻+ランダム | データベースの主キー(作成順に並ぶ) |
| v1 | 時刻+MACアドレス | 古いシステム(MACアドレスが漏れるため非推奨) |
v4 は完全にランダムなため、データベースの主キーにするとインデックスの書き込み位置がばらつき、挿入性能が落ちることがあります。v7 は生成時刻の順に並ぶため、この問題を避けられます。v7 は2024年に RFC 9562 で標準化されました。
UUID v7 の中身と、時刻の取り出し方
v7 は 128 ビットを次のように使います(RFC 9562)。先頭の48ビットが UNIX時間(ミリ秒)なので、時刻順に並びます。
| ビット数 | 中身 |
|---|---|
| 48 | UNIX時間(ミリ秒) |
| 4 | バージョン(0111 = 7) |
| 12 | ランダム(または同じミリ秒内の連番) |
| 2 | バリアント(10) |
| 62 | ランダム |
時刻を取り出すには、ハイフンを除いた先頭12桁を16進数として読みます。RFC 9562 の例 017F22E2-79B0-7CC3-98C4-DC0C0C07398F なら、先頭12桁 017F22E279B0 は10進数で 1645557742000(ミリ秒)です。1000で割った 1645557742 を UNIX時間変換 に入れると、日本時間 2022-02-23 04:22:22 です。このページの「UUIDを判定する」に貼れば、自動で日時を表示します。
v4 と v7 のどちらを使うか
| 用途 | おすすめ | 理由 |
|---|---|---|
| データベースの主キー | v7 | 作成順に並び、インデックスの書き込みが一か所に集まる |
| URL などで外に見せる ID | v4 | ランダムなので、作成時刻や件数を推測されない |
| セッション・トークン | UUID ではなく暗号論的乱数 | UUID はもともと推測されない用途のために作られていない |
重複する可能性は?
v4 のランダム部分は122ビットあり、組み合わせは約5.3×1036通りです。1秒間に10億個を約85年間作り続けて、ようやく1組でも重複する確率が50%になる計算です。実用上は重複を心配する必要はありません。
各言語での生成方法
| 言語・環境 | コード |
|---|---|
| JavaScript | crypto.randomUUID() |
| Python | str(uuid.uuid4()) |
| Java | UUID.randomUUID() |
| PostgreSQL | gen_random_uuid() |
| MySQL | UUID()(v1) |
| Linux / macOS | uuidgen |
よくある質問
UUIDはパスワードやトークンに使えますか?
v4 は推測が困難ですが、用途によっては専用のトークン生成を使うべきです。v1 や v7 は時刻が含まれ一部を推測できるため、秘密の値には使わないでください。
大文字と小文字はどちらが正しいですか?
規格上は小文字で出力し、比較するときは大文字・小文字を区別しないことになっています。Windows のレジストリなど、大文字で表記される環境もあります。
v7 の UUID から作成日時がわかりますか?
わかります。上の「UUIDを判定する」に v7(または v1・v6)の UUID を貼り付けると、埋め込まれた生成日時を表示します。
UUID v7 は作成時刻が外に漏れますか?
漏れます。先頭48ビットが作成時刻なので、v7 を外部に公開する ID に使うと、いつ作られたかが誰でも読み取れます。作成時刻を隠したい場合は v4 を使うか、内部では v7、外部向けには別の ID を用意してください。