Configurações de administrador - Consultas

A partir do Looker 22.16, os administradores do Looker podem ativar o recurso experimental Administrador de consultas aprimorado dos laboratórios para melhorar a página Consultas. O recurso dos laboratórios melhora o desempenho na página Consultas e lista 500 consultas paginadas, em vez de 50.

A página Consultas na seção Banco de dados do menu Administrador lista informações sobre as últimas 50 consultas que o Looker enviou ao seu banco de dados. Para informações sobre consultas mais antigas que isso, veja a seção Uso do Looker.

Informações básicas de consulta

Coluna Definição
Tempo É o horário de início da consulta, exibido no fuso horário do aplicativo.
Status É o status da consulta, que pode incluir:
  • Cache: o Looker retornou os resultados do cache em vez de executar uma consulta duplicada no banco de dados.
  • Concluída: a consulta foi concluída.
  • Erro: não foi possível concluir a consulta porque um erro ocorreu. Os detalhes podem ser encontrados clicando no botão "Detalhes".
  • Cancelada: a consulta foi cancelada pelo Looker ou pelo usuário.
  • Aguardando PDT: a consulta precisa aguardar a criação de uma tabela derivada permanente para que ela possa ser executada.
  • Como criar PDT: uma tabela derivada permanente está em processo de criação.
  • Na fila: a consulta está aguardando ser executada porque muitas consultas já estão em andamento (as consultas podem ser limitadas pelo Looker na sua configuração de conexão ou no seu banco de dados).
  • Em execução: a consulta está em processo de execução.
  • Desconhecido: o Looker não conseguiu determinar o que aconteceu com essa consulta.
Conexão A conexão do Looker em que a consulta foi executada.
Usuário O usuário que executou essa consulta, se possível. Algumas consultas não são executadas por um usuário específico, como quando o Looker cria uma tabela derivada permanente ou quando um usuário desconhecido acessa uma aparência pública.
Origem A origem da consulta no Looker, como a página "Explorar" ou o SQL Runner. Se possível, um link para o Looked salvo ou para o ID da consulta com o nome do modelo e Explorar também será exibido. Algumas consultas não têm informações adicionais, como as executadas no SQL Runner.
Ambiente de execução O tempo necessário para executar a consulta. Isso inclui a construção da consulta, sempre que a consulta passa na fila, é transferida de ou para o banco de dados e a execução do banco de dados da consulta.

Se a consulta estiver em execução, o ambiente de execução mostrará quanto tempo a consulta está sendo executada. Para consultas executadas anteriormente, o ambiente de execução também mostrará uma estimativa do tempo necessário para concluir a execução da consulta. A estimativa é baseada na duração da última execução da consulta e mostrará algo como "de cerca de 2s"
Botão de detalhes Consulte a subseção O botão de detalhes nesta página para mais detalhes.

O botão "Detalhes"

Clique no botão Detalhes à direita de qualquer consulta para ver informações adicionais sobre ela. O pop-up Detalhes da consulta inclui o seguinte:

  • Uma seção Informações que inclui detalhes sobre a consulta (consulte a tabela a seguir).
  • Uma seção SQL que mostra o SQL bruto que foi executado no banco de dados. Comentários do contexto não aparecerá nas informações de Detalhes da consulta. Para evitar que os comentários afetem o armazenamento em cache das consultas, o Looker adiciona os comentários de contexto aos comandos SQL de saída logo antes de o SQL ser enviado ao banco de dados.
  • Um link Abrir no SQL Runner que abrirá a consulta no SQL Runner.

A seção Informações inclui as seguintes informações:

Seção Definição
ID do histórico O ID do histórico da consulta, se disponível.
Status É o status da consulta, conforme descrito acima.
Conexão A conexão do Looker em que a consulta foi executada.
Usuário O usuário que executou essa consulta, se possível. Algumas consultas não são executadas por um usuário específico, como quando o Looker cria uma tabela derivada permanente ou quando um usuário desconhecido acessa uma aparência pública.
Origem A origem da consulta no Looker, como a página Explorar ou o SQL Runner. Se possível, informações adicionais são exibidas, como um link para o Looked salvo, o ID da consulta, o nome do modelo, o nome do Explorar, os campos selecionados e assim por diante.
Horário de início É o horário de início da consulta, exibido no fuso horário do aplicativo.
Horário de término É o horário de término da consulta, exibido no fuso horário do aplicativo.
Ambiente de execução O tempo necessário para executar a consulta.

Eliminação de consultas

O Looker interrompe automaticamente uma consulta que está em execução quando você fecha a guia do navegador em que ela é executada. Os administradores do Looker também podem interromper uma consulta em execução na página Consultas. Os usuários com a permissão see_queries podem ver a página Consultas, mas apenas os administradores do Looker podem interromper uma consulta em execução. Qualquer consulta que ainda esteja em execução mostra um botão Parar à direita da consulta. Clique em Parar para interromper a consulta.

Para que o Looker elimina consultas, seu dialeto do banco de dados precisa ser compatível com a interrupção de consultas. A lista a seguir mostra quais dialetos são compatíveis com a interrupção de consultas na versão mais recente do Looker:

Tempos limite e consulta na fila

O Looker encerra as consultas que estão esperando na fila há muito tempo. Essa operação é chamada de tempo limite. Sua consulta pode ter vários tempos limite:

  • Tempo limite do pool de conexões: para evitar a sobrecarga do banco de dados com consultas simultâneas, o Looker retém o excesso de consultas simultâneas na fila de consultas do Looker e elimina as que permanecem na fila por muito tempo. Por padrão, são permitidas no máximo 75 consultas simultâneas por conexão, e o tempo limite das consultas na fila é atingido após 0 segundo. Para alterar esses padrões, defina as configurações de conexões máximas e tempo limite do pool de conexões em uma página de Configurações de conexões da conexão.

  • Limite e limite de consulta por usuário: para evitar que um único usuário preencha a fila de consultas do Looker, cada usuário tem um número máximo de consultas simultâneas permitidas e um tempo limite de fila correspondente. Por padrão, cada usuário pode executar no máximo 15 consultas simultâneas, e o tempo limite das consultas na fila devido a esse limite é de 600 segundos. Se a instância do Looker for hospedada pelo cliente, será possível alterar esses padrões configurando as opções de inicialização --per-user-query-limit e --per-user-query-timeout.

  • Limite e limite de consulta do programador: para evitar a sobrecarga do processo do programador do Looker, uma instância do Looker pode executar no máximo 10 consultas programadas simultâneas, e o tempo limite das consultas na fila do programador é de 1.200 segundos. Se a instância do Looker for hospedada pelo cliente, será possível alterar esses padrões configurando as opções de inicialização --scheduler-query-limit e --scheduler-query-timeout.

    Se a instância do Looker estiver em cluster, cada nó do cluster usará a própria fila do programador. Portanto, a adição de nós ao cluster aumenta a quantidade total permitida de consultas simultâneas simultâneas sem sobrecarregar o processo do programador do Looker.

  • Limite e limite de consulta do renderizador: para evitar a sobrecarga do processo do renderizador do Looker, uma instância do Looker pode renderizar no máximo dois downloads simultâneos de imagem, como PDF e PNG. Se a instância do Looker for hospedada pelo cliente, será possível alterar esse padrão configurando a opção de inicialização --concurrent-render-jobs.

    Se a instância do Looker estiver em cluster, cada nó do cluster usará a própria fila de renderizador. Portanto, a adição de nós ao cluster aumenta a quantidade total de jobs do renderizador simultâneos permitidos sem sobrecarregar o processo do renderizador do Looker.

  • Tempo limite do webhook: o Looker tentará enviar dados a um webhook por no máximo 30 minutos. Se o Looker não puder se comunicar com o destino do webhook em 30 minutos, a consulta vai expirar. Esse tempo limite não é configurável.

  • Tempo limite do proxy: as instâncias hospedadas pelo Looker usam um proxy que encerra qualquer consulta que esteja em execução por 60 minutos. Esse tempo limite não é configurável.

    As instâncias hospedadas pelo cliente geralmente usam proxies com um tempo limite padrão de 60 segundos. Recomendamos que esse tempo limite aumente para 60 minutos. Consulte a postagem Como executar o Looker em um servidor proxy ou balanceador de carga (em inglês) na Comunidade do Looker para mais informações.

  • Tempo limite do banco de dados: a maioria dos bancos de dados tem regras para enfileiramentos e tempos limite que são independentes das filas e dos tempos limite do Looker. Por exemplo, uma consulta pode ter saído da fila do Looker, mas ainda pode estar na fila do seu banco de dados. Verifique a documentação do seu banco de dados para mais informações sobre a personalização de tempos limite de consulta do banco de dados.