バージョンごとのドキュメント一覧

9.14. UUID関数 #

<title>UUID Functions</title>

<productname>PostgreSQL</productname> includes one function to generate a UUID: PostgreSQLには、UUIDを生成するための関数が1つあります。

gen_random_uuid () → uuid

This function returns a version 4 (random) UUID. This is the most commonly used type of UUID and is appropriate for most applications. この関数はバージョン4(ランダム)UUIDを返します。 これはUUIDのもっとも一般的な使い方で、大抵のアプリケーションに適しています。

The <xref linkend="uuid-ossp"/> module provides additional functions that implement other standard algorithms for generating UUIDs. uuid-osspモジュールはUUID生成のための他の標準アルゴリズムを実装した追加の関数を提供します。

There are also functions to extract data from UUIDs: また、UUID からデータを抽出する関数もあります。

uuid_extract_timestamp (uuid) → timestamp with time zone

This function extracts a <type>timestamp with time zone</type> from UUID version 1. For other versions, this function returns null. Note that the extracted timestamp is not necessarily exactly equal to the time the UUID was generated; this depends on the implementation that generated the UUID. この関数はUUIDバージョン1からtimestamp with time zoneを抽出します。 他のバージョンでは、この関数はNULLを返します。 抽出されたタイムスタンプは必ずしもUUIDが生成された時間と正確に同じではありません。これはUUIDが生成された実装に依存します。

uuid_extract_version (uuid) → smallint

This function extracts the version from a UUID of the variant described by <ulink url="https://datatracker.ietf.org/doc/html/rfc4122">RFC 4122</ulink>. For other variants, this function returns null. For example, for a UUID generated by <function>gen_random_uuid</function>, this function will return 4. この関数は、RFC 4122に記述されている種類のUUIDからバージョンを抽出します。 他の種類については、この関数はNULLを返します。 例えば、gen_random_uuidによって生成されたUUIDに対して、この関数は4を返します。

<productname>PostgreSQL</productname> also provides the usual comparison operators shown in <xref linkend="functions-comparison-op-table"/> for UUIDs. PostgreSQL表 9.1で示すUUIDのための通常の比較演算子を提供しています。