选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

文档 / SQL 命令 / 函数与过程

SQL COMMAND · 函数与过程

DROP PROCEDURE

移除一个过程

DROP函数与过程引入 11现存至 20 devel0 次语法变更

动词
DROP
对象
PROCEDURE
引入版本
11
状态
现存
语法变更次数
0
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

DROP PROCEDURE IF EXISTS name ( argmode argname argtype , ) , CASCADE RESTRICT

语法概要

DROP PROCEDURE [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]
    [ CASCADE | RESTRICT ]

PostgreSQL 18 手册 · 查看完整参考页

描述

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

参数

IF EXISTS

如果该过程不存在,则不要抛出错误。这种情况下会发出一个提示。

name

现有过程的名称(可带模式限定)。

argmode

参数的模式:INOUTINOUTVARIADIC。如果省略, 默认为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 PROCEDURECOMMENT 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选项是扩展。

  • 允许指定参数模式和参数名是扩展,而且在给出模式时查找规则也有所不同。

另见

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 20← 19正文更新

    正文更新
  2. PostgreSQL 19← 18正文更新

    正文更新
  3. PostgreSQL 14← 13正文更新

    正文更新
  4. PostgreSQL 12← 11正文更新

    正文更新
  5. PostgreSQL 11← 10新增此命令

同组命令

命令动词对象版本变动最近变更
FUNCTIONS & PROCEDURES函数与过程18 条
CALLCALL
调用一个过程现存
DODO
执行匿名代码块现存
CREATE AGGREGATECREATEAGGREGATE 203 次
定义一个新的聚合函数现存
ALTER AGGREGATEALTERAGGREGATE 141 次
更改一个聚合函数的定义现存
DROP AGGREGATEDROPAGGREGATE
移除一个聚合函数现存
CREATE FUNCTIONCREATEFUNCTION 143 次
定义一个新函数现存
ALTER FUNCTIONALTERFUNCTION 143 次
更改函数的定义现存
DROP FUNCTIONDROPFUNCTION
移除一个函数现存
CREATE LANGUAGECREATELANGUAGE 131 次
定义一种新的过程语言现存
ALTER LANGUAGEALTERLANGUAGE 141 次
更改一种过程语言的定义现存
DROP LANGUAGEDROPLANGUAGE
移除一种过程语言现存
CREATE PROCEDURECREATEPROCEDURE 141 次
定义一个新过程现存
ALTER PROCEDUREALTERPROCEDURE 142 次
更改过程的定义现存
DROP PROCEDUREDROPPROCEDURE
移除一个过程现存
ALTER ROUTINEALTERROUTINE 142 次
更改一个例程的定义现存
DROP ROUTINEDROPROUTINE
移除一个例程现存
CREATE TRANSFORMCREATETRANSFORM
定义一个新的转换现存
DROP TRANSFORMDROPTRANSFORM
移除一个转换现存