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

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

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本。 PostgreSQL 12 已结束支持。 2024-11-21. 请参阅 当前版本手册.

DROP FUNCTION

DROP FUNCTION — 移除一个函数

大纲

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

描述

DROP FUNCTION 移除一个现有函数的定义。要执行此命令,用户必须是该函数的拥有者。必须指定该函数的参数类型,因为可能存在多个名称相同但参数列表不同的函数。

参数

IF EXISTS

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

name

现有函数的名称(可以用模式限定)。如果没有指定参数列表,这个名称必须在其模式中唯一。

argmode

参数的模式:IN、OUT、INOUT 或 VARIADIC。如果省略,默认值为 IN。注意,DROP FUNCTION 实际上并不关注 OUT 参数,因为确定函数标识只需要输入参数。因此,只列出 IN、INOUT 和 VARIADIC 参数就足够了。

argname

一个参数的名称。注意,DROP FUNCTION 实际上并不关注参数名,因为确定函数标识只需要参数数据类型。

argtype

函数参数的数据类型(如果有,可以用模式限定)。

CASCADE

自动删除依赖于该函数的对象(例如操作符或触发器),以及进一步依赖于这些对象的所有对象(参见第 5.14 节)。

RESTRICT

如果有任何对象依赖于该函数,则拒绝删除它。这是默认值。

示例

此命令删除平方根函数:

DROP FUNCTION sqrt(integer);

在一条命令中删除多个函数:

DROP FUNCTION sqrt(integer), sqrt(bigint);

如果函数名在其模式中是唯一的,就可以在不写参数列表的情况下引用它:

DROP FUNCTION update_employee_salaries;

注意,这不同于

DROP FUNCTION update_employee_salaries();

后者引用的是一个零参数函数,而前一种写法在名称唯一时,可以引用任意参数个数的函数,包括零参数函数。

兼容性

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

  • 标准每条命令只允许删除一个函数。

  • IF EXISTS 选项是扩展。

  • 允许指定参数模式和参数名是扩展。

报告文档问题

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