ALTER FUNCTION

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}
{[EXTERNAL] SECURITY INVOKER | [EXTERNAL] SECURITY DEFINER}
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, or 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 将该函数改为在某些 或者全部参数为空值时可以被调用。 RETURNS NULL ON NULL INPUT 或者STRICT c更改函数,以便如果其任何参数为空,则不会调用该函数; 而是自动假设一个空的结果。 参阅 CREATE FUNCTION 获取更多信息
IMMUTABLE
STABLE
VOLATILE
将函数的波动性改为指定的设置。参阅 CREATE FUNCTION 以便问题得以解决
[ EXTERNAL ] SECURITY INVOKER
[ EXTERNAL ] SECURITY DEFINER
更改该函数是否为一个安全性定义者。 关键词EXTERNAL 为了SQL的一致性而被忽略。 参阅 CREATE FUNCTION 获取更多有关此功能的信息。
COST execution_cost
更改该函数的估计执行代价。参阅 CREATE FUNCTION 获取更多信息。
configuration_parameter
value
当该函数被调用时,要对一个配置参数做出增加或者更改的赋值。如果 valueDEFAULT 或者, 等价的 RESET 被使用, 该函数本地的设置将会被 移除,这样该函数会使用其环境中存在的值执行。 使用 RESET ALL 可以清除所有函数本地的设置。 SET FROM CURRENT 应用会话的当前值当函数被输入时。
RESTRICT
忽略SQL标准。

注意

Greenplum数据库对某些定义的函数有STABLE或者VOLATILE这样的限制。参阅 CREATE FUNCTION 获取更多信息。

示例

integer类型的函数sqrt 重命名为 square_root:

ALTER FUNCTION sqrt(integer) RENAME TO square_root;

更改integer 类型的 sqrt 函数的所有者为 joe:

ALTER FUNCTION sqrt(integer) OWNER TO joe;

更改integer 类型的函数 sqrt模式math:

ALTER FUNCTION sqrt(integer) SET SCHEMA math;

要调整一个函数的自动搜索路径:

ALTER FUNCTION check_password(text) RESET search_path;

兼容性

这个语句部分兼容 SQL 标准中的 ALTER FUNCTION 语句。该标准允许修改一个函数的更多属性,但是不提供重命名一个函数、标记一个函数为安全性定义者、为一个函数附加配置参数值或者更改一个函数的拥有者、模式或者稳定性等功能。 该标准还需要 RESTRICT 关键字, 它在Greenplum数据库中是可选的。