Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
DROP FUNCTION(7)	  PostgreSQL 18.6 Documentation 	DROP FUNCTION(7)

NAME
     DROP_FUNCTION - remove a function

SYNOPSIS
     DROP FUNCTION [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]
	 [ CASCADE | RESTRICT ]

DESCRIPTION
     DROP  FUNCTION  removes  the definition of an existing function. To execute
     this command the user must be the owner of the function. The argument types
     to the function must be specified, since several  different  functions  can
     exist with the same name and different argument lists.

PARAMETERS
     IF EXISTS
	 Do  not  throw an error if the function does not exist. A notice is is-
	 sued in this case.

     name
	 The name (optionally schema-qualified) of an existing function.  If  no
	 argument list is specified, the name must be unique in its schema.

     argmode
	 The  mode  of an argument: IN, OUT, INOUT, or VARIADIC. If omitted, the
	 default is IN. Note that DROP FUNCTION does not actually pay any atten-
	 tion to OUT arguments, since only the input arguments are needed to de-
	 termine the function's identity. So it is sufficient to  list	the  IN,
	 INOUT, and VARIADIC arguments.

     argname
	 The  name of an argument. Note that DROP FUNCTION does not actually pay
	 any attention to argument names, since only the argument data types are
	 needed to determine the function's identity.

     argtype
	 The data type(s) of the function's arguments (optionally  schema-quali-
	 fied), if any.

     CASCADE
	 Automatically	drop objects that depend on the function (such as opera-
	 tors or triggers), and in turn all objects that depend on those objects
	 (see Section 5.15).

     RESTRICT
	 Refuse to drop the function if any objects depend on it.  This  is  the
	 default.

EXAMPLES
     This command removes the square root function:

	 DROP FUNCTION sqrt(integer);

     Drop multiple functions in one command:

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

     If the function name is unique in its schema, it can be referred to without
     an argument list:

	 DROP FUNCTION update_employee_salaries;

     Note that this is different from

	 DROP FUNCTION update_employee_salaries();

     which  refers  to a function with zero arguments, whereas the first variant
     can refer to a function with any number of arguments,  including  zero,  as
     long as the name is unique.

COMPATIBILITY
     This  command  conforms  to  the SQL standard, with these PostgreSQL exten-
     sions:

     *	 The standard only allows one function to be dropped per command.

     *	 The IF EXISTS option

     *	 The ability to specify argument modes and names

SEE ALSO
     CREATE FUNCTION (CREATE_FUNCTION(7)), ALTER  FUNCTION  (ALTER_FUNCTION(7)),
     DROP PROCEDURE (DROP_PROCEDURE(7)), DROP ROUTINE (DROP_ROUTINE(7))

PostgreSQL 18.6 		      2026			DROP FUNCTION(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=DROP_FUNCTION&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help