Referência da tabela do sistema de histórico de consultas

  • Artigo

Importante

Esta funcionalidade está em Pré-visualização Pública. O esquema deve estar habilitado para estar visível em seu system catálogo. Para obter mais informações, consulte Habilitar esquemas de tabela do sistema

Este artigo inclui informações sobre a tabela do sistema de histórico de consultas, incluindo uma estrutura de tópicos do esquema da tabela.

Importante

Para acessar a tabela do sistema de histórico de consultas, você deve habilitar o query esquema. Para obter instruções sobre como habilitar esquemas de sistema, consulte Habilitar esquemas de tabela do sistema.

Usando a tabela de histórico de consultas

A tabela de histórico de consultas, localizada em system.query.history, inclui registros para cada instrução SQL executada usando armazéns SQL. A tabela inclui registros de toda a conta de todos os espaços de trabalho na mesma região a partir da qual você acessa a tabela.

Por padrão, apenas os administradores têm acesso à tabela do sistema. Se você quiser compartilhar os dados da tabela com um usuário ou grupo, o Databricks recomenda a criação de uma exibição dinâmica para cada usuário ou grupo. Consulte Criar uma vista dinâmica.

Esquema da tabela do sistema do histórico de consultas

A tabela do sistema de histórico de consultas usa o seguinte esquema:

Nome da coluna Tipo de dados Description Exemplo
account_id string ID da conta. 11e22ba4-87b9-4cc2

-9770-d10b894b7118
workspace_id string A ID do espaço de trabalho onde a consulta foi executada. 1234567890123456
statement_id string O ID que identifica exclusivamente a execução da instrução. Você pode usar essa ID para localizar a execução da instrução na interface do usuário do Histórico de Consultas. 7a99b43c-b46c-432b

-b0a7-814217701909
session_id string O ID da sessão do Spark. 01234567-cr06-a2mp

-t0nd-a14ecfb5a9c2
execution_status string O estado de rescisão da declaração. Os valores possíveis são:

* FINISHED: a execução foi bem sucedida
* FAILED: a execução falhou com o motivo da falha descrito na mensagem de erro que acompanha o documento
* CANCELED: a execução foi cancelada		 FINISHED
compute estruturar Um struct que representa o tipo de recurso de computação usado para executar a instrução e a ID do recurso, quando aplicável. O type valor será ou WAREHOUSE SERVERLESS_COMPUTE. {

type: WAREHOUSE,

cluster_id: NULL,

warehouse_id: ec58ee3772e8d305

}
executed_by_user_id string A ID do usuário que executou a instrução. 2967555311742259
executed_by string O endereço de e-mail ou nome de usuário do usuário que executou a instrução. example@databricks.com
statement_text string Texto da instrução SQL. Se você configurou chaves gerenciadas pelo cliente, statement_text está vazio. SELECT 1
statement_type string O tipo de instrução. Por exemplo: ALTER, COPY, eINSERT. SELECT
error_message string Mensagem descrevendo a condição de erro. Se você configurou chaves gerenciadas pelo cliente, error_message está vazio. [INSUFFICIENT_PERMISSIONS]

Insufficient privileges:

User does not have

permission SELECT on table

'default.nyctaxi_trips'.
client_application string Aplicativo cliente que executou a instrução. Por exemplo: Databricks SQL, Tableau e Power BI. Databricks SQL
client_driver string O conector usado para se conectar ao Azure Databricks para executar a instrução. Por exemplo: Databricks SQL Driver for Go, Databricks ODBC Driver, Databricks JDBC Driver. Databricks JDBC Driver
total_duration_ms bigint Tempo total de execução da instrução em milissegundos (excluindo o tempo de busca do resultado). 1
waiting_for_compute_duration_ms bigint Tempo gasto aguardando que os recursos de computação sejam provisionados em milissegundos. 1
waiting_at_capacity_duration_ms bigint Tempo gasto na fila de espera pela capacidade de computação disponível em milissegundos. 1
execution_duration_ms bigint Tempo gasto na execução da instrução em milissegundos. 1
compilation_duration_ms bigint Tempo gasto carregando metadados e otimizando a instrução em milissegundos. 1
total_task_duration_ms bigint A soma de todas as durações de tarefas em milissegundos. Esse tempo representa o tempo combinado necessário para executar a consulta em todos os núcleos de todos os nós. Pode ser significativamente maior do que a duração do relógio de parede se várias tarefas forem executadas em paralelo. Pode ser menor do que a duração do relógio de parede se as tarefas aguardarem pelos nós disponíveis. 1
result_fetch_duration_ms bigint Tempo gasto, em milissegundos, para buscar os resultados da instrução após a conclusão da execução. 1
start_time carimbo de data/hora A hora em que a Databricks recebeu a solicitação. As informações de fuso horário são registradas no final do valor com +00:00 a representação UTC. 2022-12-05T00:00:00.000+0000
end_time carimbo de data/hora A hora em que a execução da instrução terminou, incluindo o tempo de busca de resultados. As informações de fuso horário são registradas no final do valor com +00:00 a representação UTC. 2022-12-05T00:00:00.000+00:00
update_time carimbo de data/hora A última vez que a declaração recebeu uma atualização de progresso. As informações de fuso horário são registradas no final do valor com +00:00 a representação UTC. 2022-12-05T00:00:00.000+00:00
read_partitions bigint O número de partições lidas após a poda. 1
pruned_files bigint O número de arquivos removidos. 1
read_files bigint O número de arquivos lidos após a poda. 1
read_rows bigint Número total de linhas lidas pela instrução. 1
produced_rows bigint Número total de linhas retornadas pela instrução. 1
read_bytes bigint Tamanho total dos dados lidos pela instrução em bytes. 1
read_io_cache_percent número inteiro A porcentagem de bytes de dados persistentes lidos do cache de E/S. 50
from_results_cache boolean TRUE indica que o resultado da instrução foi obtido no cache. TRUE
spilled_local_bytes bigint Tamanho dos dados, em bytes, gravados temporariamente no disco durante a execução da instrução. 1
written_bytes bigint O tamanho em bytes de dados persistentes gravados no armazenamento de objetos na nuvem. 1
shuffle_read_bytes bigint A quantidade total de dados em bytes enviados pela rede. 1

Exibir o perfil de consulta para um registro

Para navegar até o perfil de consulta de uma consulta com base em um registro na tabela de histórico de consultas, faça o seguinte:

  1. Identifique o registro de interesse e, em seguida, copie o statement_idarquivo .
  2. Faça referência ao registro workspace_id para garantir que você esteja conectado ao mesmo espaço de trabalho que o registro.
  3. Clique em Ícone Histórico Histórico de Consultas na barra lateral do espaço de trabalho.
  4. No campo ID da declaração, cole o statement_id no registro.
  5. Clique no nome de uma consulta. Uma visão geral das métricas de consulta é exibida.
  6. Clique em Ver perfil de consulta.