预发布版本文档。 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选项是扩展。允许指定参数模式和参数名是扩展,而且在给出模式时查找规则也有所不同。
用户可定义的聚合函数是扩展。