UUID生成ツール

UUID(Universally Unique Identifier。Microsoft製ソフトウェアではGUIDと呼ばれます)は128ビットの数値で、32桁の16進数を8-4-4-4-12の形に区切って表記します。例: f47ac10b-58cc-4372-a567-0e02b2c3d479。2005年にRFC 4122として標準化され、2024年5月にRFC 9562に置き換えられました。RFC 9562は従来のバージョンをそのまま残し、新たに3つのバージョンを追加しています。位置が固定されている箇所が2つあります。3番目のグループの先頭の桁がバージョン(4372の4)で、4番目のグループの先頭の桁がバリアントを示します。RFCに準拠するUUIDでは、この桁は必ず8、9、a、bのいずれかです。

バージョン4は、残りの122ビットをランダムなデータで埋めます。取りうる値の数が非常に大きいため、重複が1組でも出る確率が50%になるには、約2.7×10¹⁸(270京)個を生成する必要があります。そのため、複数のマシンが互いに調整せず、それぞれ独立にv4のIDを生成できます。このページではcrypto.randomUUIDを使い、利用できない環境ではcrypto.getRandomValuesを使います。出力が予測不能になるよう設計されていないMath.randomは使いません。大文字とハイフンなしのオプションが変えるのは表記だけで、値は同じです。ほとんどのパーサーは大文字・小文字のどちらも受け付けます。

バージョン1と6は、タイムスタンプとノードIDから作られます。ノードIDは元々コンピューターのMACアドレスで、IDがどこで、いつ作られたかが漏れてしまいます。バージョン3と5は、名前空間と名前をMD5またはSHA-1でハッシュするため、同じ入力からは常に同じUUIDが得られます。バージョン8は独自の方式向けに自由に構成できる形式です。中でも最も重要な新顔がバージョン7です。先頭に48ビットのUnixタイムスタンプ(ミリ秒)を置き、残りをランダムなビットで埋めるため、IDが作成時刻順に並びます。

この順序性こそ、データベースの主キーにv7を検討する理由です。ランダムなv4のキーはB-treeインデックスのあちこちに挿入されるため、テーブルが大きくなるとページ分割が起き、キャッシュの局所性も悪化します。一方v7のキーは、自動採番の列のようにおおよそ増加する順で入ってくるうえ、中央のカウンターなしで生成できます。作成時刻を含め何も明かさないIDが欲しい場合はv4を、挿入性能や時刻順が重要な場合はv7を選んでください。UUIDは識別子であり、秘密情報ではありません。パスワードやAPIシークレットには専用のパスワード生成をご利用ください。ほかのエンコーダーや検査ツールは開発者向けツールにあります。