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

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

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11
预发布版本文档。 PostgreSQL 19beta4 为测试版本,最终发布内容可能有所不同。

DROP ROUTINE

DROP ROUTINE — 移除一个例程

大纲

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 命令。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.