すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:UUID ジェネレーター (UUID-OSSP)

最終更新日:Mar 29, 2026

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 バージョンの選択

バージョン関数アルゴリズム使用場面
v4uuid_generate_v4() → uuid乱数汎用一意 ID、プライマリキー — ほとんどのケースで推奨
v5uuid_generate_v5(namespace uuid, name text) → uuidSHA-1名前から派生した決定論的 ID。v3 よりも v5 を推奨
v3uuid_generate_v3(namespace uuid, name text) → uuidMD5v5 が利用できない場合の決定論的 ID
v1mcuuid_generate_v1mc() → uuidタイムスタンプ + ランダムなマルチキャスト MAC アドレス実際の MAC アドレスを公開せずに時間順の ID
v1uuid_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()uuidDomain Name System (DNS) 名前空間
uuid_ns_url()uuidUniform Resource Locator (URL) 名前空間
uuid_ns_oid()uuidISO オブジェクト識別子 (OID) 名前空間。Abstract Syntax Notation One (ASN.1) 標準によって定義されます — PostgreSQL OID とは異なります
uuid_ns_x500()uuidX.500 識別名 (DN) 名前空間

UUID 定数

関数戻り値説明
uuid_nil()uuidNil UUID 定数 — 実際の UUID ではありません

UUID フォーマット

標準の UUID は、32 桁の 16 進数と 4 つのハイフンで構成され、合計 36 文字です。数字は 8-4-4-4-12 の 5 つのグループに配置されます。

a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

PostgreSQL は、以下の代替フォーマットの UUID も受け入れます。

フォーマット例
大文字A0EEBC99-9C0B-4EF8-BB6D-6BB9BD380A11
中括弧{a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11}
ハイフンなしa0eebc999c0b4ef8bb6d6bb9bd380a11
4 桁のグループa0ee-bc99-9c0b-4ef8-bb6d-6bb9-bd38-0a11

参考情報