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

Apache Doris 中文参考:ALTER STATS

· 52CE 我爱测

要设置的统计信息值,以 key = value 的形式给出,key 和 value 需要用引号包裹,kv 对之间用逗号分隔。可以设置的统计信息包括: - row_count,总行数

描述

手动修改指定表中指定列的统计信息。请参阅统计信息章节

语法

ALTER TABLE <table_name>
  [ INDEX <index_name> ]
  MODIFY COLUMN <column_name>
  SET STATS (<column_stats>)

其中:

column_stats
  : -- column stats value
  ("key1" = "value1", "key2" = "value2" [...])

必选参数

  1. <table_name>: 指定表的标识符(即名称)

  2. <column_name>: 指定列标识符(即名称)。在不指定 index_name 的情况下,就是基表的列名称。

  3. <column_stats> :

    要设置的统计信息值,以 key = value 的形式给出,key 和 value 需要用引号包裹,kv 对之间用逗号分隔。可以设置的统计信息包括:

    • row_count,总行数

    • ndv,列的基数

    • num_nulls,列的空值数量

    • data_size,列的总大小

    • min_value,列的最小值

    • max_value,列的最大值

    其中 row_count 是必须指定的,其他属性为可选项。如果不设置,该列的对应统计信息属性值就为空。

可选参数

  1. <index_name> : 同步物化视图(请参阅“同步物化视图”章节)标识符(即名称)。一张表可以创建 0 到多个物化视图,如果需要设置某个物化视图中某一列的统计信息,需要使用 index_name 来制定物化视图的名称。不指定的情况下,设定的是基表中列的属性。

权限控制

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

权限(Privilege) 对象(Object) 说明(Notes)
ALTER_PRIV 表(Table)

注意事项

用户手动对某张表注入统计信息后,这张表就不再参与统计信息的自动收集(请参阅“统计信息自动收集”章节),以免覆盖用户手动注入的信息。如果不再使用注入的统计信息,可以使用 drop stats 语句删掉已经注入的信息,这样可以让该表重新开启自动收集。

示例

  • 给 Part 表的 p_parkey 列(基表列,因为没有指定 index_name)注入统计信息。

    alter 
        table part
        modify column p_partkey 
        set stats ('row_count'='2.0E7', 'ndv'='2.0252576E7', 'num_nulls'='0.0', 'data_size'='8.0E7', 'min_value'='1', 'max_value'='20000000');
    
  • 给 Part 表的 index1 物化视图的 col1 列(物化视图列,因为指定了 index_name)注入统计信息。

    alter 
        table part index index1
        modify column col1 
        set stats ('row_count'='2.0E7', 'ndv'='2.0252576E7', 'num_nulls'='0.0', 'data_size'='8.0E7', 'min_value'='1', 'max_value'='20000000');
    

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

资料来源与适用范围

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

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

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