DROP FUNCTION
移除一个函数
英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。
当前阅读 PG 18·选择有来源记录的版本
- anchor
- SQL-DROPFUNCTION
- file
- sql-dropfunction.html
- lang
- en
- name
- DROP FUNCTION
- purpose
- remove a function
- purpose zh
- 未知
- sections same as
- 未知
- slug
- 18
- synopsis text
- DROP FUNCTION [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...] [ CASCADE | RESTRICT ]
语法
DROP FUNCTION [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]
[ CASCADE | RESTRICT ]语法图
从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。
版本定义 PG 18
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自动删除依赖于该函数的对象（例如操作符或触发器），以及进一步依赖于这些对象的所有对象（参见第 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比较版本
完整来源事实
synopsis html
DROP FUNCTION [ IF EXISTS ] <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ] [, ...]
[ CASCADE | RESTRICT ]来源引用
定义来源
center · PostgreSQL 18 · a709ab85
正文语言: zh-Hans · 1b5ca64c