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
ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
DEPENDS ON EXTENSION extension_name
其中 action 是以下之一：
CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF
[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
PARALLEL { UNSAFE | RESTRICTED | SAFE }
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
参数说明的模式： IN ， OUT ， INOUT 或 VARIADIC 。如果省略，则默认为 IN。请注意， ALTER FUNCTION 实际上并未关注 OUT 参数说明，因为只需要输入参数说明来确定函数的标识。因此，列出 IN ， INOUT和 VARIADIC 参数说明就足够了。
argname
参数说明的名称。请注意， ALTER FUNCTION实际上并不关注参数说明名称，因为只需要参数说明数据类型来确定函数的标识。
argtype
函数参数说明的数据类型（可选择模式限定），如果有的话。
new_name
函数的新名称。
new_owner
该函数的新所有者。请注意，如果该函数标记为 SECURITY DEFINER，则它将随后作为新所有者执行。
new_schema
该函数的新架构。
extension_name
该函数依赖的扩展名。
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
将函数的易变性更改为指定的设置。有关详细信息，请参阅 CREATEFUNCTION。
[ EXTERNAL ] SECURITY INVOKER/[ EXTERNAL ] SECURITY DEFINER
更改功能是否为安全定义者。 SQL一致性忽略关键字 EXTERNAL。有关此功能的更多信息，请参见 CREATE FUNCTION。
PARALLEL
更改函数是否被认为是并行安全的。有关详细信息，请参阅 CREATEFUNCTION。
LEAKPROOF
更改功能是否被视为防漏。有关此功能的更多信息，请参见 CREATEFUNCTION。
COST execution_cost
更改函数的估计执行成本。有关更多信息，请参阅 CREATE FUNCTION。
ROWS result_rows
更改set-returns函数返回的估计行数。有关更多信息，请参阅 CREATEFUNCTION。
configuration_parameter
添加或更改调用函数时要对配置参数说明进行的分配。如果 value 是 DEFAULT或等效地使用 RESET，则删除函数本地设置，以便函数使用其环境中存在的值执行。使用 RESET ALL清除所有功能本地设置。 SET FROM CURRENT 将执行 ALTER FUNCTION时当前参数说明的值保存为输入功能时要应用的值。
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;
要将类型 integer 的函数 sqrt 标记为依赖于扩展名 mathlib ：
ALTER FUNCTION sqrt(integer) DEPENDS ON EXTENSION mathlib;
至调整为函数自动设置的搜索路径：
ALTER FUNCTION check_password(text) SET search_path = admin, pg_temp;
要禁用函数的 search_path 的自动设置：
ALTER FUNCTION check_password(text) RESET search_path;
该函数现在将使用其调用者使用的任何搜索路径执行。
