UUID生成ツール & デコーダー

UUIDとは？

// Generate a UUID v4 using the Web Crypto API
const uuid = crypto.randomUUID();
console.log(uuid);
// → '550e8400-e29b-41d4-a716-446655440000'

// Manual v4 generation with crypto.getRandomValues()
function generateUUIDv4() {
  const bytes = new Uint8Array(16);
  crypto.getRandomValues(bytes);
  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
  bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant 10
  const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
  return `${hex.slice(0,8)}-${hex.slice(8,12)}-${hex.slice(12,16)}-${hex.slice(16,20)}-${hex.slice(20)}`;
}

主な機能

UUIDバージョン比較

用途に合わせて最適なUUIDバージョンを選択してください。

UUID vs その他のIDフォーマット

UUIDバージョンの例

550e8400-e29b-41d4-a716-446655440000

01906b5e-4a3e-7234-8f56-b8c12d4e5678

6ba7b810-9dad-11d1-80b4-00c04fd430c8

886313e1-3b8a-5372-9b90-0c9aee199e5d

使い方

1. 1

   UUIDバージョンを選択

   v1（タイムスタンプベース）、v3（MD5名前ベース）、v4（ランダム）、v5（SHA-1名前ベース）、v7（時間順ランダム）から選択します。各バージョンには異なる用途があり、v4が汎用的に最もよく使われます。

2. 2

   オプションを設定

   v3およびv5では、名前空間（DNS、URL、OID、X.500、またはカスタム）を選択し、ハッシュ化する名前を入力します。生成数を1〜50で設定し、出力形式を選択します：標準小文字、大文字、ハイフンなし、または中括弧 {GUID}。

3. 3

   UUIDを生成

   「UUID生成」ボタンをクリックします。各UUIDはWeb Crypto API（crypto.getRandomValues()）を使用して暗号学的に安全に生成されます。バージョン固有のフィールド（v1/v7のタイムスタンプ、v3/v5のハッシュ値）は正しくエンコードされます。

4. 4

   コピーして使用

   各UUIDの横にある「コピー」ボタンでクリップボードにコピーするか、「すべてコピー」で生成されたすべてのUUIDを一括コピーできます。「デコード」タブに切り替えると、既存のUUIDのバージョン、バリアント、タイムスタンプなどの埋め込み情報を分析できます。

主なユースケース

データベース主キー

データベースノード間の調整なしに、UUID v4またはv7をユニークな主キーとして使用できます。UUID v7は時間順の特性によりB-treeインデックスのパフォーマンスが向上するため、特に適しています。

分散システム

マイクロサービス、メッセージキュー、イベントソーシングシステム全体で、独立してユニークな識別子を生成します。UUIDにより中央集権的なID生成サービスが不要になります。

API開発

RESTfulおよびGraphQL APIのユニークなリクエストID、相関ID、冪等キーを作成します。UUIDにより分散サービス境界をまたいだリクエストの追跡が容易になります。

セッション & トークン管理

認証フローのためのユニークなセッション識別子と一時トークンを生成します。UUIDは大規模ユーザーベースにおけるセッション衝突を防ぐのに十分な一意性を提供します。

テスト & 開発

テストデータ、モック識別子、自動テスト用のユニークなフィクスチャIDを素早く生成できます。一括生成機能により、開発用データベースやテストスイートへのデータ投入が容易になります。

技術詳細

UUIDの構造

UUIDは128ビット（16バイト）で、32桁の16進数文字が8-4-4-4-12のフォーマットで表されます。ビット48〜51（13番目の16進数桁）がバージョン番号をエンコードします。ビット64〜65がバリアントフィールドをエンコードし、UUIDのレイアウトを識別します。残りのビットにはバージョン固有のペイロード（タイムスタンプ、乱数データ、またはハッシュ出力）が含まれます。

バージョンビット

ビット48〜51（第7バイトの上位ニブル）がUUIDバージョンをエンコードします：0001 = v1（タイムスタンプベース）、0011 = v3（MD5名前ベース）、0100 = v4（ランダム）、0101 = v5（SHA-1名前ベース）、0110 = v6（時間再配置）、0111 = v7（Unixエポック時間）。この4ビットは生成時に常に明示的に設定されます。

バリアントフィールド

ビット64〜65（第9バイトの最上位2ビット）がバリアントを定義します。パターン10xはRFC 4122/9562 UUID（大多数）を示します。パターン110はMicrosoft GUIDを示し、混合エンディアンのバイトオーダーを使用します。パターン0xxはNCS後方互換UUID（レガシー）を示します。パターン111は将来の使用のために予約されています。

RFC 9562標準

RFC 9562は2024年5月に公開され、RFC 4122に代わるUUIDの決定版仕様となりました。UUIDバージョン6、7、8を正式に導入しています。バージョン6はv1のフィールドを並べ替えてソート可能にします。バージョン7は48ビットのミリ秒単位Unixタイムスタンプと乱数データを使用し、新しい時間ベースUUIDの推奨バージョンです。バージョン8はカスタムの実装固有UUIDのフォーマットを提供します。RFC 9562はまたv1を正式に非推奨とし、v6/v7の使用を推奨しています。

ベストプラクティス

適切なバージョンを選択する

順序付けや決定論性が不要な汎用の一意識別子にはv4を使用してください。データベースの主キーにはv7を使用——時間順の特性によりインデックスパフォーマンスが大幅に向上します。名前から決定論的なIDを導出する必要がある場合はv5を使用してください（より強力なハッシュのため、v3よりv5を優先します）。

データベース主キーにはUUID v7を使用する

UUID v7の時間順構造はB-treeの挿入を順次的に保ち、ランダムなv4 UUIDと比較してインデックスの断片化を約90%削減します。これにより書き込み速度の向上、インデックスサイズの縮小、キャッシュ利用率の向上が実現します。ほとんどのモダンなデータベース（PostgreSQL 17以降、MySQL 8.0以降）は、このパターンに最適化されたネイティブUUIDサポートを備えています。

UUIDをセキュリティトークンとして使用しない

UUIDは一意性のために設計されており、秘密性のためではありません。UUID v1は生成タイムスタンプとMACアドレスを漏洩します。UUID v4は予測可能な構造を持ち、エントロピーは122ビットのみです。セキュリティトークン、APIキー、セッションシークレットには、専用のCSPRNGで128ビットまたは256ビットの純粋な乱数データを生成し、UUID構造のオーバーヘッドを避けてください。

解析前に検証する

UUIDを解析または保存する前に、正規表現でフォーマットを必ず検証してください。APIエンドポイント、フォーム送信、データベース入力などのシステム境界で不正な入力を拒否してください。これにより、インジェクション攻撃、データ破損、無効な識別子がシステム全体に伝播することによるデバッグ困難なエラーを防止できます。

よくある質問