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

  
 
  

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

NAME
     DROP_INDEX - remove an index

SYNOPSIS
     DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

DESCRIPTION
     DROP  INDEX  drops  an  existing index from the database system. To execute
     this command you must be the owner of the index.

PARAMETERS
     CONCURRENTLY
	 Drop the index without locking out  concurrent  selects,  inserts,  up-
	 dates,  and  deletes on the index's table. A normal DROP INDEX acquires
	 an ACCESS EXCLUSIVE lock on the table, blocking  other  accesses  until
	 the  index drop can be completed. With this option, the command instead
	 waits until conflicting transactions have completed.

	 There are several caveats to be aware of when using this  option.  Only
	 one  index  name  can	be specified, and the CASCADE option is not sup-
	 ported. (Thus, an index that supports a  UNIQUE  or  PRIMARY  KEY  con-
	 straint  cannot be dropped this way.) Also, regular DROP INDEX commands
	 can be performed within a transaction block,  but  DROP  INDEX  CONCUR-
	 RENTLY  cannot. Lastly, indexes on partitioned tables cannot be dropped
	 using this option.

	 For temporary tables, DROP INDEX is always non-concurrent, as no  other
	 session can access them, and non-concurrent index drop is cheaper.

     IF EXISTS
	 Do  not  throw an error if the index does not exist. A notice is issued
	 in this case.

     name
	 The name (optionally schema-qualified) of an index to remove.

     CASCADE
	 Automatically drop objects that depend on the index, and  in  turn  all
	 objects that depend on those objects (see Section 5.15).

     RESTRICT
	 Refuse  to  drop the index if any objects depend on it. This is the de-
	 fault.

EXAMPLES
     This command will remove the index title_idx:

	 DROP INDEX title_idx;

COMPATIBILITY
     DROP INDEX is a PostgreSQL language extension. There are no provisions  for
     indexes in the SQL standard.

SEE ALSO
     CREATE INDEX (CREATE_INDEX(7))

PostgreSQL 18.6 		      2026			   DROP INDEX(7)

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

home | help