DROP FUNCTION

適用於:勾選為「是」Databricks SQL 勾選為「是」Databricks Runtime

刪除暫時或永久的使用者定義函式(UDF)。

許可

要在 Unity 目錄中丟棄函式,你必須擁有 MANAGE 該函式的權限或是其擁有者,並且 USE CATALOG 同時擁有該函式所在的目錄和 USE SCHEMA 結構。

根據 物件階層結構,父架構或目錄的擁有者以及擁有 MANAGE 任一的使用者也能執行此操作。 他們所需的使用權限取決於他們所擁有的所有權或 MANAGE。 參見 的MANAGE使用權限要求。

語法

DROP [ TEMPORARY ] FUNCTION [ IF EXISTS ] function_name

參數

  • function_name

    現有函式的名稱。 函式名稱可能選擇性地以架構名稱限定。

  • 臨時

    用來刪除函數 TEMPORARY。

  • 如果存在

    如果指定,當函式不存在時,不會擲回任何例外狀況。

範例

-- Create a permanent function `hello`
> CREATE FUNCTION hello() RETURNS STRING RETURN 'Hello World!';

-- Create a temporary function `hello`
> CREATE TEMPORARY FUNCTION hello() RETURNS STRING RETURN 'Good morning!';

-- List user functions
> SHOW USER FUNCTIONS;
  default.hello
          hello

-- Drop a permanent function
> DROP FUNCTION hello;

-- Try to drop a permanent function which is not present
> DROP FUNCTION hello;
Error: ROUTINE_NOT_FOUND

-- List the functions after dropping, it should list only temporary function
> SHOW USER FUNCTIONS;
 hello

-- Drop a temporary function if exists
> DROP TEMPORARY FUNCTION IF EXISTS hello;