↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

DROP ROUTINE

移除一个例程

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-DROPROUTINE
file
sql-droproutine.html
lang
en
name
DROP ROUTINE
purpose
remove a routine
purpose zh
未知
sections same as
未知
slug
18
synopsis text
DROP ROUTINE [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...] [ CASCADE | RESTRICT ]

语法

DROP ROUTINE [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]
[ CASCADE | RESTRICT ]
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

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

版本定义 PG 18

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

描述

DROP ROUTINE移除一个或多个现有例程的定义。术语“例程”包括聚合函数、普通函数和过程。关于参数的说明、更多示例以及进一步细节,请分别参见DROP AGGREGATE、DROP FUNCTION和DROP PROCEDURE。

注解

DROP ROUTINE所使用的查找规则,从根本上说与 DROP PROCEDURE相同;特别是,DROP ROUTINE与该命令一样:如果参数列表中没有 argmode标记,就会认为它可能采用 SQL 标准的定义,即将OUT参数也包含在列表中。(DROP AGGREGATE和DROP FUNCTION不会这样。)

在某些不同种类的例程共享同一名称的情况下,DROP ROUTINE 可能会因为歧义错误而失败,而更具体的命令(DROP FUNCTION等)则可以工作。更仔细地指定参数类型列表,同样可以解决这类问题。

这些查找规则也被其他作用于现有例程的命令使用,例如 ALTER ROUTINE和COMMENT ON ROUTINE。

示例

删除参数类型为integer的例程foo:

DROP ROUTINE foo(integer);

不管foo是聚合函数、普通函数还是过程,这条命令都可以工作。

兼容性

此命令符合 SQL 标准,但有以下PostgreSQL扩展:

  • 标准每条命令只允许删除一个例程。

  • IF EXISTS选项是扩展。

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

  • 用户可定义的聚合函数是扩展。

另见

DROP AGGREGATE, DROP FUNCTION, DROP PROCEDURE, ALTER ROUTINE

注意,没有CREATE ROUTINE命令。

比较版本

完整来源事实

synopsis html

DROP ROUTINE [ IF EXISTS ] <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ] [, ...]
    [ CASCADE | RESTRICT ]

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c