Hologres:クエリインサイトの取得

前提条件

開始する前に、以下を確認してください。

• Hologres インスタンスにログインしていること。 詳細については、「インスタンスへのログイン」をご参照ください。

• スロークエリログをクエリするために必要な権限を持っていること。 詳細については、「スロークエリログの表示と分析」をご参照ください。

データ収集のしきい値

クエリインサイトは、それぞれ独自の収集ルールを持つ 2 つのデータソースからデータを取得します。 クエリを実行する前にこれらのしきい値を確認し、データがいつ利用可能になるかを把握してください。

クエリインサイトへのアクセス

クエリメタデータ

クエリメタデータは、Hologres のスロークエリログから取得されます。 [Query Metadata] タブで、[Instance Name] と [Query ID] を選択し、[Search] をクリックします。

このタブには、以下のセクションが表示されます。

基本情報

クエリのインスタンス ID、データベース、および Hologres バージョンを表示します。

クエリ情報

スロークエリログから収集された、クエリのユーザー、実行ステータス、および使用された実行エンジンを表示します。

リソース消費

スキャン機能や CPU 消費など、スロークエリログからのクエリ実行中のリソース使用状況を表示します。

その他の情報

クライアントの IP アドレスなど、スロークエリログからの追加メタデータを表示します。

SQL

完全な SQL ステートメントを表示します。 書式設定オプションを使用して整形して表示したり、ステートメントを直接コピーしたりできます。

クエリの詳細

クエリがパラメーター付きで実行された場合、このセクションには特定のパラメーター値が表示されます。 必要に応じて、パラメーターを SQL ステートメントにマージします。

実行プラン

スロークエリログの Plan フィールドから実行プランを表示します。

実行プランは、実行時間が 10 秒を超えるクエリに対してのみ収集されます。

プランの可視化機能を使用して、プランをグラフィカルに表示します。 実行プランの読み方については、「EXPLAIN と EXPLAIN ANALYZE」をご参照ください。

統計

スキャンされた行数や各演算子の実行時間など、スロークエリログの Statistics フィールドから取得した演算子レベルの消費データを表示します。 このデータを使用して、最も多くのリソースを消費している演算子を特定します。

読み取り/書き込みテーブル情報

クエリが読み取りまたは書き込みを行ったテーブルを一覧表示します。 いずれかのリンクをクリックすると、追加の分析画面に移動します。

• [Table Metadata]：選択したテーブルのテーブルメタデータページを開きます。 テーブルメタデータは hg_table_info テーブルから取得され、T+1 ベースで更新されます。つまり、本日作成されたテーブルは、明日以降にクエリできるようになります。

• [Table Lock Analysis]：テーブルロック分析ページを開き、クエリがデータ操作言語 (DML) 関連のロックを保持しているかどうかをチェックします。 これは、Hologres 実行エンジン (HQE) からの同時 DML 操作が原因で、固定プランのクエリが低速化する場合に役立ちます。

DDL 競合分析

クエリに関係するテーブルが、クエリの実行時間の 1 分前または 1 分後にデータ定義言語 (DDL) 操作の対象となったかどうかを示します。 クエリがエラーメッセージ "Query is canceled" で失敗した場合、このセクションは DDL 競合が失敗の原因であるかどうかを確認するのに役立ちます。

エラーメッセージ

クエリが失敗した場合、エラーの詳細がここに表示されます。 HoloWeb のクエリインサイトは、SQL エラーの解決に役立つ失敗の原因と推奨される修正を自動的に追加します。 一般的なSQLエラーについては、「Hologres SQL ステートメントに関する FAQ」をご参照ください。

テーブルメタデータ

テーブルメタデータは hg_table_info システムテーブルから取得され、毎朝1回更新されます。 データは T+1 ベースで利用可能です。

[読み取り/書き込みテーブル情報] セクションにある [Table Metadata] リンクをクリックするか、インスタンス名、データベース、スキーマ、およびメタデータ収集時間を直接入力して、テーブルメタデータに移動します。

このタブには、以下のセクションが表示されます。

• 基本情報：テーブル名、テーブルがパーティション化されているかどうか、およびパーティションの詳細。

• テーブルメタデータ情報：テーブルの作成時間、メタデータの収集時間、およびストレージ容量。

• テーブルプロパティ情報：プライマリキー (PK) や分散キーなど、テーブルに設定されているインデックス。

• [テーブルスキーマ情報]：フィールド、フィールドタイプ、null 許容性、およびデフォルト値。

プランの可視化

プランの可視化は、スロークエリログの Plan フィールドをグラフィカルな実行プランとして表示します。

プランデータは、10 秒以上実行されるクエリに対してのみ収集されます。

最初に確認する項目：まず、クエリメタデータの [統計] セクションを確認します。 このセクションには演算子レベルの行数と実行時間が表示されるため、完全なプランのグラフを調べる前に、最もリソースを消費する演算子を特定できます。

実行プランの概念については、「EXPLAIN と EXPLAIN ANALYZE」をご参照ください。

テーブルロック分析

テーブルロック分析は、クエリが Hologres 実行エンジン (HQE) で DML 操作 (INSERT、UPDATE、または DELETE) を生成したかどうかをチェックします。 テーブルで SDK または HQE の読み取りクエリと HQE の DML クエリが同時に実行されている場合、ロックが存在します。

テーブルロック分析は、DML 関連のロックのみを検出し、DDL ロックは検出しません。

ロック競合が検出された場合は、同じテーブルに対して SDK クエリと HQE DML 操作を同時に実行しないようにしてください。

トラブルシューティング

次のステップ

• スロークエリログの表示と分析

• EXPLAIN と EXPLAIN ANALYZE

• Hologres SQL ステートメントに関する FAQ

• 書き込みと更新のパフォーマンスの最適化