REINDEX
功能描述
为表中的数据重建索引。
在以下几种情况下需要使用REINDEX重建索引:
- 索引崩溃,并且不再包含有效的数据。
- 索引变得“臃肿”,包含大量的空页或接近空页。
- 为索引更改了存储参数(例如填充因子),并且希望这个更改完全生效。
注意事项
- REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。
- REINDEX CONCURRENTLY在线重建索引导致表上索引顺序改变时,可能会导致查询计划改变。
语法格式
- 重建普通索引。
1
REINDEX { INDEX | TABLE | DATABASE | SYSTEM } [CONCURRENTLY] name [ FORCE ];
- 重建索引分区。
1 2
REINDEX { INDEX| TABLE} name PARTITION partition_name [ FORCE ];
参数说明
- INDEX
重新建立指定的索引。
- TABLE
重新建立指定表的所有索引,如果表有从属的“TOAST”表,则这个表也会重建索引。如果表上有索引已经被alter unusable失效,则这个索引无法被重新创建。当指定CONCURRENTLY选项时,暂不支持重建从属“TOAST”表上的索引。
- DATABASE
重建当前数据库里的所有索引。当指定CONCURRENTLY选项时,暂不支持重建数据库中表的从属“TOAST”表上的索引。
- SYSTEM
在当前数据库上重建所有系统表上的索引。不会处理在用户表上的索引。
- CONCURRENTLY
以不阻塞DML的方式重建索引(加ShareUpdateExclusiveLock锁)。重建索引时,一般会阻塞其他语句对该索引所依赖表的访问。指定此关键字,可以实现重建过程中不阻塞DML。不支持在线重建系统表上的索引。不支持REINDEX INTERNAL TABLE CONCURRENTLY和REINDEX SYSTEM CONCURRENTLY。当执行REINDEX DATABASE CONCURRENTLY时,在线重建当前数据库中用户表上的所有索引(不会处理系统表上的索引)。REINDEX CONCURRENTLY不可以在事务内执行。在线重建索引只支持B-tree索引和UB-tree索引,只支持普通索引、GLOBAL索引、LOCAL索引。在线并行重建索引只支持Astore的普通索引、GLOBAL索引、LOCAL索引,Ustore索引不支持在线并行重建。如果在线重建索引失败,可能会留下非法的新索引,在系统无法自动清理失败新索引的情况下(比如数据库宕机),需要尽快手动清除(使用DROP INDEX语句)非法新索引,以防占用更多资源。一般来说,非法的新索引的后缀名为_ccnew。REINDEX INDEX CONCURRENTLY对表加4级会话锁,且其前几个阶段与CREATE INDEX CONCURRENTLY相似,因此也可能产生卡住或死锁的问题,具体场景与CREATE INDEX CONCURRENTLY相似(比如两个会话同时对同一个索引或表进行REINDEX CONCURRENTLY操作,会引发死锁问题),详见CONCURRENTLY章节。
- name
需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。
REINDEX DATABASE和SYSTEM只能重建当前数据库的索引,所以name必须和当前数据库名称相同。
- FORCE
废弃选项,仅为保持前向兼容,故继续保留。
- partition_name
需要重建索引的分区的名称或者索引分区的名称。
取值范围:
- 如果前面是REINDEX INDEX,则这里应该指定索引分区的名称;
- 如果前面是REINDEX TABLE,则这里应该指定分区的名称;
![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。
![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/caution_3.0-zh-cn.png)
REINDEX、REINDEX CONCURRENTLY不支持单独操作toast表或toast索引。
示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
--创建SCHEMA。 gaussdb=# CREATE SCHEMA tpcds; --创建表tpcds.customer。 gaussdb=# CREATE TABLE tpcds.customer( c_customer_sk INTEGER NOT NULL, c_customer_id CHAR(16) NOT NULL ); --向表中插入多条记录。 gaussdb=# INSERT INTO tpcds.customer VALUES (1, 'AAAAAAAABAAAAAAA'),(5, 'AAAAAAAACAAAAAAA'),(10, 'AAAAAAAADAAAAAAA'); --创建一个行存表tpcds.customer_t1,并在tpcds.customer_t1表上的c_customer_sk字段创建索引。 gaussdb=# CREATE TABLE tpcds.customer_t1 ( c_customer_sk integer not null, c_customer_id char(16) not null, c_current_cdemo_sk integer , c_current_hdemo_sk integer , c_current_addr_sk integer , c_first_shipto_date_sk integer , c_first_sales_date_sk integer , c_salutation char(10) , c_first_name char(20) , c_last_name char(30) , c_preferred_cust_flag char(1) , c_birth_day integer , c_birth_month integer , c_birth_year integer , c_birth_country varchar(20) , c_login char(13) , c_email_address char(50) , c_last_review_date char(10) ) WITH (orientation = row); gaussdb=# CREATE INDEX tpcds_customer_index1 ON tpcds.customer_t1 (c_customer_sk); gaussdb=# INSERT INTO tpcds.customer_t1 SELECT * FROM tpcds.customer WHERE c_customer_sk < 10; --重建一个单独索引。 gaussdb=# REINDEX INDEX tpcds.tpcds_customer_index1; --在线重建一个单独索引。 gaussdb=# REINDEX INDEX CONCURRENTLY tpcds.tpcds_customer_index1; --重建表tpcds.customer_t1上的所有索引。 gaussdb=# REINDEX TABLE tpcds.customer_t1; --在线重建表tpcds.customer_t1上的所有索引。 gaussdb=# REINDEX TABLE CONCURRENTLY tpcds.customer_t1; --删除tpcds.customer_t1表。 gaussdb=# DROP TABLE tpcds.customer_t1; --删除表tpcds.customer。 gaussdb=# DROP TABLE tpcds.customer; --删除SCHEMA。 gaussdb=# DROP SCHEMA tpcds CASCADE; |