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

Importante

Esta tabela do sistema está em Visualização pública. Para acessar a tabela, o esquema deve ser habilitado 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.

Caminho da tabela: Esta tabela do sistema está localizada em system.query.history.

Usando a tabela de histórico de consultas

A tabela de histórico de consultas 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 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 Editor, Tableau e Power BI. Este campo é derivado de informações fornecidas por aplicativos cliente. Embora se espere que os valores permaneçam estáticos ao longo do tempo, isso não pode ser garantido.	Databricks SQL Editor
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, excluindo 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_result_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
query_source	estruturar	Uma struct que contém pares chave-valor que representam uma ou mais entidades Databricks que estiveram envolvidas na execução desta instrução, como trabalhos, blocos de anotações ou painéis. Este campo regista apenas entidades Databricks.	{ job_info: { job_id: 64361233243479 job_run_id: 887406461287882 job_task_key: “job_task_1” job_task_run_id: 110378410199121 }
executed_as	string	O nome do usuário ou entidade de serviço cujo privilégio foi usado para executar a instrução.	example@databricks.com
executed_as_user_id	string	A ID do usuário ou entidade de serviço cujo privilégio foi usado para executar a instrução.	2967555311742259

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 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.