Tabela de sistema de histórico de queries agora está disponível de forma geral

A tabela do sistema system.query.history agora está disponível de forma geral (GA). Ela centraliza registros de execução de queries em toda a conta, permitindo auditar tempos de resposta, status e origens de computação.

Para que serve

Imagine que você precisa auditar o desempenho de queries em vários workspaces e identificar quais equipes consomem mais recursos. Com essa tabela, você consegue:

• Consultar o status de execução de qualquer query em SQL warehouses ou computação serverless.
• Analisar métricas detalhadas de duração, como tempo de espera na fila e tempo de compilação.
• Rastrear a origem das queries executadas por notebooks, jobs ou ferramentas de BI.

Como usar

Acesse os dados diretamente via SQL usando o caminho padrão da tabela do sistema.

SELECT 
  statement_id,
  execution_status,
  total_duration_ms,
  executed_by
FROM 
  system.query.history
WHERE 
  start_time >= current_date() - interval 7 days
ORDER BY 
  total_duration_ms DESC
LIMIT 10;

O que acontece nesse código:

1. A consulta lê o histórico diretamente da tabela de sistema system.query.history.
2. Filtra as queries executadas nos últimos 7 dias com base na coluna de tempo de início.
3. Ordena os resultados pelas queries mais lentas com base na duração total em milissegundos.
4. Retorna as 10 principais execuções para análise.

Limitações e requisitos

• Os registros ficam disponíveis tipicamente dentro de uma hora após a execução.
• Por padrão, apenas administradores possuem acesso direto à tabela de sistema.
• O texto completo da instrução SQL retorna mascarado (<REDACTED>) para usuários que não sejam administradores ou membros do grupo databricks_pii_access.