描述

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

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

语法

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

其中：

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

可选参数

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

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

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

2. ORDER BY <order_by_clause>

指定结果集的排序方式。

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

支持多列组合排序。

返回值

根据不同查询场景，返回以下结果集：

• 不指定 FROM 子句时（展示数据库级别信息）：

• 指定 FROM 子句时（展示表级别信息）：

权限控制

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

注意事项

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

示例

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

  SQL 复制

  1SHOW DATA;

  Plain Text 复制

  1+-------+-----------------------------------+--------+------------+-------------+-------------------+
  2| DbId  | DbName                            | Size   | RemoteSize | RecycleSize | RecycleRemoteSize |
  3+-------+-----------------------------------+--------+------------+-------------+-------------------+
  4| 21009 | db1                               | 0      | 0          | 0           | 0                 |
  5| 22011 | regression_test_inverted_index_p0 | 72764  | 0          | 0           | 0                 |
  6| Total | NULL                              | 118946 | 0          | 0           | 0                 |
  7+-------+-----------------------------------+--------+------------+-------------+-------------------+

• 展示当前数据库下所有表的数据量信息：

  SQL 复制

  1USE db1;
  2SHOW DATA;

  Text 复制

  1+-----------+-------------+--------------+
  2| TableName | Size        | ReplicaCount |
  3+-----------+-------------+--------------+
  4| tbl1      | 900.000 B   | 6            |
  5| tbl2      | 500.000 B   | 3            |
  6| Total     | 1.400 KB    | 9            |
  7| Quota     | 1024.000 GB | 1073741824   |
  8| Left      | 1021.921 GB | 1073741815   |
  9+-----------+-------------+--------------+

• 展示指定表的详细数据量信息：

  SQL 复制

  1SHOW DATA FROM example_db.test;

  Text 复制

  1+-----------+-----------+-----------+--------------+----------+
  2| TableName | IndexName | Size      | ReplicaCount | RowCount |
  3+-----------+-----------+-----------+--------------+----------+
  4| test      | r1        | 10.000MB  | 30           | 10000    |
  5|           | r2        | 20.000MB  | 30           | 20000    |
  6|           | test2     | 50.000MB  | 30           | 50000    |
  7|           | Total     | 80.000    | 90           |          |
  8+-----------+-----------+-----------+--------------+----------+

• 按照副本数量降序、数据量升序排序：

  SQL 复制

  1SHOW DATA ORDER BY ReplicaCount DESC, Size ASC;

  Text 复制

  1+-----------+-------------+--------------+
  2| TableName | Size        | ReplicaCount |
  3+-----------+-------------+--------------+
  4| table_c   | 3.102 KB    | 40           |
  5| table_d   | .000        | 20           |
  6| table_b   | 324.000 B   | 20           |
  7| table_a   | 1.266 KB    | 10           |
  8| Total     | 4.684 KB    | 90           |
  9| Quota     | 1024.000 GB | 1073741824   |
  10| Left      | 1024.000 GB | 1073741734   |
  11+-----------+-------------+--------------+