Detalhes de predicados e tipos de query na LISTING_ACCESS_HISTORY

Para que serve

Imagine que você compartilha dados no Snowflake Marketplace e quer entender exatamente como os consumidores utilizam suas tabelas para otimizar os dados compartilhados. Com esta melhoria, você pode:

• Identificar quais tipos de query os consumidores executam, incluindo operações de descarregamento (unload).
• Analisar quais colunas entram em cláusulas de agrupamento, agregação e filtragem.
• Obter valores de predicado em colunas de data e timestamp para saber o intervalo histórico consultado.

Como usar

Você pode consultar a visão de histórico para verificar a faixa de valores de filtro por consumidor em colunas temporais.

select
  lah.consumer_account_organization,
  lah.consumer_account_name,
  sos.value:"objectName"::string as object_name,
  filters.value:"columnName"::string as column_name,
  min(filters.value:"columnValue"::date) as earliest_filter_value,
  max(filters.value:"columnValue"::date) as latest_filter_value,
  count(distinct lah.query_token) as n_queries
from SNOWFLAKE.DATA_SHARING_USAGE.LISTING_ACCESS_HISTORY as lah
join lateral flatten(input=>lah.share_objects_accessed) as sos
join lateral flatten(input=>sos.value, path=>'filterObjects') as filters
where true
  and lah.query_date >= dateadd('day', -7, current_date())
  and filters.value:"columnValue"::date is not null
group by 1,2,3,4
order by 1,2,3,4;

O que acontece nesse código:

1. Acessa a visão SNOWFLAKE.DATA_SHARING_USAGE.LISTING_ACCESS_HISTORY para buscar o histórico recente de consultas aos dados compartilhados.
2. Usa a função flatten para extrair os objetos acessados e os metadados da coluna filterObjects.
3. Filtra apenas registros dos últimos 7 dias onde há um valor de predicado de data válido.
4. Retorna a data mínima e máxima consultada por cada conta consumidora, agrupadas por organização, conta, objeto e coluna.

Limitações e requisitos

• O recurso está disponível de forma geral (GA).
• A latência da visão pode ser de até 2 dias.
• Os dados de histórico são retidos por 365 dias (1 ano).
• Para consultas anteriores à introdução da coluna QUERY_TYPE ou de outros tipos não suportados, o retorno pode exibir <redacted> ou NULL (como no caso de aplicações onde IS_APPLICATION é verdadeiro).