WebUI ガイド
VeloDB Enterprise WebUI("WebUI")は、データ開発シナリオ向けのデータ開発プラットフォームであり、データの管理と探索を支援し、Navicatの代替として使用できます。
主な機能
- ログイン : WebUIで異なるデータベースユーザーを使用してクラスターにログインします。
- データ : データベース内のデータを表示および管理します。現在は表示をサポートしています。
- クエリ :
- SQLエディター : クエリの実行、クエリ履歴の表示、クエリの保存をサポートする使いやすいSQLクエリエディター。
- ログ解析 : ログシナリオ向けに設計されたユーザーフレンドリーな解析ツールで、SQLフィルタリングや検索などの機能をサポートします。
- セッション管理 : 実行中のSQLクエリを管理し、ユーザーがSQLクエリを表示および強制終了できるようにします。
- クエリ監査 : 低速クエリをフィルタリングしてプロファイルを表示できるワンストップクエリ履歴監査ツール。
- ワークロード管理 : Workload Groupsの迅速な作成、編集、表示をサポートします。
- 権限 : データベース内のユーザーとロールを管理し、それらに権限を付与および取り消します。
- インポート : インポートタスクの表示およびインポートタスクの操作をサポートします。
登録とログイン
WebUIサービスの使用

VeloDB Managerで、VeloDB-Dorisをデプロイしている場合、左サイドバーメニューでWebUIの入口を見つけることができます。
WebUIへのサインイン

FE IP、FE JDBCポート、FE HTTPポート、ユーザー名、パスワードを入力する必要があります。
Managerからサインインリンクをクリックした場合、FE IP、FE JDBCポート、FE HTTPポートは事前入力されているはずです。
WebUIにログインするためのユーザー名とパスワードは、データベースと同じものです。クラスターのrootまたはadminパスワードを忘れた場合は、クラスターの設定モジュールで変更できます。
ログインアカウントとパスワードを記録しませんが、ブラウザに付属の記録機能を使用できます。
データ
「データ」モジュールは、WebUIがデータベースを管理する基本機能であり、主に2つの機能があります:
1、データとその組織形態の確認(データベースTable構造、データサイズ、Table作成ステートメント、Tableフィールド情報、データプレビューなど)。
2、データの追加、削除、変更(データベースオブジェクトの作成と削除、ストレージ戦略の変更など)。この部分の機能はまだ実装中で、一時的に使用できません。
データモジュールは、データベース内のデータの組織形態に従って表示され、カタログ -Database -Table /Viewに分かれています。
カタログ
Catalogはデータベースのコレクションです。
Catalogは内部catalogと外部catalogに分かれています。内部catalogにはDoris独自のデータベースが含まれ、外部catalogはHive、Iceberg、Hudiなどに接続してクエリを実行できます。

Database
DatabaseはTableとビューのコレクションです。Databaseはcatalogに属します。
ディレクトリを選択すると、ディレクトリ下のデータベース、データベースのサイズ、変更時刻を表示できます。同時に、データベースの削除と新規作成ができます。

Table
Tableは、VeloDBデータウェアハウスの基本単位であり、tableはdatabaseに属します。
データベースが選択されると、データベース下のTable、Tableのサイズ、作成・変更時刻を確認できます。
現在のバージョンでは、Tableの削除ができ、将来のバージョンでは、WebUIでTableの作成とTableのライフサイクル管理ができるようになります。

Table詳細
Table詳細ページでは、Table定義といくつかの基本属性を表示できます。
将来的には、ここでTableのライフサイクルの表示と管理をサポートし、より豊富なストレージ関連の統計情報を提供します。
将来、VeloDB WebUIは、ローカルファイルのTableへのアップロードもサポートして、軽量Tableインポート機能を完成させます。

フィールド情報
ここでは、Base TableとそのRollupまたはマテリアライズドビューのフィールド情報を確認できます。

インデックス
ここは、Table内のインデックス情報です。VeloDBには多くのインデックスのような高速化手法があります。ここでは、パーティション、プライマリキー、rollupは一時的にインデックスとして扱われず、Zonemap、Bloomfilter、Bitmap/Inverted Indexのみが表示されます。

データ概要
概要の表示はクラスターリソースを消費するため、データ概要を表示するには利用可能なクラスターが必要です。
「合計 x データ」はメタデータサービスから取得されるため、遅延がある可能性があり、実際のTable行数を反映しない場合があります。

View
ビューは、SQLステートメントの結果セットのTableベースの視覚化です。WebUIでは、ビューをTableとは別に扱い、マテリアライズドビューはビューの範囲に含まれません。
ビューページは、Tableページとほぼ同様で、ビューにない属性(インデックスや詳細など)は表示されません。
データをプレビューできますが、プレビュービューデータはクエリを開始し、クラスターリソースを消費します。

ファンクション
Functionは、クエリ、データ操作、またはストアドプロシージャ中に再利用できるCode Blockの一種です。Functionは入力パラメータを受け取り、計算結果を返します。複雑なクエリロジックを簡略化し、コードの可読性と保守性を向上させることができます。

クエリ
SQLエディター
クエリ結果は編集ボックスの下に返され、クエリによって返されたエラーまたは成功ステータスと情報もクエリ結果に表示されます。
同時に、ドロップダウンボタン実行(LIMIT 1000)をクリックして実行およびダウンロードに切り替えることで、クエリ結果をダウンロードできます。
注意 現在、一度に複数のクエリを実行した場合、最初のQueryの結果が返され、後のバージョンで他の戻り値を表示する機能を追加予定です。

クエリ履歴のQuery IDをクリックして、クエリ詳細を表示できます。
注意 非クエリステートメントや失敗したステートメントにはQuery IDはありません。

デフォルトでは、WebUIで開始されたクエリに対してクエリプランが有効になっており、これは単一クエリのパフォーマンスに影響しません。「Query Statement」をクリックして実行プランページに入ります。
SQLエディターで作成したタブと開始したクエリは自動的に保存されます。タブをダブルクリックして保存されたSQLのタイトルを変更できます。保存されたクエリでは、保存されたクエリを表示して再度開くことができます。

セッション管理
セッション管理は、データベースまたはデータ解析環境でのアクティブなSQLセッションの管理を扱います。現在実行中のすべてのSQLクエリを表示し、問題を引き起こしているか予想より長く実行されているクエリを終了(kill)するオプションがあります。
管理者がリソース使用量を管理し、重要なクエリを優先順位付けできるようにすることで、システムパフォーマンスを向上させ、実行時間、クエリを開始したユーザー、使用されているリソースなど、各セッションに関する詳細情報を提供します。



クエリ監査
クエリ監査は、システムで実行されたクエリ履歴を監査・解析するための包括的なツールです。ユーザーが低速パフォーマンスクエリをフィルタリングして特定できるようにし、これはデータベースパフォーマンスの最適化に不可欠です。
このツールには、各クエリの実行プランとリソース使用量に関する深い洞察を提供するプロファイリング機能が含まれています。クエリパフォーマンスの追跡、傾向の発見、時間経過による問題の診断のためのワンストップソリューションとして機能します。

ワークロード管理
ワークロード管理は、Workload Groupsの迅速な作成、編集、表示をサポートします。Workload Groupsは、クラスター内のクエリおよびインポート負荷に対するCPU/メモリ/IOリソース使用量を管理し、クラスター内のクエリの最大同時実行数を制御するために使用できます。

admin権限を持つユーザーは、workload groupを作成、変更、削除できます。

権限
ユーザー
VeloDBクラスター内のユーザーを表示します。
Admin権限を持つユーザーのみが、他のユーザーを追加・変更できます。

このページで新しいユーザーを作成できます。ユーザー名以外の内容は任意です。ただし、セキュリティ強化のため、ユーザーにパスワードを追加し、ホストへのアクセスを制限することを強くお勧めします。

ロール
ここでは、VeloDB内のロールを管理し、ロールに対する認証操作も実行できます。
Admin権限を持つユーザーのみが、他のロールを追加・変更できます。

認証
ユーザーまたはロールの詳細ページで、認証/取り消し操作を実行できます。
認証/取り消し作業を実行するには、Adminまたは対応するレベルでのGrant権限が必要です。
WebUIでは、権限を3つのカテゴリに分けています:
- グローバル: グローバル権限はGlobalレベルの権限です。グローバル権限があると、データベース内のすべての対応するオブジェクトに対して自動的に対応する権限を持ちます。
- データ: データリソースの権限を指します。レベルに応じて認証できます。親レベルの権限があると、その子コンテンツの対応する権限を自動的に持ちます。
- リソース: rootまたはadminユーザーのみがリソースを作成できます。現在サポートされている外部リソースには、Spark、ODBC、S3、JDBC、HDFS、HMS、ESが含まれます。

インポート
インポートモジュールで対応するデータベースのインポートタスクリストを表示し、これらのインポートタスクに対して関連操作を実行できます。

インポートタスクの名前をクリックして、インポートタスクの詳細を表示します。
