データゲートウェイコンソール (5501)
データレイクをブラウザから直接クエリできるコンソールです。ストレージエンジンごとに異なるクライアントを インストールする必要はなく、1つの画面で4つのクエリ言語を選択して使用できます。
| 項目 | 値 |
|---|---|
| アドレス (TLS) | https://<server-ip>:5501/ |
| ログイン | PP_DATA_GATEWAY_WEB_USER / PP_DATA_GATEWAY_WEB_PASSWORD |
| 別のアクセス方法 | 管理コンソール → ツール画面のData Gatewayカード |
プログラムから使用する場合
同じゲートウェイに接続するJavaクライアントがあります → Data Gatewayクライアント
画面
| 番号 | 説明 |
|---|---|
| ① | クエリモード — PQL · CQL · SQL · TQL. 選択するとその言語のエンジンに切り替わります |
| ② | テーブル一覧 — 現在のモードが参照するスキーマの全テーブル。検索可能で、お気に入り登録もできます |
| ③ | エディタ — Run(F9) · Format · Clear. タブで複数のクエリを同時に開けます |
| ④ | 結果 — Grid · JSON · Chart の3種類で表示し、Copy · CSV · JSON でダウンロードできます。行フィルタも別途あります |
| ⑤ | 最後の実行 — 成功/失敗 · 時刻 · 所要時間 · 行数 |
| ⑥ | 右側タブ — 履歴 · スニペット · スキーマ · キー · ステータス |
| ⑦ | 下部バー — 接続状態 · 現在のモード · 開いているタブ数、右側に最後の実行サマリー |
4つのモード — 何を尋ねる時にどれを使うか
| モード | 背後にあるもの | こんな時 |
|---|---|---|
| PQL | PostgreSQLメタストア | アセット · タグ · アラーム設定などのマスターデータ(mm_*) |
| CQL | Aster TSDB | 時系列の生データと集計(tm_*) |
| SQL | Spark | レイクハウス · 大容量分析 |
| TQL | 時系列エンジン | 時間ウィンドウ集計 · ギャップフィル |
モードを切り替えると、左側のテーブル一覧も一緒に変わります。現在どのモードかは、エディタの右側 («PQL · PostgreSQL meta-store»)と下部バーに併記されます。
右側タブ
スキーマ — 現在のモードのテーブルとカラムを展開して確認できます。テーブル名を覚える必要はありません。
キー — パーティションキーとクラスタリングキーを確認できます。Aster TSDBではクエリが実行できるかどうかは
キーが決めます — ALLOW FILTERING を追加する前に、まずここを確認してください。
履歴 — 実行したクエリがモード表示と共に蓄積されます。検索可能で、クリックすると再実行できます。
スニペット — 頻繁に使用するクエリを保存できます。
ステータス — ゲートウェイとバックエンドエンジンの接続状態。
CQLモード
Aster TSDBは任意の条件で検索できません
パーティションキーが検索軸です。キーにないカラムでフィルタリングするには全ノードをスキャンする必要があり、
ALLOW FILTERING が要求されますが、運用中のクラスターではそのクエリは危険です。
テーブルが104個ある理由や、どのキーを使用しているかは
データベースモデルに記載されています。
ゲートウェイが拒否するもの
コンソールはゲートウェイ上にあるため、ゲートウェイの制約をそのまま受けます。
- DDL — スキーマを変更する文
- 複数のステートメントを一度に
- TQL更新
スキーマ変更はこの経路では行いません → 設定変更方法