2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 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

DROP FUNCTION

DROP FUNCTION — 删除一个函数

概要

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

描述

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

参数

IF EXISTS

如果函数不存在,则不引发错误。在这种情况下会发出通知。

name

现有函数的名称(可选择模式限定)。如果未指定参数列表,则该名称在其模式中必须是唯一的。

argmode

参数的模式:INOUTINOUTVARIADIC。如果省略,则默认为 IN。请注意,DROP FUNCTION 实际上并不关注 OUT 参数,因为仅输入参数就足以确定函数的身份。因此,列出 ININOUTVARIADIC 参数就足够了。

argname

参数的名称。请注意,DROP FUNCTION 实际上并不关注参数名称,因为仅参数数据类型就足以确定函数的身份。

argtype

函数的参数的数据类型(可选择模式限定),如果有的话。

CASCADE

自动删除依赖于该函数(例如,运算符或触发器)的对象,以及依次依赖于这些对象的所有对象(参见 第 5.15 节)。

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 选项

  • 指定参数模式和名称的能力

提交更正

如果您在文档中发现任何不正确、与您对特定功能的实际使用经验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。