CREATE OPERATOR

PostgreSQL 9.3.1 中文手册
Prev	Up		Next

描述

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

操作符 name 是一个最多NAMEDATALEN-1长的(缺省为 63 个) 下列字符组成的字符串：

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

你选择名字的时候有几个限制：

--和/*不能在操作符名的任何地方出现，因为它们会被认为是一个注释的开始。
一个多字符的操作符不能以+或-结尾，除非该名字还包含至少下面字符之一：
~ ! @ # % ^ & | ` ?
例如，@-是一个允许的操作符名，但*-不是。这个限制允许PostgreSQL 分析 SQL 兼容的查询而不要求在符号之间有空白。
=>作为一个操作符名的使用已经废弃了。可能在未来的版本中完全禁用。

操作符!=在输入时映射成<>，因此这两个名称总是等价的。

至少需要定义一个LEFTARG和RIGHTARG。对于双目操作符来说，两者都需要定义。对右目操作符来说，只需要定义LEFTARG，而对于左目操作符来说，只需要定义RIGHTARG。

同样，function_name 过程必须已经用CREATE FUNCTION定义过，而且必须定义为接受正确数量的指定类型参数(一个或是两个)。

其它子句声明可选的操作符优化子句。他们的含义在Section 35.13里定义。

要想能够创建一个操作符，你必须在参数类型和返回类型上有USAGE权限，还要在底层函数上有EXECUTE权限。如果指定了交换或者负操作符，你必须拥有这些操作符。

参数

name: 要定义的操作符。可用的字符见上文。其名字可以用模式修饰，比如CREATE OPERATOR myschema.+ (...)。如果没有模式，则在当前模式中创建操作符。同一个模式中的两个操作符可以有一样的名字，只要他们操作不同的数据类型。这叫做重载。
function_name: 用于实现该操作符的函数。
left_type: 操作符左边的参数数据类型，如果存在的话。如果是左目操作符，这个参数可以省略。
right_type: 操作符右边的参数数据类型，如果存在的话。如果是右目操作符，这个参数可以省略。
com_op: 该操作符对应的交换操作符。
neg_op: 该操作符对应的负操作符。
res_proc: 此操作符约束选择性评估函数。
join_proc: 此操作符连接选择性评估函数。
HASHES: 表明此操作符支持 Hash 连接。
MERGES: 表明此操作符可以支持一个融合连接。

使用OPERATOR()语法在com_op 或者其它可选参数里给出一个模式修饰的操作符名，比如：

COMMUTATOR = OPERATOR(myschema.===) ,

注意

参阅Section 35.12中的操作符章节获取更多信息。

在CREATE OPERATOR中指定操作符的词法优先级是不可能的，因为分析器的优先级行为是硬链接的。参阅Section 4.1.6 获取优先级的详细信息。

废弃的选项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 标准中没有该语句。

又见

ALTER OPERATOR, CREATE OPERATOR CLASS, DROP OPERATOR

CREATE OPERATOR

Name

Synopsis

描述

参数

注意

例子

兼容性

又见