QUERYTRACE

QUERYTRACEを使用して、単一問合せのパフォーマンスをデバッグします。問合せトレースは、Essbase問合せのパフォーマンス・メトリックのモニターに役立ちます。保持する情報は、個別のトレース・ログ・ファイルquery_trace.txtにレポートされます。

説明

QUERYTRACE構成は、集約ストレージ(ASO)キューブおよびBSOハイブリッド・モード・キューブにのみ適用されます。

この設定は、計算フローの問合せトレースを有効にします。問合せトレースの出力ファイルには次のものが含まれています:

  • 入力問合せ

  • 拡張された問合せのオドメータ

  • 問合せの計算単位に関する一般情報

  • 式および集約のリスト

  • 解決順に従った、問合せ時に計算または集約されたすべての出力セルの順序付きリスト

問合せトレース出力ファイルquery_trace.txtは、キューブ・ディレクトリに書き込まれます。

ノート:

問合せトラッキングと問合せトレースは異なります。

問合せトラッキングでは、集約ストレージ(ASO)キューブに対するユーザー取得統計を取得できます。これにより、Essbaseはビューベースの最適化を作成して集約のパフォーマンスを向上できます。これはデフォルトでオンです。関連するMaxL文は次のとおりです:

import query_tracking
export query_tracking
alter database enable query_tracking
query database appname.dbname get cube_size_info

問合せトレースは、ハイブリッド・モード・キューブを使用するブロック・ストレージ(BSO)など、集約ストレージ(ASO)キューブのEssbase問合せパフォーマンス・メトリックをモニターするのに役立ちます。これはデフォルトでオフです。これを有効にすると、Essbaseによってトレース・レポートにメトリックが記録されます。関連する構成パラメータ: TRACE_REPORT、QUERYTRACE、QUERYTRACETHRESHOLD、LONGQUERYTIMETHRESHOLD。

構文

QUERYTRACE n

問合せトレースを有効にするには、n-1に設定する必要があります。デフォルト値は0 (問合せトレースはオフ)です。

異なる問合せトレース・オプションを使用するタイミング

QUERYTRACE構成設定は、問題が確認された場合に単一の問合せのデバッグのために設計されています。トレース・ログをキューブ・ディレクトリにquery_trace.txtとして出力し、このファイルは、デフォルトで、各問合せの実行前にクリアされます。パフォーマンスに影響を及ぼす可能性があるため、QUERYTRACEは、長時間使用するためにアプリケーション構成で有効にしたままにしないでください。

ノート:

QUERYTRACEが-1に設定されている場合、同時問合せはパラレルで実行されず、パフォーマンスが影響を受ける可能性があります。トラブルシューティングの完了後にQUERYTRACEを無効にします。

TRACE_REPORT構成設定で提供する詳細は、QUERYTRACEよりも少なくなりますが、この構成設定は複数の同時問合せをトレースできます。TRACE_REPORTは、一定期間実行する多数の同時問合せについて情報を収集するために役立ちます。

QUERYTRACE -1

説明に示されているすべてのトレース機能が含まれるように問合せトレースを設定します。