# DROP INDEX
#### 功能描述
删除索引。
#### 注意事项
- 索引的所有者、索引所在模式的所有者、拥有索引所在表的INDEX权限的用户或者被授予了DROP ANY INDEX权限的用户可以执行DROP INDEX命令，三权分立关闭时的系统管理员默认拥有此权限。
- 对于全局临时表，当某个会话已经初始化了全局临时表对象（包括创建全局临时表和第一次向全局临时表内插入数据）时，其他会话无法执行该表上索引的删除操作。
 
#### 语法格式
```
DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] 
    index_name [, ...] [ CASCADE | RESTRICT];
DROP INDEX index_name [, ...] [CASCADE | RESTRICT] ON table_name [algorithm_option | lock_option];
```
#### 参数说明
- **CONCURRENTLY**
  以不阻塞DML的方式在线删除索引（加四级锁）。删除索引时，一般会阻塞其他语句对该索引所依赖表的访问。加此关键字，可在删除过程中避免阻塞。
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - 删除索引指定CONCURRENTLY选项时，只能指定一个索引的名称， 并且不支持CASCADE选项。
  
  - 普通DROP INDEX命令可以在事务内执行，但是DROP INDEX CONCURRENTLY不可以在事务内执行。
  
  - 对于临时表，支持使用CONCURRENTLY关键字删除索引，但是实际删除过程中，采用的是阻塞式的删除方式，因为没有其他会话会并发访问临时表，并且阻塞式删除成本更低。
  
  - 与在线创建索引类似，在线删除索引也存在阶段需要等待索引对应表上相关的其他事务结束，因此可能出现锁超时问题，导致在线删除索引失败。
  
  - 与在线创建索引类似，由于需要等待表上相关的其他事务结束，在线删除索引可能会和其他DDL出现死锁问题，导致在线删除索引失败。具体原因是：在线删除索引持有四级锁，等待并发DDL事务结束；并发DDL持有事务锁，等待在线删除索引释放四级锁。
  
  - 当发生锁超时、死锁、数据库宕机等故障或者用户取消操作时，可能造成在线删除索引失败，残留非法状态的索引。为避免占用系统资源，需尽快将其清理，可以继续使用DROP INDEX CONCURRENTLY或者DROP INDEX将非法索引删除，如果使用DROP INDEX CONCURRENTLY删除索引持续失败，可以使用DROP INDEX删除索引。
  
  - 在线删除索引时间与并发业务量、并发业务运行时间有关。无并发业务时，在线删除索引为秒级别；有并发业务时，需要额外等待某时刻正在运行的所有并发业务结束，因此在线删除索引时间要额外加上这些并发业务运行时间。
    

- **IF EXISTS**
  如果指定的索引不存在，则发出一个notice而不是抛出一个ERROR。
  
- **index_name**
  要删除的索引名。
  取值范围：已存在的索引。
  
- **CASCADE \| RESTRICT**
  - CASCADE：表示允许级联删除依赖于该索引的对象。
  
  - RESTRICT：表示有依赖于此索引的对象存在，则该索引无法被删除。此选项为缺省值。
   
 
- **table_name**
  表名。
  
- **algorithm_option**
  具体介绍请参见[CREATE INDEX](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0489.html)。
  
- **lock_option**
  具体介绍请参见[CREATE INDEX](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0489.html)。
  
#### 示例
```
-- 建表
m_db=# CREATE TABLE test1_index (id INT, name VARCHAR(20));
m_db=# CREATE INDEX idx_test1 on test1_index (id);
-- 删除索引
m_db=# DROP INDEX IF EXISTS idx_test1 CASCADE;
-- 在线创建索引。
m_db=# CREATE INDEX CONCURRENTLY idx_test2 ON test1_index(name);
-- 在线删除索引。
m_db=# DROP INDEX CONCURRENTLY idx_test2;
-- 删除表
m_db=# DROP TABLE test1_index;
```
#### 相关链接
[ALTER INDEX](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0461.html)，[CREATE INDEX](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0489.html)
