DROP FUNCTION

Aplica-se a:Marcado como Sim Databricks SQL Marcado como Sim Databricks Runtime

Descarta uma função definida pelo usuário (UDF) temporária ou permanente.

Permissions

Para eliminar uma função no Unity Catalog, deve ter o MANAGE privilégio sobre a função ou ser o seu proprietário, bem como USE CATALOG sobre o catálogo e USE SCHEMA sobre o esquema onde a função reside.

De acordo com a hierarquia de objetos, os proprietários do esquema pai ou catálogo e os utilizadores com MANAGE em qualquer um também podem realizar esta operação. Os privilégios de utilização de que necessitam dependem do nível do objeto a que detêm a propriedade ou MANAGE. Veja Requisitos de privilégios de utilização para MANAGE.

Sintaxe

DROP [ TEMPORARY ] FUNCTION [ IF EXISTS ] function_name

Parâmetros

  • function_name

    O nome de uma função existente. O nome da função pode ser opcionalmente qualificado com um nome de esquema.

  • TEMPORÁRIO

    Usado para excluir uma TEMPORARY função.

  • SE EXISTE

    Se especificado, nenhuma exceção é lançada quando a função não existe.

Exemplos

-- 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;
  • Última atualização a