PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

DROP FUNCTION

DROP FUNCTION — 删除一个函数

Synopsis

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

自动删除依赖于该函数的对象(例如操作符或触发器),并进而删除所有依赖于这些对象的对象(参见 Section 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 选项

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

另请参阅

CREATE FUNCTION, ALTER FUNCTION, DROP PROCEDURE, DROP ROUTINE