alter_operator(7) - BetterMan

—

NAME

ALTER_OPERATOR - change the definition of an operator

SYNOPSIS

bash

ALTER OPERATOR \nname\n ( { \nleft_type\n | NONE } , \nright_type\n )
\n
    OWNER TO { \nnew_owner\n | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER OPERATOR \nname\n ( { \nleft_type\n | NONE } , \nright_type\n )
\n
    SET SCHEMA \nnew_schema\n
ALTER OPERATOR \nname\n ( { \nleft_type\n | NONE } , \nright_type\n )
\n
    SET ( {  RESTRICT = { \nres_proc\n | NONE }
\n
           | JOIN = { \njoin_proc\n | NONE }
\n
           | COMMUTATOR = \ncom_op\n
\n
           | NEGATOR = \nneg_op\n
\n
           | HASHES
\n
           | MERGES
\n
          } [, ... ] )

DESCRIPTION

ALTER OPERATOR changes the definition of an operator.

You must own the operator to use ALTER OPERATOR. To alter the owner, you must be able to SET ROLE to the new owning role, and that role must have CREATE privilege on the operator's schema. (These restrictions enforce that altering the owner doesn't do anything you couldn't do by dropping and recreating the operator. However, a superuser can alter ownership of any operator anyway.)

PARAMETERS

name

left_type

right_type

new_owner

new_schema

res_proc

join_proc

com_op

neg_op

HASHES

MERGES

NOTES

Refer to Section 36.14 and Section 36.15 for further information.

Since commutators come in pairs that are commutators of each other, ALTER OPERATOR SET COMMUTATOR will also set the commutator of the com_op to be the target operator. Likewise, ALTER OPERATOR SET NEGATOR will also set the negator of the neg_op to be the target operator. Therefore, you must own the commutator or negator operator as well as the target operator.

EXAMPLES

Change the owner of a custom operator a @@ b for type text:

bash

ALTER OPERATOR @@ (text, text) OWNER TO joe;

Change the restriction and join selectivity estimator functions of a custom operator a && b for type int[]:

bash

ALTER OPERATOR && (int[], int[]) SET (RESTRICT = _int_contsel, JOIN = _int_contjoinsel);

Mark the && operator as being its own commutator:

bash

ALTER OPERATOR && (int[], int[]) SET (COMMUTATOR = &&);

COMPATIBILITY

There is no ALTER OPERATOR statement in the SQL standard.