CREATE OPERATOR

描述

CREATE OPERATOR定义一个新的操作符 name。定义该操作符的用户将成为其拥有者。如果给出了模式名，该操作符将在指定的模式中创建；否则将在当前模式中创建。

操作符名称最多可以由 NAMEDATALEN-1 个字符（默认为 63 个）组成，这些字符必须取自下列列表：

名称选择还有一些限制：

输入!=时会被映射为<>，因此这两个名称始终等效。

对于二元操作符，必须同时定义LEFTARG和RIGHTARG。对于前缀操作符，则只应定义RIGHTARG。function_name函数必须事先已用CREATE FUNCTION定义，并且其定义必须接受正确数量（一个或两个）的指定类型参数。

在CREATE OPERATOR的语法中，关键字 FUNCTION和PROCEDURE是等效的，但这里引用的对象无论如何都必须是函数而不是过程。此处使用关键字 PROCEDURE是历史遗留做法，现已弃用。

其他子句用于指定可选的操作符优化属性。其含义详见第 36.15 节。

要创建操作符，你必须在参数类型和返回类型上具有 USAGE权限，并在底层函数上具有 EXECUTE权限。如果指定了交换子或求反器操作符，你还必须拥有这些操作符。

参数

要在com_op或其他可选参数中给出带模式限定的操作符名称，请使用OPERATOR()语法，例如：

COMMUTATOR = OPERATOR(myschema.===) ,

注解

更多信息请参见第 36.14 节和第 36.15 节。

当你定义一个自交换操作符时，直接定义即可。定义一对互为交换子的操作符时则稍微复杂一些：先定义的那个操作符如何引用另一个尚未定义的操作符呢？这个问题有三种解决办法：

在上述三种情况下，若要将两个操作符标记为交换子，必须同时拥有它们。

成对的求反器操作符也可以用与交换子对相同的方法定义。

无法在CREATE OPERATOR中指定一个操作符的词法优先级，因为解析器的优先级行为是硬写在代码中的。详见第 4.1.6 节。

废弃的选项SORT1、SORT2、LTCMP以及GTCMP以前被用来指定与可归并连接的操作符相关联的排序操作符名称。现在已不再需要这样做，因为相关操作符的信息会通过查找 B-树操作符族来获得。如果给出这些选项中的任意一个，除了会隐式将MERGES设为真之外，其余都会被忽略。

使用DROP OPERATOR从数据库中删除用户定义的操作符。使用ALTER OPERATOR修改数据库中的操作符。

示例

下面的命令为数据类型box定义了一个新的面积相等操作符：

CREATE OPERATOR === (
    LEFTARG = box,
    RIGHTARG = box,
    FUNCTION = area_equal_function,
    COMMUTATOR = ===,
    NEGATOR = !==,
    RESTRICT = area_restriction_function,
    JOIN = area_join_function,
    HASHES, MERGES
);

兼容性

CREATE OPERATOR是 PostgreSQL扩展。在 SQL 标准中没有用户定义操作符的规定。

另见