DROP FUNCTION

Aplica-se a:marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

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

Permissions

Para dropar uma função no Unity Catalog, você deve ter o MANAGE privilégio sobre a função ou ser seu proprietário, além USE CATALOG de ser no catálogo e USE SCHEMA no esquema onde a função reside.

De acordo com a hierarquia de objetos, os proprietários do esquema pai ou catálogo e usuários com MANAGE qualquer um deles também podem executar essa operação. Os privilégios de uso que eles precisam dependem do nível do objeto no qual detêm a propriedade ou MANAGE. Veja Requisitos de privilégio de uso 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.

  • TEMPORARY

    Usado para excluir uma função TEMPORARY.

  • SE EXISTIR

    Se especificado, nenhuma exceção é gerada 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 em