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 enviadas pelo Looker ao seu banco de dados. Para informações sobre consultas mais antigas que as 50 mais recentes, consulte a seção Uso do Looker.

Se você ativou o recurso do programa Labs Administrador de consultas avançadas, a página Consultas vai mostrar as seguintes guias:

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

Se você não ativou o recurso do Labs Administrador de consultas avançado, a página Consultas lista 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, 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: a consulta não foi concluída porque ocorreu um erro. Clique no botão "Detalhes" para saber mais.
  • Cancelada: a consulta foi cancelada pelo Looker ou pelo usuário.
  • Aguardando PDT: a consulta precisa esperar que uma tabela derivada permanente seja criada antes de ser executada.
  • Criando PDT: uma tabela derivada persistente está sendo criada.
  • Em fila: a consulta está aguardando execução porque muitas consultas já estão em andamento. Elas podem ser limitadas pelo Looker na sua configuração de conexão ou no banco de dados.
  • Em execução: a consulta está sendo executada.
  • 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 permanente ou quando um usuário desconhecido acessa um Look público.
Origem A origem da consulta no Looker, como a página "Analisar" ou o SQL Runner. Se possível, um link para o Look salvo ou o ID da consulta, além do nome do modelo e da Análise, também será exibido. Algumas consultas não têm informações adicionais, como as executadas no SQL Runner. As consultas emitidas na interface do SQL aberto têm um valor de Origem de Sql_interface.
Ambiente de execução O tempo gasto para executar a consulta. Isso inclui a construção da consulta, o tempo gasto na fila, o trânsito de e 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 há quanto tempo ela está sendo executada. Para consultas executadas anteriormente, o tempo de execução também mostra uma estimativa de quanto tempo a consulta vai levar para terminar. A estimativa se baseia na duração da última execução da consulta e informa algo como "de cerca de 2 segundos".
Botão "Detalhes" Consulte a subseção O botão "Detalhes" nesta página para mais detalhes.

Botão "Detalhes"

Clique no botão Detalhes à direita de qualquer consulta para ver mais informações sobre ela. O menu 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 executado no banco de dados. Os comentários de contexto não aparecem nas informações de Detalhes da consulta. Para evitar que os comentários afetem o armazenamento em cache de consultas, o Looker adiciona os comentários de contexto aos comandos SQL enviados logo antes de o SQL ser enviado ao banco de dados.
  • Uma seção Consulta da interface SQL que aparece quando uma consulta é emitida pela Abrir interface SQL. Esta seção mostra a consulta SQL enviada ao Looker pela ferramenta de BI externa 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 o seguinte:

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 uma 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 vai aparecer.
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 permanente ou quando um usuário desconhecido acessa um Look público.
Origem A origem da consulta no Looker, como a página Analisar ou o Executor de SQL. Se possível, outras informações são exibidas, 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.

Interrupção de consultas

Quando você fecha a guia do navegador em que uma consulta está sendo executada, o Looker a interrompe automaticamente. 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 acessar a página Consultas, mas somente os administradores do Looker podem interromper uma consulta em execução. Qualquer consulta ainda em execução mostra um botão Parar à direita. Clique em Parar para interromper a consulta.

Para que o Looker encerre consultas, seu dialeto de banco de dados precisa oferecer suporte a essa ação. A lista a seguir mostra quais dialetos oferecem suporte à interrupção de consultas na versão mais recente do Looker:

Dialeto Compatível?
Actian Avalanche
Sim
Amazon Athena
Sim
Amazon Aurora MySQL
Sim
Amazon Redshift
Sim
Amazon Redshift 2.1+
Sim
Amazon Redshift Serverless 2.1+
Sim
Apache Druid
Não
Apache Druid 0.13+
Não
Apache Druid 0.18+
Não
Apache Hive 2.3+
Sim
Apache Hive 3.1.2+
Sim
Apache Spark 3+
Sim
ClickHouse
Sim
Cloudera Impala 3.1+
Sim
Cloudera Impala 3.1+ with Native Driver
Sim
Cloudera Impala with Native Driver
Sim
DataVirtuality
Sim
Databricks
Sim
Denodo 7
Sim
Denodo 8 & 9
Sim
Dremio
Sim
Dremio 11+
Sim
Exasol
Sim
Firebolt
Sim
Google BigQuery Legacy SQL
Sim
Google BigQuery Standard SQL
Sim
Google Cloud PostgreSQL
Sim
Google Cloud SQL
Sim
Google Spanner
Sim
Greenplum
Sim
HyperSQL
Não
IBM Netezza
Sim
MariaDB
Sim
Microsoft Azure PostgreSQL
Sim
Microsoft Azure SQL Database
Sim
Microsoft Azure Synapse Analytics
Sim
Microsoft SQL Server 2008+
Sim
Microsoft SQL Server 2012+
Sim
Microsoft SQL Server 2016
Sim
Microsoft SQL Server 2017+
Sim
MongoBI
Sim
MySQL
Sim
MySQL 8.0.12+
Sim
Oracle
Sim
Oracle ADWC
Sim
PostgreSQL 9.5+
Sim
PostgreSQL pre-9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA
Sim
SAP HANA 2+
Sim
SingleStore
Sim
SingleStore 7+
Sim
Snowflake
Sim
Teradata
Sim
Trino
Sim
Vector
Sim
Vertica
Sim

Tempos limite de consulta e enfileiramento

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

  • Tempo limite do pool de conexões e número máximo de consultas simultâneas: para evitar a sobrecarga do banco de dados com consultas simultâneas, o Looker mantém o excesso de consultas simultâneas na fila de consultas do Looker e encerra as consultas que permanecem na fila por muito tempo. Por padrão, são permitidas 75 consultas simultâneas por conexão. Outras consultas além do limite de conexão vão expirar após 0 segundos. Para mudar esses padrões, configure as opções Máximo de conexões, Número máximo de consultas simultâneas para esta conexão e Tempo limite do pool de conexões na página Configurações de conexão 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 de 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 se aplicam a usuários que fazem login no Looker usando o processo de autenticação regular e a usuários que fazem login usando credenciais de usuário da API. Para mudar esses padrões, configure as opções Número máximo de consultas simultâneas por usuário para esta conexão na página Configurações de conexão de uma conexão. 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 de consultas 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 para consultas na fila do programador é de 1.200 segundos. Se a instância do Looker for hospedada pelo cliente, você poderá mudar esses padrões configurando as opções de inicialização --scheduler-query-limit e --scheduler-query-timeout.

  • Limite e tempo limite de consulta do renderizador: para evitar a sobrecarga do processo de renderização do Looker, uma instância do Looker pode renderizar no máximo dois downloads simultâneos baseados em 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 vai tentar entregar dados a um webhook por no máximo 30 minutos. Se o Looker não conseguir se comunicar com o destino do webhook em 30 minutos, a consulta vai atingir o tempo limite. 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 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 para filas e tempos limite que são independentes das filas e 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. Consulte a documentação do seu banco de dados para mais informações sobre como personalizar os tempos limite de consultas.