更新时间:2026-10-21 GMT+08:00
分享

CREATE OPERATOR

功能描述

创建一个新操作符。

注意事项

  • 创建操作符的用户将成为其所有者。
  • 操作符!=在输入时,会被映射成<>,因此操作符!=和操作符<>为等价的操作符。
  • 对于双目操作符,需要同时定义LEFTARG和RIGHTARG;对右目操作符,仅需要定义LEFTARG;对于左目操作符,仅需要定义RIGHTARG。
  • 仅拥有参数类型以及返回类型的USAGE权限的用户可以创建新的操作符,且必须拥有其底层函数的EXECUTE权限。如果指定了交换操作符或者负操作符,当前用户还必须拥有这些操作符的USAGE权限。

语法格式

CREATE OPERATOR name (
    PROCEDURE = function_name
    [, LEFTARG = left_type ] [, RIGHTARG = right_type ]
    [, COMMUTATOR = com_op ] [, NEGATOR = neg_op ]
    [, RESTRICT = res_proc ] [, JOIN = join_proc ]
    [, HASHES ] [, MERGES ]
);

参数说明

  • name

    需要创建的操作符,可以使用模式进行具体指定,如果未指定模式,则在当前模式中创建操作符。同一个模式中的两个操作符可以重名,但需要操作不同的数据类型。

    命名规范:

    • 操作符的名称是由字符+、-、*、/、<、>、=、~、!、@、#、%、^、&、|、`或?组成的字符串。
    • --和/*不能在操作符名的任何地方出现,因为其会被作为注释的开始进行使用。
    • 一个多字符的操作符不能以字符+或字符-结尾,除非该操作符名称中至少还包含字符~、!、@、#、%、^、&、|、`或?。
    • 对于=>作为一个操作符名的使用方式已经不再使用,请不要将=>作为操作符名进行定义。
  • function_name

    用于实现该操作符的函数。

    对于使用的操作函数(function_name),必须已经通过CREATE FUNCTION进行定义,而且必须定义为接受正确数量的指定类型参数(一个或两个)。

  • left_type

    对于右目操作符,操作符左边的参数数据类型。对于左目操作符,该参数可以省略。

  • right_type

    对于左目操作符,操作符右边的参数数据类型。对于右目操作符,该参数可以省略。

  • com_op

    操作符对应的交换操作符。

  • neg_op

    操作符对应的负操作符。

  • res_proc

    操作符约束选择性评估函数。

  • join_proc

    操作符连接选择性评估函数。

  • HASHES

    操作符支持Hash连接。

  • MERGES

    操作符支持融合连接。

示例

--定义一个面积相等,用于box数据类型的新操作符。
gaussdb=# CREATE FUNCTION area_equal_procedure(box, box)
RETURNS boolean
AS $$
SELECT (area($1) = area($2));
$$ LANGUAGE sql IMMUTABLE;
gaussdb=# CREATE OPERATOR === (
    LEFTARG = box,
    RIGHTARG = box,
    PROCEDURE = area_equal_procedure,
    COMMUTATOR = ===,
    NEGATOR = !==,
    HASHES, MERGES
);
gaussdb=# SELECT box '(1.0,1.0), (2.0,2.0)' === box'(3,3),(4,4)';
 ?column? 
----------
 t
(1 row)
gaussdb=# DROP OPERATOR ===(box, box);
DROP OPERATOR

--在其他Schema下定义操作符。
gaussdb=# CREATE OPERATOR pg_temp.=== (
    LEFTARG = box,
    RIGHTARG = box,
    PROCEDURE = area_equal_procedure,
    COMMUTATOR = ===,
    NEGATOR = !==,
    HASHES, MERGES
);
gaussdb=# SELECT box '(1.0,1.0),(2.0,2.0)' OPERATOR(pg_temp.===) box '(2.0,2.0),(3.0,3.0)';
 ?column? 
----------
 t
(1 row)
gaussdb=# DROP OPERATOR pg_temp.===(box,box);
DROP OPERATOR
gaussdb=# DROP FUNCTION area_equal_procedure;
DROP FUNCTION

相关文档