DROP FUNCTION

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime

Zahodí dočasnou nebo trvalou uživatelem definovanou funkci (UDF).

Permissions

Pro zařazení funkce do Unity Catalog musíte mít MANAGE oprávnění na funkci nebo být jejím vlastníkem, stejně jako USE CATALOG na katalog a USE SCHEMA na schéma, kde funkce sídlí.

V hierarchii objektů můžou tuto operaci provést také vlastníci nadřazeného schématu nebo katalogu nebo katalogu a uživatelé, se MANAGE kterými jsou. Oprávnění k použití, která potřebují, závisí na úrovni objektu, na které drží vlastnictví, nebo MANAGE. Viz požadavky na oprávnění použití pro MANAGE.

Syntaxe

DROP [ TEMPORARY ] FUNCTION [ IF EXISTS ] function_name

Parametry

  • function_name

    Název existující funkce. Název funkce může být volitelně upřesněn názvem schématu.

  • DOČASNÝ

    Slouží k odstranění TEMPORARY funkce.

  • POKUD EXISTUJE

    Pokud je zadána možnost, není vyvolána žádná výjimka, když funkce neexistuje.

Příklady

-- 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;