CREATE OPERATOR

Name

CREATE OPERATOR -- 定义一个新操作符

Synopsis

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 ]
)

描述

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

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

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

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

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

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

function_name程序必须 是以前用CREATE FUNCTION定义的并且必须定义来接受 指定类型的参数(一个或者两个)的正确数值。

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

参数

name

要定义的操作符。可用的字符见上文。其名字可以用模式修饰 (比如CREATE OPERATOR myschema.+ (...))。如果没有 模式,则在当前模式中创建操作符。同一个模式中的两个操作符可以 有一样的名字,只要他们操作不同的数据类型。这叫做重载

function_name

用于实现该操作符的函数

left_type

操作符左边的参数数据类型,如果存在的话。如果是左目操作符, 这个参数可以省略。

right_type

操作符右边的参数数据类型,如果存在的话。如果是右目操作符,这个参数 可以省略。

com_op

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

neg_op

该操作符对应的负操作符

res_proc

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

join_proc

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

HASHES

表明此操作符支持 Hash 连接

MERGES

表明此操作符可以支持一个融合连接

com_op中给出模式修饰的 操作符名称或者其他可选参数,使用OPERATOR()语法,例如:

COMMUTATOR = OPERATOR(myschema.===) ,

Notes

参阅节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 OPERATORPostgreSQL 扩展。SQL 标准中没有该语句。

又见

ALTER OPERATOR, CREATE OPERATOR CLASS, DROP OPERATOR