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 este insight. Para obter a lista de rótulos, consulte Tópicos do Insight.

Tópicos do Insight¶

Para insight_topic coluna, 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:
JOIN: Insights sobre a eficiência de operações JOIN na consulta. Esse rótulo se aplica aos seguintes tipos de insights:
AGGREGATE: Insights sobre a eficiência de operações de agregação na consulta. Esse rótulo se aplica aos seguintes tipos de insights:
- QUERY_INSIGHT_INEFFICIENT_AGGREGATE
UNION: Insights sobre a eficiência de operações UNION na consulta. Esse rótulo se aplica aos seguintes tipos de insights:
- QUERY_INSIGHT_UNNECESSARY_UNION_DISTINCT
WAREHOUSE: Insights sobre o warehouse usado para a consulta. Esse rótulo se aplica aos seguintes tipos de insights:
- QUERY_INSIGHT_REMOTE_SPILLAGE
- QUERY_INSIGHT_QUEUED_OVERLOAD

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';

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';

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()));

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;

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;