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
当该函数被调用时,要对一个配置参数做出增加或者更改的赋值。如果
value 是 DEFAULT
或者, 等价的
RESET
被使用, 该函数本地的设置将会被 移除,这样该函数会使用其环境中存在的值执行。 使用 RESET
ALL
可以清除所有函数本地的设置。 SET FROM CURRENT
应用会话的当前值当函数被输入时。
RESTRICT
忽略SQL标准。
注意
Greenplum数据库对某些定义的函数有STABLE
或者VOLATILE
这样的限制。参阅 [CREATE FUNCTION](CREATE_FUNCTION.html#topic1)
获取更多信息。
示例
将 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数据库中是可选的。
另见
[CREATE FUNCTION](CREATE_FUNCTION.html#topic1)
,
[DROP FUNCTION](DROP_FUNCTION.html#topic1)
上级主题: SQL命令参考