メインコンテンツまでスキップ
バージョン: 26.x

データを表示

説明​

SHOW DATA文は、データボリューム、レプリカ数、および行統計に関する情報を表示するために使用されます。この文には以下の機能があります：

  • 現在のデータベース内のすべてのTableのデータボリュームとレプリカ数を表示できます。
  • 指定されたTableのマテリアライズドビューのデータボリューム、レプリカ数、および行統計を表示できます。
  • データベースのクォータ使用量を表示できます。
  • データボリューム、レプリカ数などによるソートをサポートします。

構文​

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>

表示するTable名を指定します。データベース名を含めることができます。

このパラメータが指定されない場合、現在のデータベース内のすべてのTableのデータ情報を表示します。

2. ORDER BY <order_by_clause>

結果セットのソート方法を指定します。

任意の列を昇順（ASC）または降順（DESC）でソートできます。

複数列の組み合わせソートをサポートします。

戻り値​

異なるクエリシナリオに応じて、以下の結果セットが返されます：

  • FROM句が指定されない場合（データベースレベル情報の表示）：
Column Nameデスクリプション
DbIdデータベースID
DbNameデータベース名
Sizeデータベースの総データ量
RemoteSizeリモートストレージのデータ量
RecycleSizeごみ箱のデータ量
RecycleRemoteSizeごみ箱のリモートストレージ量
  • FROM句が指定された場合（Tableレベル情報の表示）：
Column Nameデスクリプション
TableNameTable名
IndexNameインデックス（マテリアライズドビュー）名
Sizeデータサイズ
ReplicaCountレプリカ数
RowCount行統計（特定のTableを表示する場合のみ表示）

アクセス制御要件​

このSQLコマンドを実行するユーザーは、最低限以下の権限を持つ必要があります：

PrivilegeObject注釈
SELECTTableTableを表示するにはSELECT権限が必要です。

使用上の注意​

  • データ量統計には、すべてのレプリカの総データ量が含まれます。
  • レプリカ数には、Tableのすべてのマテリアライズドビューのすべてのパーティションとレプリカが含まれます。
  • 行数をカウントする際は、複数のレプリカ間の最大行数を考慮します。
  • 結果セットの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                 |
    +-------+-----------------------------------+--------+------------+-------------+-------------------+

  • 現在のデータベース内のすべてのTableのデータ容量情報を表示する：

    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   |
    +-----------+-------------+--------------+

  • 指定されたTableの詳細なデータ量情報を表示する:

    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           |          |
    +-----------+-----------+-----------+--------------+----------+

  • replica count の降順および data volume の昇順でソートする：

    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   |
    +-----------+-------------+--------------+