Skip to content

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

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

另请参见

CREATE FUNCTIONALTER FUNCTIONDROP PROCEDUREDROP ROUTINE