CREATE OPERATOR

Section: SQL Commands (7)
Updated: 2003-11-02
Index Return to Main Contents
 

NAME

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

 

SYNOPSIS

CREATE OPERATOR name (
    PROCEDURE = funcname
    [, LEFTARG = lefttype ] [, RIGHTARG = righttype ]
    [, COMMUTATOR = com_op ] [, NEGATOR = neg_op ]
    [, RESTRICT = res_proc ] [, JOIN = join_proc ]
    [, HASHES ] [, MERGES ]
    [, SORT1 = left_sort_op ] [, SORT2 = right_sort_op ]
    [, LTCMP = less_than_op ] [, GTCMP = greater_than_op ]
)

 

DESCRIPTION 描述

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


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

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


 你选择名字的时候有几个限制:
-- 和 /* 不能在操作符名字的任何地方出现, 因为它们会被认为是一个注释的开始。

 一个多字符的操作符名字不能以 + 或 - 结尾, 除非该名字还包含至少下面字符之一:

~ ! @ # % ^ & | ` ?


 例如, @- 是一个允许的操作符名, 但 *- 不是。 这个限制允许 PostgreSQL  分析 SQL-有问题的查询而不要求在符号之间有空白。


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


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


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


 其它子句声明可选的操作符优化子句。他们的含义在 ``User-Defined Operators'' 里定义。  

PARAMETERS 参数

name

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

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

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

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

 该操作符对应的交换(commutator)操作符。
neg_op

 对应的负操作符。
res_proc

 此操作符约束选择性计算函数。
join_proc

 此操作符连接选择性计算函数。
HASHES

 表明此操作符支持哈希(散列)连接。
MERGES

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

 如果此操作符支持融合连接(join),此操作符的左手边数据的排序操作符。
right_sort_op

 如果此操作符支持融合连接(join),此操作符的右手边数据的排序操作符。
less_than_op

 如果这个操作符可以支持融合连接,那么这就是比较这个操作符的输入数据类型的小于操作符。
greater_than_op

 如果这个操作符不支持融合连接,那么这就是比较输入这个操作符的数据类型的大于操作符。


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

COMMUTATOR = OPERATOR(myschema.===) ,

 

NOTES 注意


 请参阅 ``User-Defined Operators'' 中操作符章节获取更多信息。


 请使用 DROP OPERATOR 从数据库中删除用户定义操作符。  

EXAMPLES 例子


 下面命令定义一个新操作符,面积相等,用于 box 数据类型。

CREATE OPERATOR === (
    LEFTARG = box,
    RIGHTARG = box,
    PROCEDURE = area_equal_procedure,
    COMMUTATOR = ===,
    NEGATOR = !==,
    RESTRICT = area_restriction_procedure,
    JOIN = area_join_procedure,
    HASHES,
    SORT1 = <<<,
    SORT2 = <<<
    -- 因为给出了排序操作符,索引隐含地有 MERGES。
    -- LTCMP 和 GTCMP 分别假设是 < 和 >
);

 

COMPATIBILITY 兼容性

CREATE OPERATOR 是 PostgreSQL 扩展。 在SQL标准中没有 CREATE OPERATOR 语句。  

译者

Postgresql 中文网站 何伟平 <[email protected]>


 

Index

NAME
SYNOPSIS
DESCRIPTION 描述
PARAMETERS 参数
NOTES 注意
EXAMPLES 例子
COMPATIBILITY 兼容性
译者

This document was created by man2html, using the manual pages.
Time: 13:12:50 GMT, December 24, 2015