↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

DROP INDEX

移除一个索引

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-DROPINDEX
file
sql-dropindex.html
lang
en
name
DROP INDEX
purpose
remove an index
purpose zh
未知
sections same as
未知
slug
18
synopsis html
DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] <em class="replaceable"><code>name</code></em> [, ...] [ CASCADE | RESTRICT ]
synopsis text
DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

语法

DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

DROP INDEX CONCURRENTLY IF EXISTS name , CASCADE RESTRICT

版本定义 PG 18

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

描述

DROP INDEX从数据库系统中删除一个现有索引。要执行此命令,你必须是该索引的拥有者。

参数

CONCURRENTLY

删除索引时,不阻塞该索引所在表上的并发查询、插入、更新和删除。普通的DROP INDEX 会对该表获取ACCESS EXCLUSIVE锁,阻塞其他访问,直到索引删除完成。使用该选项时,命令会改为等待相冲突的事务完成。

使用此选项时有若干限制需要注意。只能指定一个索引名,并且不支持 CASCADE选项。(因此,支撑UNIQUE 或PRIMARY KEY约束的索引不能以这种方式删除。)另外,普通的DROP INDEX可以在事务块内执行,但DROP INDEX CONCURRENTLY不可以。最后,分区表上的索引也不能使用该选项删除。

对于临时表,DROP INDEX始终是非并发的,因为没有其他会话可以访问它们,而且非并发删除索引的代价更低。

IF EXISTS

如果该索引不存在,则不要抛出错误。这种情况下会发出一条提示。

name

要移除的索引名称(可以被模式限定)。

CASCADE

自动删除依赖于该索引的对象,以及进一步依赖于这些对象的所有对象(参见第 5.15 节)。

RESTRICT

如果有任何对象依赖于该索引,则拒绝删除它。这是默认值。

示例

此命令会删除索引title_idx:

DROP INDEX title_idx;

兼容性

DROP INDEX是PostgreSQL 的一种语言扩展。SQL 标准中没有关于索引的规定。

另见

CREATE INDEX

比较版本

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c