CREATE OPERATOR

説明

CREATE OPERATORは、新しい演算子nameを定義します。 演算子を定義したユーザがその所有者となります。 スキーマ名が指定されていた場合、その演算子は指定したスキーマで作成されます。 スキーマ名が指定されなかった場合、現在のスキーマで作成されます。

演算子名として使用できるのは、以下に示す文字を使った、NAMEDATALEN-1（デフォルトでは63）文字までの文字列です。

+ - * / < > = ~ ! @ # % ^ & | ` ?

• --と/*は演算子名の一部として使うことができません。 コメントの開始とみなされてしまうからです。

• 複数の文字からなる演算子名は、下記の文字のうちの1つ以上を含まない限り、+または-で終わることができません。

  ~ ! @ # % ^ & | ` ?

  例えば、@-は演算子名として許されますが、*-は許されません。 この制約により、PostgreSQLがSQLに準拠する問い合わせをトークン同士の間に空白を要求することなしに解析することが可能になります。

演算子!=は入力時に<>に変換されるので、これらの2つの名前は常に等価です。

少なくともLEFTARGとRIGHTARGのどちらかは定義しなければなりません。 二項演算子では、両方を定義しなければなりません。 右単項演算子ではLEFTARGのみ、左単項演算子ではRIGHTARGのみが定義されなければなりません。

funcnameプロシージャは、CREATE FUNCTIONを使って事前に定義されていなければなりません。また、指定された型の正しい数の引数（1つか2つ）を受け付けるよう定義する必要があります。

他の句は省略可能な演算子最適化用の句です。 これらの意味は項34.13で説明されています。

パラメータ

スキーマ修飾された演算子名をcom_opまたは他のオプション引数に与えるには、以下の例のようにOPERATOR()構文を使用してください。

COMMUTATOR = OPERATOR(myschema.===) ,

注釈

詳細については項34.12を参照してください。

廃止されたオプションSORT1、SORT2、LTCMP、およびGTCMPは、マージ結合可能演算子に関連したソート演算子の名前を指定するために使用されていました。 代わりにB-Tree演算子族を検索することで関連する演算子を見つけることができるようになりましたので、これは必要がなくなりました。 これらの内のいずれかのオプションが指定された場合、暗黙的にMERGESを真に指定している場合を除き、無視されます。

データベースからユーザ定義の演算子を削除するには、DROP OPERATORを使用してください。 データベース内の演算子を変更するにはALTER OPERATORを使用してください。

例

以下のコマンドは、boxデータ型に対する領域等価性を判定する新しい演算子を定義します。

CREATE OPERATOR === (
    LEFTARG = box,
    RIGHTARG = box,
    PROCEDURE = area_equal_procedure,
    COMMUTATOR = ===,
    NEGATOR = !==,
    RESTRICT = area_restriction_procedure,
    JOIN = area_join_procedure,
    HASHES, MERGES
);

互換性

CREATE OPERATORはPostgreSQLの拡張です。 標準SQLには、ユーザ定義の演算子についての規定はありません。

関連項目