スキーマ:

ACCOUNT_USAGE

QUERY_INSIGHTS ビュー

このAccount Usageビューには、各 クエリ用に生成された洞察 の行が表示されます。

列名

説明

start_time

TIMESTAMP_LTZ

クエリの開始時刻。

end_time

TIMESTAMP_LTZ

クエリの終了時間です。

total_elapsed_time

NUMBER

クエリの経過時間の合計(ミリ秒単位)。

query_id

VARCHAR

SQL ステートメントの内部/システム生成識別子。

query_hash

VARCHAR

正規化された SQL テキストに基づいて計算された ハッシュ値

query_parameterized_hash

VARCHAR

パラメーター化されたクエリに基づいて計算された ハッシュ値

warehouse_id

VARCHAR

使用されていたウェアハウスの内部/システム生成識別子。

warehouse_name

VARCHAR

クエリが実行されたウェアハウス(ある場合)。

insight_instance_id

NUMBER

インサイトの内部/システム生成識別子。

insight_type_id

VARCHAR

インサイトタイプ の識別子。

message

VARIANT

インサイトに関する構造化情報と詳細。

suggestions

ARRAY

それぞれにインサイトの推奨アクションを含む文字列の配列。

is_opportunity

BOOLEAN

``true``の場合、インサイトにはクエリのパフォーマンスを向上させるための提案が含まれます。例:

  • タイプ IDおよび``QUERY_INSIGHT_NO_FILTER_ON_TOP_OF_TABLE_SCAN``のインサイトの場合、この列には true が含まれます。インサイトにパフォーマンスを向上させるための提案が含まれているためです。

  • タイプ IDおよび``QUERY_INSIGHT_FILTER_WITH_CLUSTERING_KEY``のインサイトの場合、この列には false が含まれます。インサイトにはパフォーマンスを向上させるための提案が含まれていないためです。

insight_topic

VARCHAR

このインサイトによって検出されたパフォーマンスへの影響のタイプを識別するラベル。

ラベルは次のいずれかになります。

  • TABLE_SCAN:テーブルへのアクセスの効率に関する洞察。このラベルは、以下のタイプの洞察に適用されます:

    • QUERY_INSIGHT_NO_FILTER_ON_TOP_OF_TABLE_SCAN

    • QUERY_INSIGHT_INAPPLICABLE_FILTER_ON_TABLE_SCAN

    • QUERY_INSIGHT_UNSELECTIVE_FILTER

    • QUERY_INSIGHT_FILTER_WITH_CLUSTERING_KEY

    • QUERY_INSIGHT_SEARCH_OPTIMIZATION_USED

  • JOIN:クエリでの JOIN の操作の効率に関する洞察。このラベルは、以下のタイプの洞察に適用されます:

    • QUERY_INSIGHT_JOIN_WITH_NO_JOIN_CONDITION

    • QUERY_INSIGHT_NESTED_EXPLODING_JOIN

    • QUERY_INSIGHT_EXPLODING_JOIN

  • WAREHOUSE:クエリに使用されるウェアハウスに関する洞察。このラベルは、以下のタイプの洞察に適用されます:

    • QUERY_INSIGHT_REMOTE_SPILLAGE

使用上の注意

  • ビューの遅延は最大90分です。

次の例では、 ID``01bd3a9d-0910-8327-0000-09717704c032``を含むクエリのクエリインクエリを で返します:

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE query_id = '01bd3a9d-0910-8327-0000-09717704c032';
Copy

次の例では、同じ パラメーター化されたクエリテキストのハッシュ があるクエリのクエリインサイトを返します。これらは、ステートメント内で指定されたリテラルを除き、同じ SELECT ステートメントを使用するクエリです。

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE query_parameterized_hash = '4bb66effc1a3c8b4e94a728f7caaa736';
Copy

次の例は、過去1週間に実行されたクエリのクエリインサイトを返します。

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE start_time > TO_DATE(DATEADD(DAY, -7, CURRENT_DATE()));
Copy

次の例では、過去1週間に実行され、完了までに1時間以上かかったクエリのクエリクエリサイトを返します。

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE start_time > TO_DATE(DATEADD(DAY, -7, CURRENT_DATE()))
    AND total_duration > 3600000;
Copy

次の例では、過去1週間に実行され、完了までに1時間以上かかり、 ID``84412315``ウェアハウスと を使用したクエリのクエリ洞察を返します:

SELECT query_id, insight_type_id, message, suggestions
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_INSIGHTS
  WHERE start_time > TO_DATE(DATEADD(DAY, -7, CURRENT_DATE()))
    AND total_duration > 3600000
    AND warehouse_id = 84412315;
Copy