UUID v7ジェネレーター
RFC 9562で定義されたUUIDバージョン7の識別子を生成します。48ビットのUnixタイムスタンプ(ミリ秒単位)の後にランダムビットが続くため、新しいIDは作成時刻順に並び、データベースのインデックスをコンパクトに保てます。一度に最大100個を順番に、標準の小文字形式、大文字、波括弧付き、URN形式、またはハイフンなしで作成できます。
よくある質問
UUID v7とは何ですか?
UUIDバージョン7は、2024に公開されたRFC 9562の128ビット識別子です。先頭の48ビットはミリ秒単位のUnix時刻で、その後にバージョンビットとバリアントビット、ランダム性と順序付けのための74ビットが続きます。ほかのUUIDと同じ形式で、たとえば018f3c9e-7a2b-7c4d-9e5f-1a2b3c4d5e6fのように表されます。3番目のグループの先頭にある7がバージョンを示します。
v4の代わりにv7を使う理由は何ですか?
v4 UUIDは完全にランダムなため、新しい行はデータベースインデックスのランダムな位置に追加されます。その結果、インデックスが断片化し、挿入が遅くなります。v7 UUIDは時刻から始まるため、新しいIDはインデックスの末尾近くに追加され、作成時刻順に並びます。また、別途created_at列を用意せずに比較できます。
生成されたIDは順番に並びますか?
はい。同じバッチで生成されたIDは、RFC 9562の仕様どおり、現在のミリ秒のタイムスタンプと、IDごとに増加する12ビットのカウンターを共有するため、リストはすでに並び替えられています。カウンターがあふれる場合は、タイムスタンプが1ミリ秒進みます。
どれくらいランダムですか?
カウンターはランダムな値から始まり、下位62ビットはIDごとに暗号学的に安全な乱数生成器から取得されます。異なるマシンで同じミリ秒に作成された2つのUUIDも、実用上、確実に異なる値になります。
v7 UUIDから作成時刻がわかりますか?
はい。ミリ秒単位でわかります。IDを見た人は、たとえばUUIDデコーダーを使って作成時刻を読み取れます。作成時刻を非公開にする必要がある識別子にはv4を使ってください。
利用できる出力形式は何ですか?
標準の小文字とハイフン付き、大文字、Microsoftのツールでよく使われる波括弧付き、urn:uuid:で始まるURN形式、そして32桁の16進数で表すハイフンなしのコンパクト形式を利用できます。
データベースはUUID v7に対応していますか?
UUIDを保存する列ならどれでもv7を受け付けます。形式は同じ128ビットです。PostgreSQL 18ではuuidv7()関数が追加され、ほとんどの言語向けのライブラリで生成できます。サイズを小さく保つには、ネイティブのUUID型または16バイトのバイナリ列に保存してください。
一度に何個のUUIDを生成できますか?
1回のリクエストで最大100個まで生成できます。さらに必要な場合は再度生成してください。タイムスタンプが進むため、後のリクエストで生成されたIDは必ず先のリクエストのIDより後に並びます。
UUID v7はULIDと同じですか?
どちらもミリ秒単位のタイムスタンプにランダム値が続く仕組みで、時刻順に並びます。ULIDはCrockford Base32の26文字で表されます。一方、UUID v7はバージョンビットとバリアントビットを含む標準のUUIDレイアウトを使うため、すでにUUIDを受け付けるすべてのシステムで利用できます。
UUIDはどこかに保存されますか?
いいえ。リクエストに応じて生成され、保存されることはありません。