Referência da tabela do sistema de histórico de consultas
Prévia
Essa tabela do sistema está em Pré-visualização Pública. Para acessar a tabela, o esquema deve estar habilitado em seu catálogo system
. Para obter mais informações, consulte Habilitar esquemas de tabelas do sistema.
Este artigo inclui informações sobre a tabela do sistema de histórico de consultas, incluindo um esboço do esquema da tabela.
Importante
Para acessar a tabela do sistema de histórico de consultas, o senhor deve ativar o esquema query
. Para obter instruções sobre como ativar os esquemas do sistema, consulte Ativar esquemas de tabelas do sistema.
Usando a tabela de histórico de consultas
A tabela de histórico de consultas, localizada em system.query.history
, inclui registros de cada execução de instrução SQL usando o warehouse SQL. A tabela inclui registros de todo o accountde todos os espaços de trabalho na mesma região de onde o senhor acessa a tabela.
Em default, somente os administradores têm acesso à tabela do sistema. Se quiser compartilhar os dados da tabela com um usuário ou grupo, o site Databricks recomenda a criação de um view dinâmico para cada usuário ou grupo. Consulte Criar um site dinâmico view.
Consultar o esquema da tabela do sistema histórico
A tabela do sistema de histórico de consultas usa o seguinte esquema:
Nome da coluna |
Tipo de dados |
Descrição |
Exemplo |
---|---|---|---|
|
string |
ID do site account. |
|
|
string |
O ID do site workspace onde a consulta foi executada. |
|
|
string |
O ID que identifica de forma exclusiva a execução da declaração. O senhor pode usar esse ID para localizar a execução da declaração na Query History UI. |
|
|
string |
A ID da sessão do Spark. |
|
|
string |
O estado de encerramento da declaração. Os valores possíveis são:
|
|
|
struct |
Uma estrutura que representa o tipo de compute recurso usado para executar a declaração e o ID do recurso, quando aplicável. O valor |
|
|
string |
O ID do usuário que executou a declaração. |
|
|
string |
O endereço email ou o nome de usuário do usuário que executou a declaração. |
|
|
string |
Texto da instrução SQL. Se o senhor tiver configurado a chave de gerenciar o cliente, |
|
|
string |
O tipo de declaração. Por exemplo: |
|
|
string |
Mensagem que descreve a condição de erro. Se o senhor tiver configurado a chave de gerenciar o cliente, |
|
|
string |
Aplicativo cliente que executa a declaração. Por exemplo: Databricks SQL, Tableau e Power BI. |
|
|
string |
O conector usado para se conectar a Databricks para executar a declaração. Por exemplo: Databricks SQL Driver for Go, Databricks ODBC Driver, Databricks JDBC Driver. |
|
|
bigint |
Tempo total de execução da declaração em milissegundos (excluindo o tempo de busca de resultados). |
|
|
bigint |
Tempo de espera para que o compute recurso seja provisionado, em milissegundos. |
|
|
bigint |
Tempo de espera na fila para a capacidade compute disponível, em milissegundos. |
|
|
bigint |
Tempo gasto na execução da declaração em milissegundos. |
|
|
bigint |
Tempo gasto para carregar metadados e otimizar a declaração em milissegundos. |
|
|
bigint |
A soma de toda a duração da tarefa em milissegundos. Esse tempo representa o tempo combinado necessário para executar a consulta em todos os núcleos de todos os nós. Ela pode ser significativamente mais longa do que a duração do relógio de parede se várias tarefas forem executadas em paralelo. Ela pode ser mais curta do que a duração do relógio de parede se a tarefa esperar por nós disponíveis. |
|
|
bigint |
Tempo gasto, em milissegundos, para buscar os resultados da declaração após o término da execução. |
|
|
timestamp |
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 |
|
|
timestamp |
A hora em que a execução da declaração terminou, incluindo o tempo de busca de resultados. As informações de fuso horário são registradas no final do valor com |
|
|
timestamp |
A hora em que a declaração recebeu uma atualização de progresso pela última vez. As informações de fuso horário são registradas no final do valor com |
|
|
bigint |
O número de partições lidas após a poda. |
|
|
bigint |
O número de arquivos podados. |
|
|
bigint |
O número de arquivos lidos após a poda. |
|
|
bigint |
Número total de linhas lidas pela declaração. |
|
|
bigint |
Número total de linhas retornadas pela declaração. |
|
|
bigint |
Tamanho total dos dados lidos pela declaração em bytes. |
|
|
int |
A porcentagem de bytes de dados persistentes lidos do cache de E/S. |
|
|
boolean |
|
|
|
bigint |
Tamanho dos dados, em bytes, gravados temporariamente no disco durante a execução da instrução. |
|
|
bigint |
O tamanho em bytes dos dados persistentes gravados no armazenamento de objetos cloud. |
|
|
bigint |
A quantidade total de dados em bytes enviados pela rede. |
|
Visualizar o perfil de consulta de 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
Identifique o registro de interesse e, em seguida, copie o
statement_id
do registro.Consulte o
workspace_id
do registro para garantir que o senhor esteja conectado ao mesmo workspace que o registro.Clique em
Query History na barra lateral workspace.
No campo Statement ID, cole o
statement_id
no registro.Clique no nome de uma consulta. É exibida uma visão geral das métricas de consulta.
Clique em See query profile (Ver perfil de consulta).