SQL COMMAND · 函数与过程
DROP PROCEDURE
移除一个过程
DROP函数与过程引入 11现存至 20 devel0 次语法变更
- 动词
DROP- 对象
PROCEDURE- 分组
- 函数与过程
- 引入版本
- 11
- 状态
- 现存
- 语法变更次数
- 0
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
DROP PROCEDURE [ IF EXISTS ]name[ ( [ [argmode] [argname]argtype[, ...] ] ) ] [, ...] [ CASCADE | RESTRICT ]
描述
DROP PROCEDURE移除一个或多个现有过程的定义。 要执行此命令,用户必须是这些过程的拥有者。通常必须指定过程的参数类型, 因为可能存在多个同名但参数列表不同的过程。
参数
IF EXISTS如果该过程不存在,则不要抛出错误。这种情况下会发出一个提示。
name现有过程的名称(可带模式限定)。
argmode参数的模式:
IN、OUT、INOUT或VARIADIC。如果省略, 默认为IN(但见下文)。argname参数名称。注意,
DROP PROCEDURE实际上并不关心参数名,因为确定过程标识时只使用参数数据类型。argtype过程参数的数据类型(如果有,可带模式限定)。详见下文。
CASCADE自动删除依赖于该过程的对象,以及进一步依赖于这些对象的所有对象 (参见Section 5.15)。
RESTRICT如果有任何对象依赖于该过程,则拒绝删除它。这是默认值。
注解
如果给定名称的过程只有一个,则可以省略参数列表。这种情况下连括号也要省略。
在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扩展:
标准每条命令只允许删除一个过程。
IF EXISTS选项是扩展。允许指定参数模式和参数名是扩展,而且在给出模式时查找规则也有所不同。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 20← 19正文更新
正文更新PostgreSQL 19← 18正文更新
正文更新PostgreSQL 14← 13正文更新
正文更新PostgreSQL 12← 11正文更新
正文更新PostgreSQL 11← 10新增此命令
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
CALL | CALL | — | — | |
| 调用一个过程 | 现存 | |||
DO | DO | — | — | |
| 执行匿名代码块 | 现存 | |||
CREATE AGGREGATE | CREATE | AGGREGATE | 203 次 | |
| 定义一个新的聚合函数 | 现存 | |||
ALTER AGGREGATE | ALTER | AGGREGATE | 141 次 | |
| 更改一个聚合函数的定义 | 现存 | |||
DROP AGGREGATE | DROP | AGGREGATE | — | |
| 移除一个聚合函数 | 现存 | |||
CREATE FUNCTION | CREATE | FUNCTION | 143 次 | |
| 定义一个新函数 | 现存 | |||
ALTER FUNCTION | ALTER | FUNCTION | 143 次 | |
| 更改函数的定义 | 现存 | |||
DROP FUNCTION | DROP | FUNCTION | — | |
| 移除一个函数 | 现存 | |||
CREATE LANGUAGE | CREATE | LANGUAGE | 131 次 | |
| 定义一种新的过程语言 | 现存 | |||
ALTER LANGUAGE | ALTER | LANGUAGE | 141 次 | |
| 更改一种过程语言的定义 | 现存 | |||
DROP LANGUAGE | DROP | LANGUAGE | — | |
| 移除一种过程语言 | 现存 | |||
CREATE PROCEDURE | CREATE | PROCEDURE | 141 次 | |
| 定义一个新过程 | 现存 | |||
ALTER PROCEDURE | ALTER | PROCEDURE | 142 次 | |
| 更改过程的定义 | 现存 | |||
DROP PROCEDURE | DROP | PROCEDURE | — | |
| 移除一个过程 | 现存 | |||
ALTER ROUTINE | ALTER | ROUTINE | 142 次 | |
| 更改一个例程的定义 | 现存 | |||
DROP ROUTINE | DROP | ROUTINE | — | |
| 移除一个例程 | 现存 | |||
CREATE TRANSFORM | CREATE | TRANSFORM | — | |
| 定义一个新的转换 | 现存 | |||
DROP TRANSFORM | DROP | TRANSFORM | — | |
| 移除一个转换 | 现存 | |||