system-tables

システムに登録されているテーブルの一覧と設定情報を照会します。

コマンドプロパティ

項目	説明
コマンドタイプ	ドライバクエリ
必要な権限	なし
ライセンス使用量	カウントなし
並列実行	非対応
分散実行	非対応

構文

system-tables [verbose=BOOL] [TABLE_PATTERN]

オプション

verbose=BOOL: ディスク使用量などテーブルの詳細情報を一緒に照会します（デフォルト: f）。t を指定すると、min_day、max_day、disk_usage フィールドが追加で返されます。

ターゲット

TABLE_PATTERN: 照会するテーブルの名前パターン。複数のパターンを指定する場合はカンマ（,）で区切ります。名前の先頭または末尾にワイルドカード（*）を使用できます。指定しない場合はすべてのテーブルを照会します。

出力フィールド

フィールド	タイプ	説明
table	string	テーブル名
metadata	map	テーブルのメタデータ
primary_configs	map	プライマリストレージの設定情報
replica_configs	map	バックアップストレージの設定情報
lock_owner	map	ロック所有者（管理者専用）
lock_purpose	array	ロックの目的（管理者専用）
lock_reentcnt	integer	ロック再入回数（管理者専用）
retention_policy	string	テーブルデータの保持期間（単位：日）。保持期間が設定されていない場合は null を返します。
data_path	string	テーブルデータファイルのパス（管理者専用）
is_locked	boolean	テーブルのロック状態。`true`（ロック中）または `false`（ロックなし）（管理者専用）
privileges	array	ユーザーアカウント別のテーブルアクセス権限（管理者専用）
security_groups	array	セキュリティグループ別のテーブルアクセス権限（管理者専用）

verbose=t を指定した場合に追加で返されるフィールド:

フィールド	タイプ	説明
min_day	timestamp	最も古いパーティションの日付
max_day	timestamp	最新のパーティションの日付
disk_usage	long	ディスク使用量（単位：バイト）

エラーコード

解析エラー

エラーコード	メッセージ	説明
95081	잘못된 verbose 옵션 값입니다: [value]	`verbose` オプションに無効なブール値が指定された場合
95082	잘못된 테이블 패턴입니다: [table_pattern]	テーブルパターンの形式が無効な場合

ランタイムエラー

該当なし

説明

system-tables コマンドは、システムに登録されているテーブルの一覧と各テーブルの設定情報を照会します。

管理者権限のないユーザーは読み取り権限が付与されているテーブルのみ照会でき、lock_owner、lock_purpose、lock_reentcnt、data_path、is_locked、privileges、security_groups フィールドは返されません。

管理者権限のあるユーザーはすべてのテーブルを照会でき、ロック状態、データパス、アクセス権限情報が追加で返されます。

verbose オプションを t に設定すると、各テーブルのディスク使用量とパーティションの日付範囲が追加で照会されます。

使用例

すべてのテーブルの一覧を照会する
```
system-tables
```
システムに登録されているすべてのテーブルの情報を照会します。
特定のパターンに一致するテーブルを照会する
```
system-tables sys_*
```
名前が sys_ で始まるテーブルのみを照会します。
詳細情報を含めて照会する
```
system-tables verbose=t
```
すべてのテーブルのディスク使用量とパーティションの日付範囲を含めて照会します。
複数のテーブルパターンを指定する
```
system-tables sys_*,iis_*
```
名前が sys_ または iis_ で始まるテーブルを照会します。
ディスク使用量でソートする
```
system-tables verbose=t | sort -disk_usage
```
ディスク使用量が大きいテーブルから降順にソートします。