VastbaseE100

ALTER PROCEDURE

ALTER PROCEDURE - 更改程序的定义

语法格式

ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    action [ ... ] [ RESTRICT ]
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    RENAME TO new_name
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    SET SCHEMA new_schema
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    DEPENDS ON EXTENSION extension_name

其中action是下列之一：

    [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
    SET configuration_parameter { TO | = } { value | DEFAULT }
    SET configuration_parameter FROM CURRENT
    RESET configuration_parameter
    RESET ALL

说明

ALTER PROCEDURE 更改过程的定义。

您必须拥有使用 ALTER PROCEDURE的过程。要更改过程的架构，您还必须具有新架构的 CREATE权限。要更改所有者，您还必须是新拥有角色的直接或间接成员，并且该角色必须具有该过程模式的CREATE 权限。（这些限制强制要求更改所有者不会通过删除和重新创建过程来执行任何操作。但是，超级用户无论如何都可以更改任何过程的所有权。）

参数说明

• name

  现有过程的名称（可选择模式限定）。如果未指定参数说明列表，则名称在其架构中必须是唯一的。

• argmode

  参数说明的模式： IN 或 VARIADIC 。如果省略，则默认为 IN 。

• argname

  参数说明的名称。请注意， ALTER PROCEDURE实际上并未关注参数说明名称，因为只需要参数说明数据类型来确定过程的标识。

• argtype

  过程参数说明的数据类型（可选择模式限定），如果有的话。

• new_name

  程序的新名称。

• new_owner

  程序的新所有者。请注意，如果该过程标记为 SECURITY DEFINER，则它将随后作为新所有者执行。

• new_schema

  该过程的新架构。

• extension_name

  过程依赖的扩展名。

• [ EXTERNAL ] SECURITY INVOKER/[ EXTERNAL ] SECURITY DEFINER

  更改过程是否为安全定义者。 SQL一致性忽略关键字 EXTERNAL。有关此功能的更多信息，请参见 CREATE PROCEDURE。

• configuration_parameter

  在调用过程时，添加或更改要对配置参数说明进行的分配。如果 value 是DEFAULT 或等效地使用 RESET，则删除过程本地设置，以便过程使用其环境中存在的值执行。使用 RESET ALL清除所有过程本地设置。 SET FROM CURRENT 将执行 ALTER PROCEDURE 时当前参数说明的值保存为输入过程时要应用的值。

• RESTRICT

  忽略与SQL标准的一致性。

示例

要使用 integer 类型的两个参数说明将过程 insert_data 重命名为insert_record ：

ALTER PROCEDURE insert_data(integer, integer) RENAME TO insert_record;

要使用 integer 到 joe 类型的两个参数说明更改过程 insert_data 的所有者：

ALTER PROCEDURE insert_data(integer, integer) OWNER TO joe;

要使用 integer 到 accounting 类型的两个参数说明更改过程 insert_data的模式：

ALTER PROCEDURE insert_data(integer, integer) SET SCHEMA accounting;

要将过程 insert_data(integer, integer) 标记为依赖于扩展 myext ：

ALTER PROCEDURE insert_data(integer, integer) DEPENDS ON EXTENSION myext;

要调整为过程自动设置的搜索路径：

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

要禁用程序的 search_path 的自动设置：

ALTER PROCEDURE check_password(text) RESET search_path;

现在，该过程将使用其调用者使用的任何搜索路径执行。