ANALYZE | ANALYSE
功能描述
用于收集与数据库中普通表内容相关的统计信息,统计结果存储在系统表PG_STATISTIC下。执行计划生成器会使用这些统计数据,以确定最有效的执行计划。
如果没有指定参数,ANALYZE会分析当前数据库中的每个表和分区表。同时也可以通过指定table_name、column和partition_name参数把分析限定在特定的表、列或分区表中。
能够执行ANALYZE特定表的用户,包括表的所有者、表所在数据库的所有者或通过GRANT被授予该表上ANALYZE权限的用户以及有SYSADMIN属性的用户。
在百分比采样收集统计信息时,用户需要被授予ANALYZE和SELECT权限。
ANALYZE|ANALYSE VERIFY用于检测数据库中普通表(行存表、列存表)的数据文件是否损坏,目前此命令暂不支持HDFS表。
注意事项
- 在匿名块、事务块、函数或存储过程内对单表进行ANALYZE操作。该功能仅8.1.1及以上版本支持。
- 对于ANALYZE全库,库中各表的ANALYZE处于不同的事务中,所以不支持在匿名块、事务块、函数或存储过程内对全库执行ANALYZE。
- 统计信息的回滚操作不支持PG_CLASS中相关字段的回滚。
- ANALYZE VERIFY操作处理的大多为异常场景检测需要使用RELEASE版本。ANALYZE VERIFY场景不触发远程读,因此远程读参数不生效。对于关键系统表出现错误被系统检测出页面损坏时,将直接报错不再继续检测。
语法格式
- 收集表的统计信息。
1 2
{ ANALYZE | ANALYSE } [ VERBOSE ] [ table_name [ ( column_name [, ...] ) ] ];
- 收集分区表的统计信息。
1 2 3
{ ANALYZE | ANALYSE } [ VERBOSE ] [ table_name [ ( column_name [, ...] ) ] ] PARTITION ( patrition_name ) ;
普通分区表目前支持针对某个分区的统计信息的语法,但功能上不支持针对某个分区的统计信息收集。对指定分区执行ANALYZE,会有相应的WARNING提示。
- 收集外表的统计信息。
1 2
{ ANALYZE | ANALYSE } [ VERBOSE ] { foreign_table_name | FOREIGN TABLES };
- 收集多列统计信息
1 2
{ANALYZE | ANALYSE} [ VERBOSE ] table_name (( column_1_name, column_2_name [, ...] ));
- 收集多列统计信息时,请设置GUC参数default_statistics_target为负数,以使用百分比采样方式。
- 每组多列统计信息最多支持32列。
- 不支持收集多列统计信息的表:系统表、HDFS外表复制表。
- 检测当前库的数据文件
1
{ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE};
- 支持对全库进行操作,由于涉及的表较多,建议以重定向保存结果gsql -d database -p port -f "verify.sql"> verify_warning.txt 2>&1。
- 不支持HDFS表(内表和外表),不支持临时表和unlog表。
- 对外提示NOTICE只核对外可见的表,内部表的检测会包含在它所依赖的外部表,不对外显示和呈现。
- 此命令的处理可容错ERROR级别的处理。由于debug版本的Assert可能会导致core无法继续执行命令,建议在release模式下操作。
- 对于全库操作时,当关键系统表出现损坏则直接报错,不再继续执行。
- 检测表和索引的数据文件
1
{ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE];
- 支持对普通表的操作和索引表的操作,但不支持对索引表index使用CASCADE操作。原因是由于CASCADE模式用于处理主表的所有索引表,当单独对索引表进行检测时,无需使用CASCADE模式。
- 不支持HDFS表(内表和外表),不支持临时表和unlog表。
- 对于主表的检测会同步检测主表的内部表,例如toast表、cudesc表等。
- 当提示索引表损坏时,建议使用reindex命令进行重建索引操作。
- 检测表分区的数据文件
1
|
{ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; |
![](https://support.huaweicloud.com/intl/zh-cn/ae-ad-1-sqlreference-dws/public_sys-resources/note_3.0-zh-cn.png)
- 支持对表的单独分区进行检测操作,但不支持对索引表index使用CASCADE操作。
- 不支持HDFS表(内表和外表),不支持临时表和unlog表.
参数说明
- VERBOSE
启用显示进度信息。
如果指定了VERBOSE,ANALYZE发出进度信息,表明目前正在处理的表。各种有关表的统计信息也会打印出来。
- table_name
需要分析的特定表的表名(可能会带模式名),如果省略,将对数据库中的所有表(非外部表)进行分析。
对于ANALYZE收集统计信息,目前仅支持行存表、列存表、HDFS表、ORC格式的OBS外表、CARBONDATA格式的OBS外表、协同分析的外表。
取值范围:已有的表名。
- column_name,column_1_name,column_2_name
需要分析特定列的列名,默认为所有列。
取值范围:已有的列名。
- partition_name
如果table为分区表,在关键字PARTITION后面指定分区名partition_name表示分析该分区表的统计信息。目前语法上支持分区表做ANALYZE,但功能实现上暂不支持对指定分区统计信息的分析。
取值范围:表的某一个分区名。
- foreign_table_name
需要分析的特定表的表名(可能会带模式名),该表的数据存放于HDFS分布式文件系统中。
取值范围:已有的表名。
- FOREIGN TABLES
分析所有当前用户权限下,数据位于HDFS分布式文件系统中的HDFS外表。
- index_name
需要分析的特定索引表的表名(可能会带模式名)。
取值范围:已有的表名。
- FAST|COMPLETE
对于行存表,FAST模式下主要对于行存表的CRC和page header进行校验,如果校验失败则会告警; 而COMPLETE模式下,则主要对行存表的指针、tuple进行解析校验。 对于列存表,FAST模式下主要对于列存表的CRC和magic进行校验,如果校验失败则会告警; 而COMPLETE模式下,则主要对列存表的CU进行解析校验。
- CASCADE
CASCADE模式下会对当前表的所有索引进行检测处理。
示例
- 使用ANALYZE语句更新表customer_info统计信息:
1
ANALYZE customer_info;
- 使用ANALYZE VERBOSE语句更新表customer_info统计信息,并输出表的相关信息:
1 2 3 4 5
ANALYZE VERBOSE customer_info; INFO: analyzing "cstore.pg_delta_3394584009"(cn_5002 pid=53078) INFO: analyzing "public.customer_info"(cn_5002 pid=53078) INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) ANALYZE