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

DATA を表示

説明​

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

  • 現在のデータベース内のすべてのTableのデータ量とレプリカ数を表示できます。
  • 指定されたTableのmaterialized viewsのデータ量、レプリカ数、行統計を表示できます。
  • データベースのクォータ使用量を表示できます。
  • データ量、レプリカ数などによるソートをサポートしています。

構文​

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句が指定されていない場合（データベースレベル情報の表示）：
列名説明
DbIdデータベースID
DbNameデータベース名
Sizeデータベースの総データ量
RemoteSizeリモートストレージデータ量
RecycleSizeリサイクルビンデータ量
RecycleRemoteSizeリサイクルビンリモートストレージ量
  • FROM句が指定されている場合（Tableレベル情報の表示）：
列名説明
TableNameTable名
IndexNameインデックス（マテリアライズドビュー）名
Sizeデータサイズ
ReplicaCountレプリカ数
RowCount行統計（特定のTableを表示する場合のみ表示）

アクセス制御要件​

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

権限オブジェクト備考
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のデータ容量情報を表示する：

```sql
USE db1;
SHOW DATA;
```
```text
+-----------+-------------+--------------+
| 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           |          |
    +-----------+-----------+-----------+--------------+----------+

  • レプリカ数で降順に、データボリュームで昇順にソートする：

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