メタテーブルとは

メタテーブル

GridDBの管理用のメタデータを参照することができるテーブル群です。

メモ

• メタテーブルは、参照のみ可能です。データの登録や削除はできません。
• SELECTで参照する際、メタテーブル名は引用符"で囲んでください。

注意

• メタテーブルのスキーマは将来のバージョンで変更される可能性があります。

テーブル情報

テーブルに関する情報を取得できます。

テーブル名

#tables

スキーマ

列名	内容	型
DATABASE_NAME	データベース名	STRING
TABLE_NAME	テーブル名	STRING
TABLE_OPTIONAL_TYPE	テーブル種別 COLLECTION / TIMESERIES	STRING
DATA_AFFINITY	データアフィニティ	STRING
EXPIRATION_TIME	期限解放経過時間	INTEGER
EXPIRATION_TIME_UNIT	期限解放経過単位	STRING
EXPIRATION_DIVISION_COUNT	期限解放分割数	STRING
COMPRESSION_METHOD	時系列圧縮方式	STRING
COMPRESSION_WINDOW_SIZE	時系列圧縮間引き最大期間	INTEGER
COMPRESSION_WINDOW_SIZE_UNIT	時系列圧縮間引き最大期間単位	STRING
PARTITION_TYPE	パーティショニング種別	STRING
PARTITION_COLUMN	パーティショニングキー	STRING
PARTITION_INTERVAL_VALUE	分割値（インターバル/インターバルハッシュの場合）	INTEGER
PARTITION_INTERVAL_UNIT	分割単位（インターバル/インターバルハッシュの場合）	STRING
PARTITION_DIVISION_COUNT	分割数（ハッシュの場合）	INTEGER
SUBPARTITION_TYPE	パーティショニング種別 （インターバルハッシュの場合にHASH）	STRING
SUBPARTITION_COLUMN	パーティショニングキー （インターバルハッシュの場合）	STRING
SUBPARTITION_INTERVAL_VALUE	分割値	INTEGER
SUBPARTITION_INTERVAL_UNIT	分割単位	STRING
SUBPARTITION_DIVISION_COUNT	分割数 （インターバルハッシュの場合）	INTEGER
EXPIRATION_TYPE	期限解放種別 ROW / PARTITION	STRING

索引情報

索引に関する情報を取得できます。

テーブル名

#index_info

スキーマ

列名	内容	型
DATABASE_NAME	データベース名	STRING
TABLE_NAME	テーブル名	STRING
INDEX_NAME	索引名	STRING
INDEX_TYPE	索引種別 TREE / HASH / SPATIAL	STRING
ORDINAL_POSITION	索引内のカラム列順序(1からの連番)	SHORT
COLUMN_NAME	列名	STRING

パーティショニング情報

パーティショニングされたテーブルの内部コンテナ(データパーティション)に関する情報を取得することができます。

テーブル名

#table_partitions

スキーマ

列名	内容	型
DATABASE_NAME	データベース名	STRING
TABLE_NAME	パーティショニングされたテーブルの名前	STRING
PARTITION_BOUNDARY_VALUE	データパーティションの下限値	STRING

仕様

• ロウ1件がひとつのデータパーティションの情報を表します。
  • 例えば、分割数128のハッシュパーティショニングテーブルの場合、TABLE_NAMEにテーブル名を指定して検索するとロウが128個表示されます。
• 上記の列以外にも複数の列が表示されます。
• 下限値でソートする場合、対象のパーティショニングキーの型に合わせてキャストする必要があります。

例

• データパーティションの数を確認する

  SELECT COUNT(*) FROM "#table_partitions" WHERE TABLE_NAME='myIntervalPartition';
  
  COUNT(*)
  -----------------------------------
   8703

• データパーティションの下限値を確認する

  SELECT PARTITION_BOUNDARY_VALUE FROM "#table_partitions" WHERE TABLE_NAME='myIntervalPartition'
  ORDER BY PARTITION_BOUNDARY_VALUE;
  
  PARTITION_BOUNDARY_VALUE
  -----------------------------------
  2016-10-30T10:00:00Z
  2017-01-29T10:00:00Z
          :

• インターバルパーティショニングのテーブル「myIntervalPartition2」(パーティショニングキーの型：INTEGER、分割基準値 20000)のデータパーティションの下限値一覧を確認する

  SELECT CAST(PARTITION_BOUNDARY_VALUE AS INTEGER) V FROM "#table_partitions"
  WHERE TABLE_NAME='myIntervalPartition2' ORDER BY V;
  
  PARTITION_BOUNDARY_VALUE
  -----------------------------------
  -5000
  15000
  35000
  55000
    :

ビュー情報

ビューに関する情報を取得できます。

テーブル名

#views

スキーマ

列名	内容	型
DATABASE_NAME	データベース名	STRING
VIEW_NAME	ビュー名	STRING
VIEW_DEFINITION	ビュー定義文字列	STRING

実行中SQL情報

実行中のSQL(クエリまたはジョブ)に関する情報を取得できます。

テーブル名

#sqls

スキーマ

列名	内容	型
DATABASE_NAME	データベース名	STRING
NODE_ADDRESS	処理実行中のノードのアドレス(system)	STRING
NODE_PORT	処理実行中のノードのポート(system)	INTEGER
START_TIME	処理開始時刻	TIMESTAMP
APPLICATION_NAME	アプリケーション名	STRING
SQL	クエリ文字列	STRING
QUERY_ID	クエリID	STRING
JOB_ID	ジョブID	STRING

実行中イベント情報

実行中のイベントに関する情報を取得できます。

テーブル名

#events

スキーマ

列名	内容	型
NODE_ADDRESS	処理実行中のノードのアドレス(system)	STRING
NODE_PORT	処理実行中のノードのポート(system)	INTEGER
START_TIME	処理開始時刻	TIMESTAMP
APPLICATION_NAME	アプリケーション名	STRING
SERVICE_TYPE	サービス種別(SQL/TRANSACTION/CHECKPOINT/SYNC)	STRING
EVENT_TYPE	イベント種別(PUT/CP_START/SYNC_START など)	STRING
WORKER_INDEX	ワーカーのスレッド番号	INTEGER
CLUSTER_PARTITION_INDEX	クラスタパーティション番号	INTEGER

コネクション情報

接続中のコネクションに関する情報を取得できます。

テーブル名

#sockets

スキーマ

列名	内容	型
SERVICE_TYPE	サービス種別(SQL/TRANSACTION)	STRING
SOCKET_TYPE	ソケット種別	STRING
NODE_ADDRESS	接続元ノードのアドレス(ノード視点)	STRING
NODE_PORT	接続元ノードのポート(ノード視点)	INTEGER
REMOTE_ADDRESS	接続先ノードのアドレス(ノード視点)	STRING
REMOTE_PORT	接続先ノードのポート(ノード視点)	INTEGER
APPLICATION_NAME	アプリケーション名	STRING
CREATION_TIME	ソケット生成時刻	TIMESTAMP
DISPATCHING_EVENT_COUNT	イベントハンドリングの要求を開始した総回数	LONG
SENDING_EVENT_COUNT	イベント送信を開始した総回数	LONG

ソケット種別は次の通り。

値	説明
SERVER	サーバ間同士のTCP接続
CLIENT	クライアントとのTCP接続
MULTICAST	マルチキャストソケット
NULL	接続中など現時点で不明の場合

例

クライアントとのTCP接続(ソケット種別:CLIENT)の場合に限り、そのコネクションが 実行待ちかどうかを判別することができます。

具体的には、DISPATCHING_EVENT_COUNTの方がSENDING_EVENT_COUNTより大きい場合、 実行待ち状態のタイミングが存在した可能性が比較的高いと判定できます。

SELECT CREATION_TIME, NODE_ADDRESS, NODE_PORT, APPLICATION_NAME FROM "#sockets"
WHERE SOCKET_TYPE='CLIENT' AND DISPATCHING_EVENT_COUNT > SENDING_EVENT_COUNT;

CREATION_TIME             NODE_ADDRESS   NODE_PORT  APPLICATION_NAME
--------------------------------------------------------------------
2019-03-27T11:30:57.147Z  192.168.56.71  20001      myapp
2019-03-27T11:36:37.352Z  192.168.56.71  20001      myapp
          :