ALTER FUNCTION

Изменение определения функции.

Синтаксис

ALTER FUNCTION name ( [ [argmode] [argname] argtype [, ...] ] ) 
   action [, ... ] [RESTRICT]

ALTER FUNCTION name ( [ [argmode] [argname] argtype [, ...] ] )
   RENAME TO new_name

ALTER FUNCTION name ( [ [argmode] [argname] argtype [, ...] ] ) 
   OWNER TO new_owner

ALTER FUNCTION name ( [ [argmode] [argname] argtype [, ...] ] ) 
   SET SCHEMA new_schema

Где action:

{CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT}
{IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF}
{[EXTERNAL] SECURITY INVOKER | [EXTERNAL] SECURITY DEFINER}
EXECUTE ON { ANY | MASTER | ALL SEGMENTS | INITPLAN }
COST execution_cost
SET configuration_parameter { TO | = } { value | DEFAULT }
SET configuration_parameter FROM CURRENT
RESET configuration_parameter
RESET ALL

Описание

ALTER FUNCTION изменяет определение функции.

Чтобы использовать команду ALTER FUNCTION, вы должны быть владельцем функции. Чтобы изменить схему функции, вы также должны иметь разрешение CREATE в новой схеме. Чтобы изменить владельца, вы должны быть прямым или косвенным членом новой роли, и эта роль должна обладать правом CREATE в режиме функции. Эти ограничения гарантируют, что изменения владельца не позволят делать ничего такого, что нельзя сделать путём удаления и повторного создания функции. Однако суперпользователи могут изменять владельца любой функции.

Параметры

name

Имя существующей функции (возможно, с указанием схемы).

argmode

Режим параметра: IN, OUT, INOUT или VARIADIC. Если не указано, по умолчанию используется IN. Обратите внимание, что ALTER FUNCTION фактически не учитывает выходные (OUT) параметры, поскольку для определения идентичности функции требуются только входные параметры. Поэтому достаточно перечислить только параметры IN, INOUT и VARIADIC.

argname

Имя параметра. Заметьте, что ALTER FUNCTION фактически не учитывает имена параметров, так как для определения идентичности функции требуются только типы данных параметров.

argtype

Тип данных параметров функции (если есть) (может быть указан с именем схемы).

new_name

Новое имя функции.

new_owner

Новый владелец функции. Обратите внимание, что если функция помечена как SECURITY DEFINER, она будет выполняться от имени нового владельца.

new_schema

Новая схема для этой функции.

CALLED ON NULL INPUT

RETURNS NULL ON NULL INPUT

STRICT

CALLED ON NULL INPUT — изменяет функцию так, чтобы она вызывалась при наличии NULL в одном или нескольких параметрах. RETURNS NULL ON NULL INPUT или STRICT — изменяет функцию так, что если любой из её аргументов равен NULL, функция не будет вызвана; вместо этого автоматически возвращается NULL. Дополнительную информацию см. в описании команды CREATE FUNCTION.

IMMUTABLE

STABLE

VOLATILE

Изменяет степень изменчивости функции на указанное значение. Дополнительную информацию см. в описании команды CREATE FUNCTION.

[ EXTERNAL ] SECURITY INVOKER

[ EXTERNAL ] SECURITY DEFINER

Изменяет, является ли функция функцией с правами определяющего пользователя (security definer). Ключевое слово EXTERNAL игнорируется для обеспечения согласованности с SQL. Дополнительную информацию об этой возможности см. в описании команды CREATE FUNCTION.

LEAKPROOF

Изменяет, считается ли функция защищённой от утечек (leak-proof). Дополнительную информацию об этой возможности см. в описании команды CREATE FUNCTION.

EXECUTE ON ANY

EXECUTE ON MASTER

EXECUTE ON ALL SEGMENTS

EXECUTE ON INITPLAN

Свойство EXECUTE ON определяет место выполнения функции (главный экземпляр или экземпляр сегмента) во время выполнения запроса.
EXECUTE ON ANY (по умолчанию) означает, что функция может выполняться на главном сервере или любом экземпляре сегмента и возвращает одинаковый результат независимо от места выполнения. База данных YMatrix определяет, где именно будет выполняться функция.
EXECUTE ON MASTER означает, что функция должна выполняться только на главном экземпляре.
EXECUTE ON ALL SEGMENTS означает, что при каждом вызове функция должна выполняться на всех основных экземплярах сегментов, но не на главном узле. Общий результат такой функции представляет собой объединение результатов со всех экземпляров сегментов (UNION ALL).
Дополнительную информацию о свойстве EXECUTE ON см. в описании команды CREATE FUNCTION.
EXECUTE ON INITPLAN означает, что функция содержит SQL-операторы, которые необходимо распределить на узлы сегментов для выполнения, и требует специальной обработки со стороны Master, если это возможно.

COST execution_cost

Изменяет оценочную стоимость выполнения функции. Дополнительную информацию см. в описании команды CREATE FUNCTION.

configuration_parameter

value

При вызове функции производится дополнительное или изменённое назначение значения параметра конфигурации. Если указано значение DEFAULT или используется эквивалент R ESET, локальные настройки функции будут удалены, и функция будет выполняться с использованием значений, действующих в её окружении. Используйте RESET ALL, чтобы очистить локальные настройки всех функций. SET FROM CURRENT устанавливает текущее значение сессии приложения на момент входа в функцию.

RESTRICT

Игнорирует стандарт SQL.

Примечание

База данных YMatrix накладывает ограничения, такие как STABLE или VOLATILE, на определённые функции. Дополнительную информацию см. в описании команды CREATE FUNCTION.

Пример

Переименовать функцию sqrt целочисленного типа в square_root:

ALTER FUNCTION sqrt(integer) RENAME TO square_root;

Изменить владельца функции sqrt целочисленного типа на joe:

ALTER FUNCTION sqrt(integer) OWNER TO joe;

Изменить схему функции sqrt целочисленного типа на math:

ALTER FUNCTION sqrt(integer) SET SCHEMA math;

Настроить автоматический путь поиска функции:

ALTER FUNCTION check_password(text) RESET search_path;

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

Данная команда частично совместима с оператором ALTER FUNCTION стандарта SQL. Стандарт позволяет изменять больше свойств функции, но не предусматривает таких возможностей, как переименование функции, пометка функции как SECURITY DEFINER, привязка значений параметров конфигурации к функции или изменение владельца, схемы или степени стабильности функции. В стандарте также требуется ключевое слово RESTRICT, которое в базе данных YMatrix является необязательным.

Смотрите также

CREATE FUNCTION , DROP FUNCTION

← Предыдущая

ALTER_FOREIGN_TABLE

ALTER_GROUP

Русский English 简体中文