ALTER FUNCTION — 更改函数的定义
ALTER FUNCTIONname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ]action
[ ... ] [ RESTRICT ] ALTER FUNCTIONname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] RENAME TOnew_name
ALTER FUNCTIONname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] OWNER TO {new_owner
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER FUNCTIONname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] SET SCHEMAnew_schema
ALTER FUNCTIONname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] [ NO ] DEPENDS ON EXTENSIONextension_name
whereaction
is one of: 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 } COSTexecution_cost
ROWSresult_rows
SUPPORTsupport_function
SETconfiguration_parameter
{ TO | = } {value
| DEFAULT } SETconfiguration_parameter
FROM CURRENT RESETconfiguration_parameter
RESET ALL
ALTER FUNCTION
更改函数的定义。
要使用 ALTER FUNCTION
,您必须拥有该函数。要更改函数的模式,您还必须在新的模式上拥有 CREATE
权限。要更改所有者,您必须能够 SET ROLE
为新的拥有角色,并且该角色必须在函数的模式上拥有 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
函数的新模式。
DEPENDS ON EXTENSION extension_name
NO DEPENDS ON EXTENSION extension_name
此形式将函数标记为依赖于扩展,或者如果指定了 NO
,则不再依赖于该扩展。被标记为依赖于扩展的函数将在扩展被删除时被删除,即使没有指定 CASCADE
。一个函数可以依赖于多个扩展,并且将在任何一个扩展被删除时被删除。
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
更改函数是安全定义者还是非安全定义者。为符合 SQL 标准,关键词 EXTERNAL
被忽略。有关此功能的信息,请参阅 CREATE FUNCTION。
PARALLEL
更改函数是否被视为可并行执行。有关详细信息,请参阅 CREATE FUNCTION。
LEAKPROOF
更改函数是否被视为 leakproof。有关此功能的信息,请参阅 CREATE FUNCTION。
COST
execution_cost
更改函数的估计执行成本。有关更多信息,请参阅 CREATE FUNCTION。
ROWS
result_rows
更改返回集函数的估计返回行数。有关更多信息,请参阅 CREATE FUNCTION。
SUPPORT
support_function
设置或更改此函数使用的查询计划器支持函数。有关详细信息,请参阅 第 36.11 节。您必须是超级用户才能使用此选项。
此选项不能用于完全删除支持函数,因为它必须命名一个新的支持函数。如果您需要这样做,请使用 CREATE OR REPLACE FUNCTION
。
configuration_parameter
value
添加或更改在调用函数时要对配置参数进行的赋值。如果 value
是 DEFAULT
或等效地使用 RESET
,则移除函数本地设置,以便函数在其环境中存在的 value
下执行。使用 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;
函数现在将使用其调用者使用的搜索路径执行。
此语句与 SQL 标准中的 ALTER FUNCTION
语句部分兼容。标准允许修改函数的更多属性,但不能重命名函数、将函数设置为安全定义者、将配置参数值附加到函数,或更改函数的拥有者、模式或易变性。标准还要求 RESTRICT
关键字,在 PostgreSQL 中是可选的。
如果您在文档中发现任何不正确、不符合您的功能体验或需要进一步澄清的内容,请使用 此表格 报告文档问题。