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

Apache Doris 中文参考:SHOW DATA

· 52CE 我爱测

## 描述 语句用于展示数据量、副本数量以及统计行数信息。该语句具有以下功能: - 可以展示当前数据库下所有表的数据量和副本数量 - 可以展示指定表的物化视图数据量、副本数量和统计行数 - 可以展示数据库的配额使用情况 - 支持按照数据量、副本数量等进行排序 ## 语法 其中: ## 可选参数 **1. ** > 指定要查看的表名。可以包含数据库名称。 > > 如果不指定此参数,则展示当前数据库下所有表的数据信息。 **2. ** >

描述

SHOW DATA 语句用于展示数据量、副本数量以及统计行数信息。该语句具有以下功能:

  • 可以展示当前数据库下所有表的数据量和副本数量
  • 可以展示指定表的物化视图数据量、副本数量和统计行数
  • 可以展示数据库的配额使用情况
  • 支持按照数据量、副本数量等进行排序

语法

SHOW DATA [ FROM [<db_name>.]<table_name> ] [ ORDER BY <order_by_clause> ];

其中:

order_by_clause:
    <column_name> [ ASC | DESC ] [ , <column_name> [ ASC | DESC ] ... ]

可选参数

1. FROM [<db_name>.]<table_name>

指定要查看的表名。可以包含数据库名称。

如果不指定此参数,则展示当前数据库下所有表的数据信息。

2. ORDER BY <order_by_clause>

指定结果集的排序方式。

可以对任意列进行升序(ASC)或降序(DESC)排序。

支持多列组合排序。

返回值

根据不同查询场景,返回以下结果集:

  • 不指定 FROM 子句时(展示数据库级别信息):
列名 说明
DbId 数据库 ID
DbName 数据库名称
Size 数据库总数据量
RemoteSize 远程存储数据量
RecycleSize 回收站数据量
RecycleRemoteSize 回收站远程存储数据量
  • 指定 FROM 子句时(展示表级别信息):
列名 说明
TableName 表名
IndexName 索引(物化视图)名称
Size 数据大小
ReplicaCount 副本数量
RowCount 统计行数(仅在查看具体表时显示)

权限控制

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

权限(Privilege) 对象(Object) 说明(Notes)
SELECT 表(Table) 需要对查看的表有 SELECT 权限

注意事项

  • 数据量统计包含所有副本的总数据量
  • 副本数量包含表的所有分区以及所有物化视图的副本数量
  • 统计行数时,以多个副本中行数最大的那个副本为准
  • 结果集中的 Total 行表示汇总数据
  • 结果集中的 Quota 行表示当前数据库设置的配额
  • 结果集中的 Left 行表示剩余配额
  • 如果需要查看各个 Partition 的大小,请使用 SHOW PARTITIONS 命令

示例

  • 展示所有数据库的数据量信息:

    SHOW DATA;
    
    +-------+-----------------------------------+--------+------------+-------------+-------------------+
    | DbId  | DbName                            | Size   | RemoteSize | RecycleSize | RecycleRemoteSize |
    +-------+-----------------------------------+--------+------------+-------------+-------------------+
    | 21009 | db1                               | 0      | 0          | 0           | 0                 |
    | 22011 | regression_test_inverted_index_p0 | 72764  | 0          | 0           | 0                 |
    | Total | NULL                              | 118946 | 0          | 0           | 0                 |
    +-------+-----------------------------------+--------+------------+-------------+-------------------+
    
  • 展示当前数据库下所有表的数据量信息:

    USE db1;
    SHOW DATA;
    
    +-----------+-------------+--------------+
    | TableName | Size        | ReplicaCount |
    +-----------+-------------+--------------+
    | tbl1      | 900.000 B   | 6            |
    | tbl2      | 500.000 B   | 3            |
    | Total     | 1.400 KB    | 9            |
    | Quota     | 1024.000 GB | 1073741824   |
    | Left      | 1021.921 GB | 1073741815   |
    +-----------+-------------+--------------+
    
  • 展示指定表的详细数据量信息:

    SHOW DATA FROM example_db.test;
    
    +-----------+-----------+-----------+--------------+----------+
    | TableName | IndexName | Size      | ReplicaCount | RowCount |
    +-----------+-----------+-----------+--------------+----------+
    | test      | r1        | 10.000MB  | 30           | 10000    |
    |           | r2        | 20.000MB  | 30           | 20000    |
    |           | test2     | 50.000MB  | 30           | 50000    |
    |           | Total     | 80.000    | 90           |          |
    +-----------+-----------+-----------+--------------+----------+
    
  • 按照副本数量降序、数据量升序排序:

    SHOW DATA ORDER BY ReplicaCount DESC, Size ASC;
    
    +-----------+-------------+--------------+
    | TableName | Size        | ReplicaCount |
    +-----------+-------------+--------------+
    | table_c   | 3.102 KB    | 40           |
    | table_d   | .000        | 20           |
    | table_b   | 324.000 B   | 20           |
    | table_a   | 1.266 KB    | 10           |
    | Total     | 4.684 KB    | 90           |
    | Quota     | 1024.000 GB | 1073741824   |
    | Left      | 1024.000 GB | 1073741734   |
    +-----------+-------------+--------------+
    

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

资料来源与适用范围

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

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

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