.show table data statistics コマンド
テーブル列別のテーブル データ統計の推定を表示します。
Note
このコマンドは、列ストアに格納されているデータの統計のみを返します。 行ストア のデータ統計は返されません。
アクセス許可
このコマンドを実行するには、少なくともデータベース ユーザー、データベース ビューアー、またはデータベース モニターのアクセス許可が必要です。 詳細については、ロールベースのアクセス制御に関するページを参照してください。
構文
.showtable TableName data statistics [ with ( PropertyName = PropertyValue [, ...])] ]
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| TableName | string |
✔️ | 統計を表示するテーブルの名前。 |
| PropertyName、 PropertyValue | string |
省略可能な Supported プロパティのコンマ区切りリスト。 |
サポートされるプロパティ
次のプロパティを指定できます。 すべてのプロパティは省略可能です。
| プロパティ名 | 説明 | プロパティ値 |
|---|---|---|
samplepercent |
指定した割合のデータをスキャンします。 | 0 ~ 100 の整数 |
scope |
ホット キャッシュのみがスキャンされるか、データ全体がスキャンされるかを定義します。 | ホット キャッシュ データのみをスキャンする "hotcache" 、またはすべてのデータをスキャンする "all" を指定します。 |
from |
この時刻より後に作成されたデータ エクステントをスキャンします。 | datetime |
to |
この時刻より前に作成されたデータ エクステントをスキャンします。 | datetime |
オプションが指定されていない場合、ホット キャッシュ データの 1% のみがスキャンされます。
返品
このコマンドは、次の情報を含む結果テーブルを返します。
| 列名 | 種類 | 説明 |
|---|---|---|
ColumnName |
string |
テーブルの列名。 |
ColumnType |
string |
テーブル列のデータ型。 |
ColumnId |
guid |
テーブル列の内部 ID。 |
OriginalSize |
long |
取り込まれたデータ サイズの推定 (バイト単位)。 |
ExtentSize |
long |
エクステントの合計サイズ (データ サイズ + インデックス サイズ) の推定 (バイト単位)。 |
CompressionRatio |
real |
元のデータ サイズとエクステント データ サイズの比率。 |
DataCompressedSize |
long |
インデックスを除くデータ サイズをバイト単位でエクステントします。 |
SharedIndexSize |
long |
テキスト インデックスのサイズ (バイト単位)。 テキスト インデックスは、すべてのテーブル列で共有されます。 |
IndexSize |
long |
数値インデックスのサイズ (バイト単位)。 |
IndexSizePercent |
real |
インデックス サイズと元のデータ サイズの比率 (バイト単位)。 |
StorageEngineVersion |
string |
エンジンのバージョン。 複数のエンジン バージョンのデータが存在する場合、出力には各バージョンのエントリが含まれます。 |
PresentRowCount |
long |
行数の合計 ( 行を除く 。 |
DeletedRowCount |
long |
削除 行数。 |
SamplePercent |
real |
実際のデータ サンプリング率。これは、 samplepercent オプションで提供されるヒントとは異なる場合があります。 |
IncludeColdData |
bool |
統計の見積もりを計算するときにコールド データが考慮されたかどうか。 |
Note
ExtentSize には、共有テキスト インデックス のサイズは含まれません。 テーブルの合計データ サイズを計算するには、次の 2 つの方法があります。
- すべての
ExtentSize値を合計し、SharedIndexSize値を追加します。 - .show table details コマンドを実行し、
TotalExtentSize値を使用します。
例
.show table Users data statistics with (scope="all", samplepercent=80)
出力
| ColumnName | [列の型] | ColumnId | OriginalSize | ExtentSize | CompressionRatio | DataCompressedSize | SharedIndexSize | IndexSize | IndexSizePercent | StorageEngineVersion | PresentRowCount | DeletedRowCount | SamplePercent | IncludeColdData |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Name | string | 45c15cfe-ef38-4153-97e7-c18d21651fc2 | 60907 | 137305 | 0.44 | 137305 | 27787 | 0 | 0 | V3 | 2500 | 0 | 80 | True |
| 使用法 | real | c0aa6668-0f73-46a1-874e-f1b19123eb61 | 20000 | 20282 | 0.99 | 20102 | 27787 | 180 | 0.9 | V3 | 2500 | 0 | 80 | True |
| ID | long | eb01bab7-da60-4515-a5d4-4780a827bd85 | 20000 | 5722 | 3.49 | 5152 | 27787 | 570 | 2.85 | V3 | 2500 | 0 | 80 | True |