支持的版本:当前 (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 选项

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

提交更正

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