UUID-OSSP 拡張機能は、ApsaraDB RDS for PostgreSQL で UUID (universally unique identifier) を生成する関数を提供します。バージョン 1、3、または 5 の UUID が必要な場合にご利用ください。
前提条件
開始する前に、以下を確認してください。
ご利用の ApsaraDB RDS for PostgreSQL インスタンスに対する特権アカウント
ご利用のインスタンスに接続された PostgreSQL クライアント
拡張機能の有効化
特権アカウントとして、次の文を実行します。
CREATE EXTENSION "uuid-ossp";拡張機能を削除するには、次を実行します。
DROP EXTENSION "uuid-ossp";UUID バージョンの選択
| バージョン | 関数 | アルゴリズム | 使用場面 |
|---|---|---|---|
| v4 | uuid_generate_v4() → uuid | 乱数 | 汎用一意 ID、プライマリキー — ほとんどのケースで推奨 |
| v5 | uuid_generate_v5(namespace uuid, name text) → uuid | SHA-1 | 名前から派生した決定論的 ID。v3 よりも v5 を推奨 |
| v3 | uuid_generate_v3(namespace uuid, name text) → uuid | MD5 | v5 が利用できない場合の決定論的 ID |
| v1mc | uuid_generate_v1mc() → uuid | タイムスタンプ + ランダムなマルチキャスト MAC アドレス | 実際の MAC アドレスを公開せずに時間順の ID |
| v1 | uuid_generate_v1() → uuid | タイムスタンプ + 実際の MAC アドレス | ほとんどのケースで避ける — マシン ID と生成時間を公開 |
クイックガイダンス:
プライマリキーおよび汎用一意 ID には v4 を使用します。
同じ入力から再現可能な ID が必要な場合 (例: 特定の URL に対して常に同じ UUID を生成する場合) は、v5 (v3 ではない) を使用します。
時間ベースの順序付けが重要な場合は、v1 の代わりに v1mc を使用します。セキュリティ上重要なアプリケーションでは、両方とも避けてください。
UUID の生成
バージョン 4 — ランダム (推奨)
uuid_generate_v4() → uuid
SELECT uuid_generate_v4();出力:
uuid_generate_v4
--------------------------------------
170d0eb6-520a-4f93-a1b3-89458fffb54c
(1 row)テーブルのデフォルトのプライマリキーとしてバージョン 4 の UUID を使用します。
CREATE TABLE contacts (
id uuid DEFAULT uuid_generate_v4() PRIMARY KEY,
first_name text,
last_name text
);バージョン 5 — SHA-1 を使用した決定論的
uuid_generate_v5(namespace uuid, name text) → uuid
namespace パラメーターは、uuid_ns_*() 関数によって返される定数のいずれかである必要があります (UUID 名前空間定数をご参照ください)。name パラメーターは、その名前空間内の識別子です。
同じ名前空間と名前は常に同じ UUID を生成します。出力からプレーンテキストを派生させることはできません。
SELECT uuid_generate_v5(uuid_ns_url(), 'example.com');出力:
uuid_generate_v5
--------------------------------------
a5cf6e8e-4cfa-5f31-a804-6de6d1245e26
(1 row)バージョン 3 — MD5 を使用した決定論的
uuid_generate_v3(namespace uuid, name text) → uuid
v5 と同様に機能しますが、SHA-1 の代わりに MD5 を使用します。可能な場合は v5 を使用してください。
SELECT uuid_generate_v3(uuid_ns_url(), 'example.com');出力:
uuid_generate_v3
--------------------------------------
a0473a67-27a1-3c05-a2d1-5c134639347f
(1 row)バージョン 1 — タイムスタンプベース
uuid_generate_v1() → uuid
SELECT uuid_generate_v1();出力:
uuid_generate_v1
--------------------------------------
a6808efc-13c8-11ed-ad4f-00163e010e52
(1 row)バージョン 1 の UUID は、データベースサーバーの実際の MAC アドレスと正確な生成タイムスタンプを埋め込みます。これにより、生成元のマシンが識別可能になり、UUID が部分的に予測可能になります。実際の MAC アドレスを公開せずに時間順が必要な場合は、代わりに uuid_generate_v1mc() を使用してください。uuid_generate_v1mc() → uuid
SELECT uuid_generate_v1mc();この関数は、実際の MAC アドレスの代わりにランダムなマルチキャスト MAC アドレスを使用し、マシン ID の回避と同時に時間順を維持します。
UUID 名前空間定数
namespace 引数として、これらの定数を uuid_generate_v3() および uuid_generate_v5() で使用します。
| 関数 | 戻り値 | 説明 |
|---|---|---|
uuid_ns_dns() | uuid | Domain Name System (DNS) 名前空間 |
uuid_ns_url() | uuid | Uniform Resource Locator (URL) 名前空間 |
uuid_ns_oid() | uuid | ISO オブジェクト識別子 (OID) 名前空間。Abstract Syntax Notation One (ASN.1) 標準によって定義されます — PostgreSQL OID とは異なります |
uuid_ns_x500() | uuid | X.500 識別名 (DN) 名前空間 |
UUID 定数
| 関数 | 戻り値 | 説明 |
|---|---|---|
uuid_nil() | uuid | Nil UUID 定数 — 実際の UUID ではありません |
UUID フォーマット
標準の UUID は、32 桁の 16 進数と 4 つのハイフンで構成され、合計 36 文字です。数字は 8-4-4-4-12 の 5 つのグループに配置されます。
a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11PostgreSQL は、以下の代替フォーマットの UUID も受け入れます。
| フォーマット | 例 |
|---|---|
| 大文字 | A0EEBC99-9C0B-4EF8-BB6D-6BB9BD380A11 |
| 中括弧 | {a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11} |
| ハイフンなし | a0eebc999c0b4ef8bb6d6bb9bd380a11 |
| 4 桁のグループ | a0ee-bc99-9c0b-4ef8-bb6d-6bb9-bd38-0a11 |