CREATE OPERATOR

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

描述

CREATE OPERATOR 定義一個新的操作符, name。 定義該操作符的用戶成為其所有者。如果給出了一個模式名,那麼該操作符將在指定的模式中建立。 否則它會在目前模式中建立。

操作符 name 是一個最多NAMEDATALEN-1 長的(預設為 63 個)下列字元組成的字串:

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

您選擇名字的時候有幾個限制:

操作符 != 在輸入時映射成 <>, 因此這兩個名稱總是相等的。

至少需要定義一個LEFTARGRIGHTARG。 對於雙目操作符來說,兩者都需要定義。 對右目操作符來說,只需要定義LEFTARG, 而對於左目操作符來說,只需要定義RIGHTARG

同樣,funcname 過程必須已經用 CREATE FUNCTION 定義過, 而且必須定義為接受正確數量的指定類型參數(一個或是兩個)。

其它子句聲明可選的操作符優化子句。他們的含義在 Section 31.13 裡定義。

參數

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.===) ,

注意

請參閱 Section 31.12 中操作符章節獲取更多訊息。

請使用 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,
    SORT1 = <<<,
    SORT2 = <<<
    -- 因為給出了排序操作符,索引隱含地有 MERGES。
    -- LTCMP 和 GTCMP 分別假設是 < 和 >
);

相容性

CREATE OPERATORPostgreSQL 擴展。 在SQL92中沒有 CREATE OPERATOR 語句。

又見

ALTER OPERATOR, CREATE OPERATOR CLASS, DROP OPERATOR