Configurações de administrador: consultas

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 anteriores às 50 mais recentes, consulte a seção Uso do Looker.

Se você tiver ativado o recurso Labs do Administrador de consultas aprimoradas, a página Consultas vai mostrar as seguintes guias:

  • Recentes: mostra consultas executadas na última hora. Nessa guia, os administradores do Looker podem cancelar a execução de consultas.
  • Concluído: exibe as 500 consultas mais recentes.

Se você não ativou o recurso de laboratórios Administrador de consultas avançadas, a página Consultas listará as últimas 50 consultas em uma única página.

Informações básicas da consulta

Coluna Definição
Hora O horário de início da consulta, mostrado 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: a consulta não foi concluída porque ocorreu um erro. Para conferir os detalhes, clique no botão "Detalhes".
  • Cancelada: a consulta foi cancelada pelo Looker ou pelo usuário.
  • Espera por PDT: a consulta precisa aguardar a criação de uma tabela derivada persistente antes de ser executada.
  • Criação de TDP: uma tabela derivada persistente está em processo de criação.
  • Na fila: a consulta está aguardando para ser executada porque já existem muitas consultas 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 essa consulta foi executada.
Usuário O usuário que executou esta consulta, se isso puder ser determinado. Algumas consultas não são executadas por um usuário específico, como quando o Looker cria uma tabela derivada persistente ou quando um usuário desconhecido acessa um Look público.
Origem A origem da consulta no Looker, como a página "Explorar" ou o SQL Runner. Se possível, um link para o Look salvo ou o ID da consulta com o nome do modelo e da Análise também será exibido. Algumas consultas não têm informações adicionais, como as que são executadas no SQL Runner. As consultas emitidas pela interface aberta do SQL têm um valor de origem de Sql_interface.
Ambiente de execução O tempo que levou para executar a consulta. Isso inclui a construção da consulta, o tempo que ela passa na fila, o trânsito de ida e volta para o banco de dados e a execução da consulta no banco de dados.

Se a consulta estiver em execução, o tempo de execução vai mostrar por quanto tempo ela está em execução. Para consultas que foram executadas anteriormente, o ambiente de execução também mostra uma estimativa de quanto tempo a consulta levará para terminar de ser executada. A estimativa tem como base a duração da última execução da consulta e dirá algo como "em torno de 2 s".
Botão "Detalhes" Consulte a subseção O botão "Detalhes" nesta página para mais detalhes.

O botão "Detalhes"

Clique no botão Detalhes à direita de qualquer consulta para exibir 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. Os Comentários do contexto não aparecerão nas informações de Detalhes da consulta. Para evitar que os comentários afetem o armazenamento em cache da consulta, o Looker adiciona os comentários de contexto aos comandos SQL de saída logo antes do SQL ser enviado ao banco de dados.
  • Uma seção de consulta da interface SQL que aparece quando uma consulta é emitida pela interface SQL aberta. Esta seção mostra a consulta SQL que foi enviada ao Looker pela ferramenta externa de BI e pode ajudar na solução de problemas e na reprodução de problemas.
  • Um link Abrir no SQL Runner, que abre a consulta no SQL Runner.

A seção Informações inclui:

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 na tabela de informações básicas da consulta.
Mensagem Se a consulta tiver um PDT, o comentário de geração de PDT vai aparecer nesse campo. Se a consulta não tiver uma PDT, o campo não será exibido.
Conexão A conexão do Looker em que essa consulta foi executada.
Usuário O usuário que executou esta consulta, se isso puder ser determinado. Algumas consultas não são executadas por um usuário específico, como quando o Looker cria uma tabela derivada persistente ou quando um usuário desconhecido acessa um Look público.
Origem A origem da consulta no Looker, como a página Explorar ou o SQL Runner. Se possível, outras informações vão aparecer, como um link para o Look salvo, o ID da consulta, o nome do modelo, o nome da Análise ou os campos selecionados.
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 que levou para executar a consulta.

Eliminação de consultas

Quando você fecha a guia do navegador em que uma consulta está em execução, o Looker interrompe a consulta automaticamente. Os administradores do Looker também podem interromper a execução de uma consulta na página Consultas. Os usuários com a permissão see_queries podem acessar 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 mostrará um botão Parar à direita dela. Clique em Parar para interromper a consulta.

Para que o Looker elimine consultas, o dialeto do banco de dados precisa ser compatível com a eliminação de consultas. A lista a seguir mostra quais dialetos oferecem suporte ao encerramento de consultas na versão mais recente do Looker:

Dialeto Compatível?
Avalanche Actian
Sim
Amazon Athena
Sim
MySQL do Amazon Aurora
Sim
Amazon Redshift
Sim
Apache Druid
Não
Apache Druid 0.13 ou mais recente
Não
Apache Druid 0.18 ou mais recente
Não
Apache Hive 2.3 ou superior
Sim
Apache Hive 3.1.2 ou mais recente
Sim
Apache Spark 3 ou mais recente
Sim
ClickHouse
Sim
Cloudera Impala 3.1 ou superior
Sim
Cloudera Impala 3.1+ com driver nativo
Sim
Cloudera Impala com driver nativo
Sim
DataVirtuality
Sim
Databricks
Sim
Denodo 7
Sim
Denodo 8
Sim
Dremio
Sim
Dremio 11 ou mais recente
Sim
Exasol
Sim
Bola de fogo
Sim
SQL legado do Google BigQuery
Sim
SQL padrão do Google BigQuery
Sim
PostgreSQL do Google Cloud
Sim
Google Cloud SQL
Sim
Google Spanner (em inglês)
Sim
Greenplum
Sim
HyperSQL
Não
IBM Netezza
Sim
MariaDB
Sim
Microsoft Azure PostgreSQL
Sim
Banco de dados SQL do Microsoft Azure
Sim
Microsoft Azure Synapse Analytics
Sim
Microsoft SQL Server 2008 ou superior
Sim
Microsoft SQL Server 2012 ou posterior
Sim
Microsoft SQL Server 2016
Sim
Microsoft SQL Server 2017 ou mais recente
Sim
MongoBI
Sim
MySQL
Sim
MySQL 8.0.12 ou mais recente
Sim
Oracle
Sim
Oracle ADWC
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à 9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA 2+
Sim
SingleStore
Sim
SingleStore 7 ou superior
Sim
Snowflake
Sim
Teradata
Sim
Trino
Sim
Vetor
Sim
Vertica
Sim

Tempo limite e enfileiramento de consultas

O Looker encerra consultas que estão na fila há muito tempo. Essa operação é chamada de tempo limite. Vários limites de tempo podem ser aplicados à consulta:

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

  • Limite e tempo 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 da fila correspondente. Por padrão, cada usuário pode executar no máximo 15 consultas simultâneas, e o tempo limite é de 600 segundos para consultas enfileiradas devido a esse limite. Essas configurações são válidas para os usuários que fazem login no Looker usando o processo normal de autenticação e para aqueles que fazem login com credenciais de usuário da API. Se a instância do Looker for hospedada pelo cliente, você poderá mudar esses padrões configurando as opções de inicialização --per-user-query-limit e --per-user-query-timeout.

  • Limite e tempo limite da 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 estiver hospedada pelo cliente, mude esses padrões configurando as opções de inicialização --scheduler-query-limit e --scheduler-query-timeout.

  • Limite e tempo limite da 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 imagens, como formatos PDF e PNG. Se a instância do Looker for hospedada pelo cliente, mude esse padrão configurando a opção de inicialização --concurrent-render-jobs.

  • Tempo limite do webhook: o Looker tenta enviar dados para 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 cliente geralmente usam proxies com um tempo limite padrão de 60 segundos. Recomendamos que esse tempo limite seja aumentado para 60 minutos. Consulte a postagem da Comunidade do Looker Como executar o Looker atrás de um servidor proxy ou balanceador de carga para mais informações.

    • Tempo limite do banco de dados: a maioria dos bancos de dados tem regras de enfileiramento 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 ser colocada na fila no banco de dados. Consulte a documentação do seu banco de dados para mais informações sobre como personalizar os tempos limite de consulta do banco de dados.