# 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 个) 下列字符组成的字符串： + - * / < > = ~ ! @ # % ^ & | ` ? 你选择名字的时候有几个限制： * `--`和`/*`不能在操作符名的任何地方出现， 因为它们会被认为是一个注释的开始。 * 一个多字符的操作符不能以`+`或`-`结尾， 除非该名字还包含至少下面字符之一： ~ ! @ # % ^ & | ` ? 例如，`@-`是一个允许的操作符名，但`*-`不是。 这个限制允许PostgreSQL 分析 SQL 兼容的查询而不要求在符号之间有空白。 * `=>`作为一个操作符名的使用已经废弃了。可能在未来的版本中完全禁用。 操作符`!=`在输入时映射成`<>`， 因此这两个名称总是等价的。 至少需要定义一个`LEFTARG`和`RIGHTARG`。对于双目操作符来说， 两者都需要定义。对右目操作符来说，只需要定义`LEFTARG`， 而对于左目操作符来说，只需要定义`RIGHTARG`。 同样，`_function_name_` 过程必须已经用`CREATE FUNCTION`定义过， 而且必须定义为接受正确数量的指定类型参数(一个或是两个)。 其它子句声明可选的操作符优化子句。他们的含义在[Section 35.13](#calibre_link-839)里定义。 要想能够创建一个操作符，你必须在参数类型和返回类型上有`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](#calibre_link-838)中的操作符章节获取更多信息。 在`CREATE OPERATOR`中指定操作符的词法优先级是不可能的， 因为分析器的优先级行为是硬链接的。参阅[Section 4.1.6](#calibre_link-538) 获取优先级的详细信息。 废弃的选项`SORT1`、`SORT2`、`LTCMP`和 `GTCMP`以前用于指定与可合并连接的操作符相关的排序操作符的名字。 现在不再需要了，因为相关操作符的信息通过查询B-tree操作符类来找到。 如果给出了这些中的一个选项，那么会忽略该选项，除非暗中设置`MERGES`为真。 使用[DROP OPERATOR](#calibre_link-606)从数据库中删除用户定义操作符。 使用[ALTER OPERATOR](#calibre_link-610)修改一个数据库里的操作符。 ## 例子 下面命令定义一个新操作符：面积相等，用于`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](#calibre_link-610), [CREATE OPERATOR CLASS](#calibre_link-53), [DROP OPERATOR](#calibre_link-606)