ステートメントの実行トレース¶

ステートメントを実行すると、その実行のトレースを要求できます。また、クエリを実行する前に実行プランを取得することもできます。実行しないと判明しないパラメータ (実行時間など) を除けば、どちらの場合も表示される情報は同じです。

実行プランはツリー形式の図として表示され、各ノードは以下のエレメントのいずれかを表します。

• ツリーのルートである「実行ノード」。クエリに関する情報が表示されます。

• ステートメントの実行中に発生する中間ビュー

• ソースからのデータの取得

これらのノードの主な属性は以下のとおりです。

• Type: ノードがビューである場合は、ビューのタイプ (基本ビュー、和結合、結合、選択、投影など) を表します。ノードがデータソースへのアクセス (ラッパー) である場合は、ソースのタイプ (JDBC、ODBC、Web サービスなど) を表します。

  トレースで主要なノードは「実行」ノード (トレース最上位のノード) であり、その属性はクエリ全体の状態を表します。

• Execution time: ノードとそのサブノードの実行に要した時間 (ミリ秒)。「実行」ノードの場合はクエリの実行時間です。

• Start time: Virtual DataPort サーバーによってノードの実行が開始された日時。「実行」ノードの場合は、Virtual DataPort サーバーでクエリを受け取った日時です。

• End time: Virtual DataPort サーバーによってノードとそのサブノードの実行が完了した日時。「実行」ノードの場合は、Virtual DataPort サーバーでクエリの実行を完了した日時です。

• Response time: 処理する最初の行をノードで受け取った日時。「実行」ノードの場合は、クエリ結果の最初の行を Virtual DataPort サーバーで取得した日時です。

  どの行もノードで処理されなかった場合、この属性の値は unknown です。

• Effective time: ノードの実行に要した時間。実行ツリーにある他のノードの作業完了を待機していた時間は算入されません。

• Data serialization time (「実行プラン」ノードでのみ表示): クライアントアプリケーションに送信するバイトストリームにクエリ結果を変換するために Virtual DataPort サーバーで要した時間。

• Number of rows: ノードから返された行の数。「実行」ノードの場合はクエリから返された行の数です。

• State: ノードが正常に実行されたかどうか、またはノードの実行またはそのいずれかのサブノードの実行でエラーが発生したかどうかを示します。

  この属性のすべての値については、付録「 実行トレース情報 」の表「 クエリの実行トレースのノードの「State」属性の値 」を参照してください。

• Completed: [yes] の場合、ノードの実行が正常に完了しています。[no] の場合、ノードの実行またはそのいずれかのサブノードの実行でエラーが発生しています。

• Waiting time for execution (「実行」ノードのみ): Virtual DataPort サーバーによってクエリの実行が始まるまで、クエリがそのキューで待機していた時間 (ミリ秒)。

  同時リクエスト数がその制限値に達していると、クエリはそのキューに保持されます。この制限値は、[Administration] メニュー > [Server configuration] の [Concurrent requests] タブで構成します。この制限値の詳細については「 同時リクエスト数の制限 」を参照してください。

  [Execution time] の値には、[Waiting time for execution] の値も算入されます。

• Static optimization (「実行」ノードのみ): 自動簡素化に関するパラメータ。「 クエリの自動簡素化 」を参照してください。

  • Optimization time: 実行エンジンによるクエリプランの分析に要した時間。

  • 分析後にクエリプランが簡素化された場合、[Static optimized] は [yes] です。

• Cost optimization (「実行」ノードのみ): コストベースの最適化に関するパラメータ。この最適化については「 コストベースの最適化 」を参照してください。実行エンジンでコストオプティマイザーを使用して実行プランが選択される場合、トレースにも、その判断に関する以下の情報が保持されます。

  • Estimated number of rows, row size in bytes and data volume: クエリを実行せずに実行プランが取得された場合に表示されます。このノードから返される行数としてオプティマイザーで予測された値を示します。結合ノードの場合、その右側分岐での結合方針がハッシュまたはマージであると想定されます。

  • Indexes: 基盤となるデータソースでデータを取得するために使用されるとして、オプティマイザーで予測されるインデックス。

  • Total, Left Branch and Right Branch cost (結合ノードでのみ表示): 結合操作の合計コストおよびその分岐でのコスト。

• Optimizations applied (「実行」ノードのみ): エンジンがクエリのパフォーマンス改善に使用する方法のリスト。

• Accelerated with summaries (「実行」ノードのみ): 「サマリアクセラレーション」最適化が適用されている場合に使用されるサマリのリスト。

• Advanced parameters: 各ノードタイプの詳細を示します。その例を以下に示します。

  • 「ルート」ノードの場合、データソースに対して実行されたクエリおよびそのソースに接続するための URI。

  • Swapping and number of swapped rows: クエリのノードごとに、そのノードの実行中にデータがディスクにスワップされたかどうか、スワップされた場合はディスクにスワップされた行数を示します。上位の実行ノードには、クエリがスワップに使用するディスクの最大量と、クエリが同時に開いたスワップファイルの最大数も表示されます。

  • No delegation cause: クエリがソースデータベースに委任されなかった理由を示します。

    同一の JDBC または ODBC のデータソースから作成した複数のビューをクエリで使用している場合、Virtual DataPort では、クエリ全体をそのソースデータベースに委任しようとします。これにより、クエリを 1 つ実行するだけですべての結果を取得できます。クエリのプロセス全体をソースデータベースに委任できない場合は、委任できないビューの横に アイコンが表示され、委任できない理由が [No delegation cause] パラメータに示されます。たとえば、ソースデータベースでサポートされていない関数をクエリで使用していると、取得した結果を Virtual DataPort で後処理する必要があります。

    [No delegation cause] のメッセージは、委任されるようにビューを書き換えるうえで役に立ちます。

    単一の JDBC データソースのビューを伴うクエリが委任されない理由を以下に示します。

    • このクエリでは、データベースがサポートしていない関数または演算子を使用します。

    • このクエリでは複数の値を返す WHERE サブクエリを使用しており (たとえば、複数のフィールドがある IN 条件を使用)、データベースではこのタイプのサブクエリに対応していません。VDP では、Oracle、DB2、Postgresql、MySQL、Redshift などの一部のデータベースに対して、このタイプのサブクエリを委任しますが、このサブクエリに対応していても、委任がデフォルトで有効になっていないデータベースもあります。

    • このクエリには、ORDER BY フィールドのあるサブクエリが含まれます。

    • データソースの [Source configuration] の特定の設定が変更されています。一部の設定がクエリの委任に影響を与えます。たとえば、[Delegate Joins] を [No] に設定すると、データソースでは、このデータベースに JOIN を委任しません。Denodo Support によるアドバイスがない限り、これらの詳細設定を変更しないことをお勧めします。

クエリ実行ツリーの各ノードには、最も関連性が深いパラメータが表示されます。パラメータを右クリックして [Copy] をクリックすることで、その値をコピーできます。[Copy trace to clipboard] () をクリックすると、トレース全体をコピーできます。

実行トレースとその図を保存するには [Save] () をクリックします。

以下のクエリの実行トレースを、 下 の図に示します。

SELECT *
FROM internet_inc
WHERE summary REGEXP_LIKE '.*(Incident)|(Error).*'

データベースで REGEXP_LIKE 演算子がサポートされていない場合、そのデータベースにはクエリを委任できず、選択ノードには アイコンが表示されます。このアイコンは、指定した選択条件が Virtual DataPort で実行されることを意味しています。

実行トレースの主な用途はデバッグです。クエリの実行でエラーが発生した場合、その発生元ノードが赤色で表示されます。このノードをクリックすると、エラーの詳細を表示できます。クエリの実行トレースに表示されるアイコンと色の意味については、付録「 実行トレース情報 」を参照してください。

クエリの自動簡素化 (「 クエリの自動簡素化 」を参照) が有効な場合、クエリの実行対象のビューで定義されている階層と実行トレースが一致しないことがあります。

internet_inc ビューの実行トレース¶

以下 の図は、Web サービスデータソースにアクセスできない場合の incidents_sales 結合ビューの実行トレースを示しています。

エラーが発生している結合ビューの実行トレース¶

クエリの実行トレースを表示する以外に、クエリの実行前にその「クエリプラン」を確認できる方法があります。これにより、Virtual DataPort サーバーによってクエリがどのように実行されるかを、クエリを実行せずに知ることができます。この機能は、Virtual DataPort サーバーによって各結合操作 (マージ、ハッシュ、ネストなど) で使用される方法や、クエリがどのようにデータベースに委任されるかなどを確認できるので、複雑な階層を持つビューを扱う場合にきわめて効果的です。

これを表示するには、[Execute view] ダイアログで [Query Plan] をクリックします。クエリプランを計算するプロセスは、実際にクエリを実行する場合にきわめてよく似ていて、相違点は実際のデータソースにはアクセスしないことだけです。たとえば、ネスト結合の右側分岐の実行をシミュレーションするには、結合条件の右辺の属性値を Virtual DataPort サーバーで生成する必要があります。それらの値は必須であり、実行時には結合の左辺から取得した値が使用されるからです。ただし、クエリプランを取得する場合は実際の値が存在しないので、以下の表に示す値が使用されます。

SET 'com.denodo.vdb.interpreter.execution.saveTrace' = '<save trace configuration>';

SET 'com.denodo.vdb.interpreter.execution.saveTraceDir' = '<directory to store the traces>';