大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:ANALYZE

· 52CE 我爱测

该语句用于收集统计信息。可以针对表(可以指定具体列)或整个数据库进行列统计信息的收集。

描述

该语句用于收集统计信息。可以针对表(可以指定具体列)或整个数据库进行列统计信息的收集。

语法

ANALYZE {TABLE <table_name> [ (<column_name> [, ...]) ] | DATABASE <database_name>}
    [ [ WITH SYNC ] [ WITH SAMPLE {PERCENT | ROWS} <sample_rate> ] [ WITH HOT VALUE ] ];

必选参数

1. <table_name>

指定的目标表。该参数与<database_name>参数必须且只能指定其中之一。

2. <database_name>

指定的目标数据库。该参数与<table_name>参数必须且只能指定其中之一。

可选参数

1. <column_name>

指定表的目标列。必须是  table_name  中存在的列,多个列名称用逗号分隔。

2. WITH SYNC

指定同步执行该 ANALYZE 语句。不指定时默认后台异步执行。

3. WITH SAMPLE {PERCENT | ROWS} <sample_rate>

指定使用抽样方式收集。当不指定时,默认为全量收集。<sample_rate> 为抽样参数,在 PERCENT 采样时指定抽样百分比,ROWS 采样时指定抽样行数。

4. WITH HOT VALUE

指定在手工全量收集时收集高频值。高频值可帮助优化器更准确地估算倾斜数据上的谓词选择率,但在高基数列上收集高频值可能消耗更多内存。不指定该选项时,Doris 保持原有行为:全量收集不收集高频值,抽样收集始终收集高频值。WITH HOT VALUE 与 WITH SAMPLE 同时使用时会被拒绝。

返回值

列名 说明
Job_Id 收集作业的唯一 ID
Catalog_Name Catalog 名
DB_Name 数据库名
Columns 收集的列列表

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限(Privilege) 对象(Object) 说明(Notes)
SELECT_PRIV 表(Table) 当执行 ANALYZE 时,需要拥有被查询的表的 SELECT_PRIV 权限

举例

  1. 对 lineitem 表按照 10% 的比例采样收集统计数据:
ANALYZE TABLE lineitem WITH SAMPLE PERCENT 10;
  1. 对 lineitem 表按采样 10 万行收集统计数据
ANALYZE TABLE lineitem WITH SAMPLE ROWS 100000;
  1. 对 lineitem 表进行全量收集,并收集高频值。
ANALYZE TABLE lineitem WITH SYNC WITH HOT VALUE;

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。