UUID生成(v4 / v7)

データベースの主キーやファイル名に使える UUID(GUID)を生成します。暗号論的に安全な乱数(crypto.getRandomValues)を使い、ブラウザ内で作成します。

UUIDを判定する

UUIDとは

UUID(Universally Unique Identifier)は、550e8400-e29b-41d4-a716-446655440000 のような128ビット(16進数32桁)の識別子です。中央で番号を管理しなくても、世界中で重複しない ID を各自で作れるのが特徴です。Microsoft の環境では GUID とも呼ばれますが、同じものです。

v4 と v7 の違い

バージョン中身向いている用途
v4122ビットがランダム推測されたくない ID、一般的な用途
v7先頭48ビットがミリ秒単位の時刻+ランダムデータベースの主キー(作成順に並ぶ)
v1時刻+MACアドレス古いシステム(MACアドレスが漏れるため非推奨)

v4 は完全にランダムなため、データベースの主キーにするとインデックスの書き込み位置がばらつき、挿入性能が落ちることがあります。v7 は生成時刻の順に並ぶため、この問題を避けられます。v7 は2024年に RFC 9562 で標準化されました。

UUID v7 の中身と、時刻の取り出し方

v7 は 128 ビットを次のように使います(RFC 9562)。先頭の48ビットが UNIX時間(ミリ秒)なので、時刻順に並びます。

ビット数中身
48UNIX時間(ミリ秒)
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 などで外に見せる IDv4ランダムなので、作成時刻や件数を推測されない
セッション・トークンUUID ではなく暗号論的乱数UUID はもともと推測されない用途のために作られていない

重複する可能性は?

v4 のランダム部分は122ビットあり、組み合わせは約5.3×1036通りです。1秒間に10億個を約85年間作り続けて、ようやく1組でも重複する確率が50%になる計算です。実用上は重複を心配する必要はありません。

各言語での生成方法

言語・環境コード
JavaScriptcrypto.randomUUID()
Pythonstr(uuid.uuid4())
JavaUUID.randomUUID()
PostgreSQLgen_random_uuid()
MySQLUUID()(v1)
Linux / macOSuuidgen

よくある質問

UUIDはパスワードやトークンに使えますか?

v4 は推測が困難ですが、用途によっては専用のトークン生成を使うべきです。v1 や v7 は時刻が含まれ一部を推測できるため、秘密の値には使わないでください。

大文字と小文字はどちらが正しいですか?

規格上は小文字で出力し、比較するときは大文字・小文字を区別しないことになっています。Windows のレジストリなど、大文字で表記される環境もあります。

v7 の UUID から作成日時がわかりますか?

わかります。上の「UUIDを判定する」に v7(または v1・v6)の UUID を貼り付けると、埋め込まれた生成日時を表示します。

UUID v7 は作成時刻が外に漏れますか?

漏れます。先頭48ビットが作成時刻なので、v7 を外部に公開する ID に使うと、いつ作られたかが誰でも読み取れます。作成時刻を隠したい場合は v4 を使うか、内部では v7、外部向けには別の ID を用意してください。