9.3 9.4 9.5 9.6 10 11 12 13
阿里云PostgreSQL 问题报告 纠错本页面

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 | CURRENT_USER | SESSION_USER }
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
    COST execution_cost
    ROWS result_rows
    SET configuration_parameter { TO | = } { value | DEFAULT }
    SET configuration_parameter FROM CURRENT
    RESET configuration_parameter
    RESET ALL

描述

ALTER FUNCTION更改一个函数的定义。

你必须拥有该函数以使用ALTER FUNCTION。 要更改一个函数的模式,你还必须具有新模式上的CREATE权限。 要更改拥有者,你还必须是新拥有角色的一个直接或者间接成员,并且该角色必须 具有在该函数的模式上的CREATE权限(这些限制强制修改拥有 者不能通过删除和重建函数做任何不能做的事情。不过, 一个超级用户可以更改任何函数的所有权)。

参数

name

一个现有函数的名称(可以被模式限定)。

argmode

一个参数的模式:INOUTINOUT或者VARIADIC。如果被忽略,默认为 IN。注意ALTER FUNCTION 并不真正关心OUT参数,因为在决定函数的身份时只需要输入参数。 因此列出ININOUT以及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 将该函数改为只要任一参数为空值就不被调用而是自动假定一个空值结果。 详见CREATE FUNCTION

IMMUTABLE
STABLE
VOLATILE

把该函数的稳定性更改为指定的设置。详见 CREATE FUNCTION

[ EXTERNAL ] SECURITY INVOKER
[ EXTERNAL ] SECURITY DEFINER

更改该函数是否为一个安全定义器。关键词EXTERNAL 是为了符合 SQL,它会被忽略。关于这个功能的详情请见 CREATE FUNCTION

LEAKPROOF

更改该函数是否被认为是防泄漏的。关于这个功能的详情请见 CREATE FUNCTION

COST execution_cost

更改该函数的估计执行代价。详见CREATE FUNCTION

ROWS result_rows

更改一个设置返回函数返回的估计行数。详见 CREATE FUNCTION

configuration_parameter
value

当该函数被调用时,添加或者更改对配置参数值的配置。 如果valueDEFAULT 或者使用等价的RESET,该函数本地的设置将会被移除, 这样该函数会使用其环境中存在的值执行。使用RESET ALL 可以清除所有函数本地的设置。SET FROM CURRENT 把会话中该参数的当前值保存为进入该函数时要应用的值。

有关允许的参数名称和值可详见SET以及 第 18 章

RESTRICT

为了符合 SQL 标准,被忽略。

示例

要把用于类型integer的函数sqrt 重命名为square_root

ALTER FUNCTION sqrt(integer) RENAME TO square_root;

要把用于类型integer的函数sqrt 的拥有者改为joe

ALTER FUNCTION sqrt(integer) OWNER TO joe;

要把用于类型integer的函数sqrt 的模式改为maths

ALTER FUNCTION sqrt(integer) SET SCHEMA maths;

要调整自动为函数设置的搜索路径:

ALTER FUNCTION check_password(text) SET search_path = admin, pg_temp;

要禁止一个函数的search_path的自动设置:

ALTER FUNCTION check_password(text) RESET search_path;

这个函数将用其调用者使用的搜索路径来执行。

兼容性

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

另见

CREATE FUNCTION, DROP FUNCTION
<
/BODY >