Postgres Pro Enterprise
1817161514131211109.6
Postgres Pro Standard
1817161514131211109.69.5
PostgreSQL
1817161514131211109.69.59.4
RUENRU EN
ALTER OPERATOR
Пред. НаверхКоманды SQLНачало След.

ALTER OPERATOR

ALTER OPERATOR — изменить определение оператора

Синтаксис

ALTER OPERATOR имя ( { тип_слева | NONE } , тип_справа )
    OWNER TO { новый_владелец | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

ALTER OPERATOR имя ( { тип_слева | NONE } , тип_справа )
    SET SCHEMA новая_схема

ALTER OPERATOR имя ( { тип_слева | NONE } , тип_справа )
    SET ( {  RESTRICT = { процедура_ограничения | NONE }
           | JOIN = { процедура_соединения | NONE }
           | COMMUTATOR = коммут_оператор
           | NEGATOR = обратный_оператор
           | HASHES
           | MERGES
          } [, ... ] )

Описание

ALTER OPERATOR изменяет определение оператора.

Выполнить ALTER OPERATOR может только владелец соответствующего оператора. Чтобы сменить владельца, необходимо иметь право SET ROLE для новой роли-владельца, а эта роль должна иметь право CREATE в схеме оператора. (С такими ограничениями при смене владельца не происходит ничего такого, что нельзя было бы сделать, имея право удалить и вновь создать оператор. Однако суперпользователь может сменить владельца оператора в любом случае.)

Параметры

имя

Имя существующего оператора (возможно, дополненное схемой).

тип_слева

Тип данных левого операнда оператора; если у оператора нет левого операнда, укажите NONE.

тип_справа

Тип данных правого операнда оператора.

новый_владелец

Новый владелец оператора.

новая_схема

Новая схема оператора.

процедура_ограничения

Функция оценки избирательности ограничения для данного оператора; значение NONE удаляет существующую функцию оценки.

процедура_соединения

Функция оценки избирательности соединения для этого оператора; значение NONE удаляет существующую функцию оценки.

коммут_оператор

Оператор, коммутирующий для данного. Можно изменить, только если у данного оператора коммутирующий отсутствует.

обратный_оператор

Оператор, обратный к данному. Можно изменить, только если у данного оператора обратный отсутствует.

HASHES

Показывает, что этот оператор поддерживает соединение по хешу. Можно только включить, но не отключить.

MERGES

Показывает, что этот оператор поддерживает соединение слиянием. Можно только включить, но не отключить.

Примечания

Более подробно информация описана в Разделе 36.14 и Разделе 36.15.

Поскольку коммутирующие операторы связаны парами и являются коммутирующими друг для друга, команда ALTER OPERATOR SET COMMUTATOR также назначит данный оператор коммутирующим для оператора из параметра коммут_оператор. Аналогично команда ALTER OPERATOR SET NEGATOR назначит данный оператор обратным для оператора из параметра обратный_оператор. Таким образом, для выполнения команды необходимо являться владельцем и данного оператора, и назначаемого коммутирующего или обратного оператора.

Примеры

Смена владельца нестандартного оператора a @@ b для типа text: 

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

Смена функций оценки избирательности ограничения и соединения для нестандартного оператора a && b для типа int[]: 

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

Пометка оператора && как коммутирующего для самого себя: 

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

Совместимость

Команда ALTER OPERATOR отсутствует в стандарте SQL.

Пред. Наверх След.
ALTER MATERIALIZED VIEW Начало ALTER OPERATOR CLASS
ALTER OPERATOR
Prev UpSQL CommandsHome Next

ALTER OPERATOR

ALTER OPERATOR — change the definition of an operator

Synopsis

ALTER OPERATOR name ( { left_type | NONE } , right_type )
    OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

ALTER OPERATOR name ( { left_type | NONE } , right_type )
    SET SCHEMA new_schema

ALTER OPERATOR name ( { left_type | NONE } , right_type )
    SET ( {  RESTRICT = { res_proc | NONE }
           | JOIN = { join_proc | NONE }
           | COMMUTATOR = com_op
           | NEGATOR = neg_op
           | HASHES
           | MERGES
          } [, ... ] )

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

The name (optionally schema-qualified) of an existing operator.

left_type

The data type of the operator's left operand; write NONE if the operator has no left operand.

right_type

The data type of the operator's right operand.

new_owner

The new owner of the operator.

new_schema

The new schema for the operator.

res_proc

The restriction selectivity estimator function for this operator; write NONE to remove existing selectivity estimator.

join_proc

The join selectivity estimator function for this operator; write NONE to remove existing selectivity estimator.

com_op

The commutator of this operator. Can only be changed if the operator does not have an existing commutator.

neg_op

The negator of this operator. Can only be changed if the operator does not have an existing negator.

HASHES

Indicates this operator can support a hash join. Can only be enabled and not disabled.

MERGES

Indicates this operator can support a merge join. Can only be enabled and not disabled.

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: 

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

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

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

Mark the && operator as being its own commutator: 

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

Compatibility

There is no ALTER OPERATOR statement in the SQL standard.

Prev Up Next
ALTER MATERIALIZED VIEW Home ALTER OPERATOR CLASS
FAQ