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 中文網站 何偉平 <laser@pgsqldb.org>

跋

本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh

2003-11-02

SQL - Language Statements