DROP FUNCTION

DROP FUNCTION — 移除一個函數

語法

  1. DROP FUNCTION [ IF EXISTS ] name
  2. [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
  3. [, ...]
  4. [ CASCADE | RESTRICT ]

說明

DROP FUNCTION 移除現有函數的定義。要執行此命令,使用者必須是該函數的擁有者。必須指定該函數的參數類型,因為可能存在多個具有相同名稱和不同參數列表的不同函數。

參數

IF EXISTS

如果函數不存在,不要拋出錯誤。在這種情況下發布 NOTICE。

name

現有函數的名稱(可以加上綱要)。如果未指定參數列表,則該名稱在其綱要中必須是唯一的。

argmode

參數的模式:IN、OUT、INOUT 或 VARIADIC。如果省略,則預設為 IN。請注意,DROP FUNCTION 實際上並不關注 OUT 參數,因為只需要輸入參數來確定函數的身份。所以列出 IN、INOUT 和 VARIADIC 參數就足夠了。

argname

參數的名稱。 請注意,DROP FUNCTION 實際上並不關注參數名稱,因為只需要參數資料型別來確定函數的身份。

argtype

如果有的話,函數參數的資料型別(可加上綱要)。

CASCADE

自動刪除依賴於該功能的物件(如運算子或觸發器),並依次移除依賴於這些物件的所有物件(請參閱第 5.13 節)。

RESTRICT

如果任何物件依賴於它,拒絕移除該函數。這是預設的做法。

範例

此指令移除平方根函數:

  1. DROP FUNCTION sqrt(integer);

在一個指令中刪除多個函數:

  1. DROP FUNCTION sqrt(integer), sqrt(bigint);

如果函數名稱在其綱要中是唯一的,則可以在不帶參數列表的情況下引用它:

  1. DROP FUNCTION update_employee_salaries;

請注意,這不同於

  1. DROP FUNCTION update_employee_salaries();

它指的是一個零個參數的函數,而第一個變形可以引用具有任意數量參數的函數,包括零個,只要該名稱是唯一的。

相容性

這個指令符合 SQL 標準,並帶有這些 PostgreSQL 的延伸功能:

  • 原標準只允許每個指令刪除一個函數。
  • 具有 IF EXISTS 選項
  • 能夠指定參數模式和名稱

參閱

CREATE FUNCTION, ALTER FUNCTION