Provided by: manpages-zh_1.6.3.2-1_all bug

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