Esquema:

ACCOUNT_USAGE

Exibição QUERY_INSIGHTS

Essa visualização do uso da conta exibe uma linha para cada insight produzido para uma consulta.

Colunas

Nome da coluna

Tipo

Descrição

start_time

TIMESTAMP_LTZ

Hora de início da consulta.

end_time

TIMESTAMP_LTZ

Hora de término da consulta.

total_elapsed_time

NUMBER

Tempo total decorrido da consulta (em milissegundos).

query_id

VARCHAR

Identificador interno/gerado pelo sistema para a instrução SQL.

query_hash

VARCHAR

O valor de hash calculado com base no texto canônico SQL.

query_parameterized_hash

VARCHAR

O valor de hash calculado com base na consulta parametrizada.

warehouse_id

VARCHAR

Identificador interno/gerado pelo sistema do warehouse que foi utilizado.

warehouse_name

VARCHAR

Warehouse em que a consulta foi executada, se houver.

insight_instance_id

NUMBER

Identificador interno/gerado pelo sistema para a instância.

insight_type_id

VARCHAR

Identificador do tipo de insight.

message

VARIANT

Informações estruturadas e detalhes sobre o insight.

suggestions

ARRAY

Matriz de cadeias de caracteres, cada uma contendo uma ação recomendada para o insight.

is_opportunity

BOOLEAN

Se true, o insight incluirá sugestões para melhorar o desempenho da consulta. Por exemplo:

  • Para um insight com o ID de tipo QUERY_INSIGHT_NO_FILTER_ON_TOP_OF_TABLE_SCAN, essa coluna contém true porque o insight inclui sugestões para melhorar o desempenho.

  • Para um insight com o ID de tipo QUERY_INSIGHT_FILTER_WITH_CLUSTERING_KEY, esta coluna contém false porque o insight não inclui sugestões para melhorar o desempenho.

insight_topic

VARCHAR

Rótulo que identifica o tipo de impacto de desempenho detectado por esse insight.

O rótulo pode ser um dos seguintes:

  • TABLE_SCAN: Insights sobre a eficiência do acesso às tabelas. Esse rótulo se aplica aos seguintes tipos de insights:

    • 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: Insights sobre a eficiência de operações JOIN na consulta. Esse rótulo se aplica aos seguintes tipos de insights:

    • QUERY_INSIGHT_JOIN_WITH_NO_JOIN_CONDITION

    • QUERY_INSIGHT_NESTED_EXPLODING_JOIN

    • QUERY_INSIGHT_EXPLODING_JOIN

  • WAREHOUSE: Insights sobre o warehouse usado para a consulta. Esse rótulo se aplica aos seguintes tipos de insights:

    • QUERY_INSIGHT_REMOTE_SPILLAGE

Notas de uso

  • A latência da visualização pode ser de até 90 minutos.

Exemplos

O exemplo a seguir retorna os insights de consulta para a consulta com o 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

O exemplo a seguir retorna os insights de consulta para consultas que têm o mesmo hash de texto de consulta parametrizado. São consultas que usam a mesma instrução SELECT, exceto para os literais especificados na instrução.

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

O exemplo a seguir retorna os insights de consulta para consultas executadas durante a semana passada:

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

O exemplo a seguir retorna os insights de consulta para consultas que foram executadas durante a semana passada e levaram mais de uma hora para serem concluídas:

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

O exemplo a seguir retorna os insights de consulta para consultas executadas durante a semana passada, levaram mais de uma hora para serem concluídas e usaram o warehouse com o 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