データを表示

概要

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コマンドを実行するユーザーは、少なくとも以下の権限を持っている必要があります：

権限	オブジェクト	注記
SELECT	Table	テーブルを表示するためにはSELECT権限が必要です。

使用上の注意

• データ量統計にはすべてのレプリカの総データ量が含まれます。
• レプリカ数にはテーブルのすべてのマテリアライズドビューのすべてのパーティションとレプリカが含まれます。
• 行数をカウントする際は、複数のレプリカ間の最大行数を考慮します。
• 結果セットのTotal行は集約データを示します。
• 結果セットのQuota行は、データベースに設定された現在のクォータを示します。
• 結果セットのLeft行は残りのクォータを示します。
• 各パーティションのサイズを表示する必要がある場合は、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.000MB  | 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   |
  +-----------+-------------+--------------+