DROP PROCEDURE

描述

DROP PROCEDURE移除一个或多个现有过程的定义。要执行此命令，用户必须是这些过程的拥有者。通常必须指定过程的参数类型，因为可能存在多个同名但参数列表不同的过程。

参数

注解

如果给定名称的过程只有一个，则可以省略参数列表。这种情况下连括号也要省略。

在PostgreSQL中，只列出输入参数（包括INOUT）就足够了，因为不允许两个同名例程具有相同的输入参数列表。此外，DROP命令实际上不会检查所写的 OUT参数类型是否正确，因此任何显式标记为 OUT的参数都只是多余信息。不过，为了与相应的 CREATE命令保持一致，仍然建议写上它们。

为了与 SQL 标准兼容，也允许在不写任何 argmode标记的情况下，直接写出全部参数数据类型（包括OUT参数的类型）。这样做时，会核对过程的 OUT参数类型是否与该命令一致。这一规定会带来歧义：当参数列表中不包含 argmode标记时，就不清楚意图采用哪条规则。DROP命令会按两种方式进行查找；如果找到两个不同的过程，就会抛出错误。为了避免这种歧义风险，建议显式写出IN标记，而不是依赖默认值，从而强制采用传统的 PostgreSQL解释。

上面解释的这些查找规则也被其他作用于现有过程的命令使用，例如 ALTER PROCEDURE和COMMENT ON PROCEDURE。

示例

如果只有一个过程do_db_maintenance，则以下命令即可删除它：

DROP PROCEDURE do_db_maintenance;

给定如下过程定义：

CREATE PROCEDURE do_db_maintenance(IN target_schema text, OUT results text) ...

以下任意一条命令都可以删除它：

DROP PROCEDURE do_db_maintenance(IN target_schema text, OUT results text);
DROP PROCEDURE do_db_maintenance(IN text, OUT text);
DROP PROCEDURE do_db_maintenance(IN text);
DROP PROCEDURE do_db_maintenance(text);
DROP PROCEDURE do_db_maintenance(text, text);  -- 可能有歧义

不过，如果还存在例如这样的过程，那么最后一个例子就会有歧义：

CREATE PROCEDURE do_db_maintenance(IN target_schema text, IN options text) ...

兼容性

此命令符合 SQL 标准，但有以下PostgreSQL扩展：

另见