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

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

提交更正

如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符,或者需要进一步说明,请使用此表单报告文档问题。