Apache Doris 表统计信息查看指南：SHOW TABLE STATS 命令详解

概述

在数据库管理和优化过程中，了解表的统计信息对于查询性能调优至关重要。Apache Doris 提供了 SHOW TABLE STATS 命令，让用户能够快速查看表的统计概览信息。本文将深入解析这一命令的使用方法和实际应用场景。

命令语法

SHOW TABLE STATS <table_name>;

参数说明

必需参数

<table_name>
指定需要查看统计信息的表名。该参数为必填项，用户需要替换为实际存在的表名。

返回结果详解

执行该命令后，系统会返回包含以下字段的结果集：

字段名称	说明
updated_rows	表更新的行数统计
query_times	表被查询的次数
row_count	表中当前的行数
updated_time	表最后一次修改的时间
columns	已分析过的列列表
trigger	最后一次分析的触发方式
new_partition	是否为新分区首次加载的标记
user_inject	用户是否手动注入统计信息的标记
enable_auto_analyze	是否启用了自动分析功能
last_analyze_time	最后一次执行分析的时间

权限要求

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

权限类型	对象	说明
SELECT_PRIV	表	执行SHOW命令时，需要对查询的表拥有SELECT权限

实际应用示例

基础用法

查看名为test1的表的统计信息：

SHOW TABLE STATS test1;

执行结果可能如下：

+--------------+-------------+-----------+---------------------+------------------------+---------+---------------+-------------+---------------------+---------------------+
| updated_rows | query_times | row_count | updated_time        | columns                | trigger | new_partition | user_inject | enable_auto_analyze | last_analyze_time   |
+--------------+-------------+-----------+---------------------+------------------------+---------+---------------+-------------+---------------------+---------------------+
| 0            | 0           | 100000    | 2025-01-17 16:46:31 | [test1:name, test1:id] | MANUAL  | false         | false       | true                | 2025-02-05 12:17:41 |
+--------------+-------------+-----------+---------------------+------------------------+---------+---------------+-------------+---------------------+---------------------+

结果解读

从上述结果可以看出：

1. 表test1当前有100,000行数据
2. 最近一次修改发生在2025年1月17日
3. 已分析的列包括name和id
4. 最后一次分析是手动触发的(MANUAL)
5. 自动分析功能已启用(enable_auto_analyze=true)

使用场景建议

1. 查询优化：通过观察query_times可以了解表的查询热度，优先优化高频查询的表
2. 统计信息维护：通过updated_rows和last_analyze_time判断是否需要手动更新统计信息
3. 分区管理：new_partition字段可帮助识别新加载的分区
4. 性能监控：结合row_count和updated_rows可以监控表的数据变化情况

注意事项

1. 统计信息的准确性直接影响查询优化器的决策，建议定期检查关键表的统计信息
2. 对于频繁更新的表，可能需要更频繁地更新统计信息
3. 当发现查询性能下降时，可先检查表的统计信息是否最新

通过合理利用SHOW TABLE STATS命令，数据库管理员可以更好地了解表的使用情况和状态，为性能优化提供数据支持。