受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

DROP FUNCTION

DROP FUNCTION — 移除一个函数

Synopsis

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

自动删除依赖于该函数的对象(例如操作符或触发器),以及进一步依赖于这些对象的所有对象 (参见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选项是扩展。

  • 允许指定参数模式和参数名是扩展。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。