ALTER FUNCTION

修改函数定义。

语法


ALTER FUNCTION <name> [ ( [ [<arg_mode>] [<arg_name>] <arg_type> [, ...] ] ) ] 
   <action> [, ... ] [RESTRICT]
 
ALTER FUNCTION <name> [ ( [ [<arg_mode>] [<arg_name>] <arg_type> [, ...] ] ) ]
   RENAME TO <new_name>
 
ALTER FUNCTION <name> [ ( [ [<arg_mode>] [<arg_name>] <arg_type> [, ...] ] ) ]
   OWNER TO { <new_owner> | CURRENT_USER | SESSION_USER }
 
ALTER FUNCTION <name> [ ( [ [<arg_mode>] [<arg_name>] <arg_type> [, ...] ] ) ]
   SET SCHEMA <new_schema>
 
ALTER FUNCTION <name> [ ( [ [<arg_mode>] [<arg_name>] <arg_type> [, ...] ] ) ]
   DEPENDS ON EXTENSION <extension_name>
 
其中 <action> 可以为：
 
    { CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT }
    { IMMUTABLE | STABLE | VOLATILE }
    { [EXTERNAL] SECURITY INVOKER | [EXTERNAL] SECURITY DEFINER }
    PARALLEL { UNSAFE | RESTRICTED | SAFE }
    COST <execution_cost>
    ROWS <result_rows>
    SET <config_param> { TO | = } { <value> | DEFAULT }
    SET <config_param> FROM CURRENT
    RESET <config_param>
    RESET ALL

描述

只有函数所有者才能使用 ALTER FUNCTION 来修改函数定义。

如需修改函数的 Schema，你必须拥有新 Schema 的 CREATE 权限。

如需更改函数的所有者，你必须是新所有角色的直接或间接成员，并对函数的 Schema 有 CREATE 权限。

参数

<name>

函数的名称，支持使用 Schema 名称进行限定。如果该函数不带参数，其名称在其 Schema 中必须唯一。
<arg_mode>

参数的模式。支持的值包括 IN、OUT、INOUT 和 VARIADIC。如不指定，则使用默认值 IN。 OUT 参数参数无需列出，因为 ALTER FUNCTION 只使用输入参数来进行函数识别。
<arg_name>

参数的名称。

注意，ALTER FUNCTION 是通过参数的数据类型来识别函数的，而非参数名称。
<arg_type>

参数的数据类型。
<action>

对函数执行的操作，支持的操作包括：
- CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT：确定函数是否可以在其有 null 参数时被调用。CALLED ON NULL INPUT 表示可以调用，RETURNS NULL ON NULL INPUT 或 STRICT 表示不可以调用。
  
  更多信息，请参考 CREATE FUNCTION。
- IMMUTABLE、STABLE 或 VOLATILE：指定函数的易变性。
  
  更多信息，请参考 CREATE FUNCTION。
- [EXTERNAL] SECURITY INVOKER | [EXTERNAL] SECURITY DEFINER：指定函数是否为安全定义者 (Security Definer)。关键词 EXTERNAL 可以忽略。
  
  更多信息，请查看 CREATE FUNCTION。
- PARALLEL：指定函数是否被认为是安全并行执行函数。
  
  更多信息，请查看 CREATE FUNCTION。
- COST：指定函数的预估执行成本。
  
  更多信息，请查看 CREATE FUNCTION。
- SET 或 RESET：指定当函数被调用时配置参数 <config_param> 的 <value>。如果 SET 选项的值为 DEFAULT 或使用 RESET 选项，则删除函数范围的设置并使用环境中的值替代。如果你指定 SET ... FROM CURRENT，则当你运行 ALTER FUNCTION 时参数的当前值将被用作函数的值。如果你想清除所有特定于函数的设置，使用 RESET ALL。
RESTRICT

忽略以符合 SQL 标准。
<new_name>

函数的新名称。
<new_owner>

函数的新所有者。
<new_schema>

函数的新 Schema。
<extension_name>

函数依赖的扩展的名称。

示例

将 text 类型的函数 countall 重命名为 count_all：


ALTER FUNCTION countall(text) RENAME TO count_all;

更改 text 类型的函数 count_all 的所有者为 mary@example.com：


ALTER FUNCTION count_all(text) OWNER TO "mary@example.com";

将 text 类型的函数 count_all 的 Schema 改为 public：


ALTER FUNCTION count_all(text) SET SCHEMA public;

标记 text 类型的函数 count_all 依赖于扩展 gp_exttable_fdw：


ALTER FUNCTION count_all(text) DEPENDS ON EXTENSION gp_exttable_fdw;

将 text 类型的函数 count_all 的搜索路径更改为 DEFAULT：


ALTER FUNCTION count_all(text) SET search_path to DEFAULT;

SQL 标准兼容性

MAXIR 中的 ALTER FUNCTION 与标准 SQL ALTER FUNCTION 部分兼容。标准 SQL ALTER FUNCTION 允许你修改函数的更多属性，而 MAXIR 中的 ALTER FUNCTION 允许你更改函数的名称、所有者、Schema 和易变性，更改函数的配置参数的默认值，使函数成为安全定义者。此外，标准 SQL 中 RESTRICT 关键字是必需的，但在 MAXIR 中可以省略。