★PostgreSQLカンファレンス2024 12月6日開催/チケット販売中★
他のバージョンの文書 16 | 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

8.20. 疑似データ型

PostgreSQL型システムには、疑似データ型と総称される特殊用途のエントリが多数含まれます。 疑似データ型は列データ型としては使用できませんが、関数の引数や結果データ型を宣言するために使用できます。 これらの使用可能な疑似データ型は、ある関数の振舞いが、特定のSQLデータ型の値を単に取得したり返したりする操作に対応していない場合に便利です。 表8.25「疑似データ型」に既存の疑似データ型を列挙します。

表8.25 疑似データ型

型名説明
any関数がどのような入力データ型でも受け入れることを示します。
anyelement関数がどのような入力データ型でも受け入れることを示します(35.2.5. 多様型を参照)。
anyarray関数がどのような配列データ型でも受け入れることを示します(35.2.5. 多様型を参照してください)。
anynonarray関数がどのような非配列データ型でも受け入れることを示します(35.2.5. 多様型を参照してください)。
anyenum関数が何らかの列挙データ型を受け付けることを示します(35.2.5. 多様型および8.7. 列挙型を参照してください)。
anyrange関数が範囲データ型を受け付けることを示します(35.2.5. 多様型8.17. 範囲型を参照してください)。
cstring関数がヌル終端のC文字列を受け入れる、もしくは返すことを示します。
internal関数がサーバ内部用データ型を受け入れる、もしくは返すことを示します。
language_handler手続き言語呼び出しハンドラはlanguage_handlerを返すものとして宣言されます。
fdw_handler外部データラッパハンドラはfdw_handlerを返すものとして宣言されます。
tsm_handlerテーブルサンプリング方式のハンドラはtsm_handlerを返すものとして宣言されます。
record未指定の行型の引数を取る、あるいは返す関数を指定します。
triggerトリガ関数はtriggerを返すものとして宣言されます。
event_triggerイベントトリガ関数はevent_triggerを返すものとして宣言されます。
pg_ddl_commandイベントトリガが使用できるDDLコマンドの表現を指定します。
void関数が値を返さないことを示します。
opaque過去に上記の目的すべてを果たしていた古いデータ型の名前です。

C言語で作成された関数(それが組み込みか動的にロードされるかに関係なく)は、これらの疑似データ型のどれでも受け入れたり返したりするように宣言することができます。 引数型として疑似データ型が使用されても関数が安全に機能するように、関数の作成時に気を付ける必要があります。

手続き型言語で作成された関数では、実装する言語によって許可された疑似データ型のみを使用できます。 現在、ほとんどの手続き型言語では疑似データ型を引数型として使用することが原則として禁止されており、結果型としてのvoidrecord(および関数がトリガまたはイベントトリガとして使用される場合のtriggerまたはevent_trigger)のみが許可されています。 また、anyelementanyarrayanynonarrayanyenumおよびanyrange型を使用する多様性関数をサポートするものもあります。

internal疑似データ型は、データベースシステムによって内部的にのみ呼び出される関数を宣言する場合に使用され、SQL問い合わせでの直接呼び出しには使用できません。 関数に少なくとも1つのinternal型の引数があると、これをSQLから呼び出すことはできません。 この制限の影響からデータ型の安全性を保持するためには、次のコーディング規則に従うことが重要です。 internal引数が少なくとも1つある場合を除き、internalを返すと宣言される関数を作成すべきではありません。