A página Consultas na seção Banco de dados do menu Admin lista informações sobre as últimas 50 consultas que o Looker enviou ao seu banco de dados. Para informações sobre consultas mais antigas, consulte a seção Uso do Looker.
Informações básicas da consulta
| Coluna | Definição |
|---|---|
| Hora | A hora de início da consulta, mostrada no seu fuso horário do aplicativo. |
| Status | O status da consulta, que pode incluir:
|
| Conexão | A conexão do Looker em que essa consulta foi executada. |
| Usuário | O usuário que executou essa 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 "Analisar" ou o SQL Runner. Se possível, um link para o Look salvo ou o ID da consulta, juntamente com o nome do modelo e da análise, também é mostrado. Algumas consultas não têm informações adicionais, como as executadas no SQL Runner. As consultas emitidas pela interface SQL aberta têm um valor de origem de Sql_interface. |
| Ambiente de execução | O tempo necessário para executar a consulta. Isso inclui a construção da consulta, qualquer 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 ambiente de execução vai mostrar há quanto tempo ela está em execução. Para consultas executadas anteriormente, o ambiente de execução também vai mostrar uma estimativa de quanto tempo a consulta vai levar para terminar a execução. A estimativa é baseada na duração da última execução da consulta e vai dizer algo como "de cerca de 2 segundos". |
| Botão "Detalhes" | Consulte a subseção "Botão Detalhes" nesta página para mais detalhes. |
O botão "Detalhes"
Ao clicar no botão Detalhes à direita de qualquer consulta, mais informações sobre ela serão exibidas. 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 vão aparecer 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 Consulta da interface SQL que aparece quando uma consulta é emitida pela interface SQL aberta. Essa 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 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 na tabela de informações básicas da consulta. |
| Mensagem | Se a consulta contiver uma PDT, o comentário de geração da PDT vai aparecer nesse campo. Se a consulta não contiver 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 essa 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 Analisar ou o SQL Runner. Se possível, informações adicionais serão mostradas, 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 | A hora de início da consulta, mostrada no seu fuso horário do aplicativo. |
| Horário de término | A hora de término da consulta, mostrada no seu fuso horário do aplicativo. |
| Ambiente de execução | O tempo necessário para executar a consulta. |
Interrupção de consultas
Para dialetos que oferecem suporte à interrupção de consultas, o Looker pode interromper a execução de consultas das seguintes maneiras:
- Automaticamente: o Looker interrompe automaticamente uma consulta se o usuário fechar a guia do navegador em que a consulta está em execução.
- Individualmente: os administradores do Looker podem interromper uma consulta em execução na página Administrador Consultas clicando no botão Interromper dessa consulta. Os usuários com a
see_queriespermissão podem acessar a página Consultas, mas apenas os administradores do Looker podem interromper uma consulta em execução. - Em massa: os administradores do Looker podem interromper várias consultas em execução simultaneamente em toda a instância ou para uma conexão de banco de dados específica usando o recurso de limpeza de consultas de emergência na página Consultas.
Interromper consultas em massa
Se a instância do Looker ficar instável ou degradada devido ao acúmulo de consultas (por exemplo, consultas suspensas estão esgotando os slots de consulta disponíveis ou a página Consultas fica lenta ou não responde), os administradores do Looker podem interromper a execução de consultas em massa sem reiniciar a instância.
Para interromper consultas em massa, siga estas etapas:
- No Looker, acesse a página Consultas no menu Admin.
Na barra de endereço do navegador, anexe
?cleanup=trueao final do URL e pressione Enter. Exemplo:https://INSTANCE_NAME.cloud.looker.com/admin/queries?cleanup=trueA seção Limpeza de consultas de emergência aparece acima da tabela de consultas.
Realize uma das seguintes ações:
- Interromper todas as consultas em execução na instância: clique em Interromper todas as consultas em execução.
- Interromper todas as consultas em execução para uma conexão específica: selecione uma conexão de banco de dados na lista suspensa Conexão e clique em Interromper consultas na conexão.
Na caixa de diálogo de confirmação, confirme que você quer encerrar as consultas em execução.
Se uma conexão de banco de dados instável ou que não responde causar um acúmulo repetido de consultas, os administradores também poderão desativar temporariamente a conexão usando a opção Desativar conexão na página Configurações de conexões.
Dialetos compatíveis com a interrupção de consultas
Para que o Looker interrompa consultas, seja automaticamente ao fechar a guia do navegador, individualmente na página Consultas ou em massa usando a limpeza de consultas de emergência, o dialeto do banco de dados precisa oferecer suporte à interrupção de consultas. A tabela a seguir mostra quais dialetos oferecem suporte à interrupção de consultas na versão mais recente do Looker:
| Dialeto | Compatível? |
|---|---|
| Actian Avalanche | |
| Amazon Athena | |
| Amazon Aurora MySQL | |
| Amazon Redshift | |
| Amazon Redshift 2.1+ | |
| Amazon Redshift Serverless 2.1+ | |
| Apache Druid | |
| Apache Druid 0.13.x - 0.17.x | |
| Apache Druid 0.18+ | |
| Apache Hive 2.3+ | |
| Apache Hive 3.1.2+ | |
| Apache Spark 3+ | |
| ClickHouse | |
| Cloudera Impala 3.1+ | |
| Cloudera Impala 3.1+ with Native Driver | |
| Cloudera Impala with Native Driver | |
| DataVirtuality | |
| Databricks | |
| Denodo 7 | |
| Denodo 8 & 9 | |
| Dremio | |
| Dremio 11+ | |
| Exasol | |
| Google BigQuery Legacy SQL | |
| Google BigQuery Standard SQL | |
| Google Cloud AlloyDB for PostgreSQL | |
| Google Cloud PostgreSQL | |
| Google Cloud SQL | |
| Google Spanner | |
| Greenplum | |
| HyperSQL | |
| IBM Netezza | |
| MariaDB | |
| Microsoft Azure PostgreSQL | |
| Microsoft Azure SQL Database | |
| Microsoft Azure Synapse Analytics | |
| Microsoft SQL Server 2008+ | |
| Microsoft SQL Server 2012+ | |
| Microsoft SQL Server 2016 | |
| Microsoft SQL Server 2017+ | |
| MongoBI | |
| MongoSQL | |
| MySQL | |
| MySQL 8.0.12+ | |
| Oracle | |
| Oracle ADWC | |
| PostgreSQL 9.5+ | |
| PostgreSQL pre-9.5 | |
| PrestoDB | |
| PrestoSQL | |
| SAP HANA | |
| SAP HANA 2+ | |
| SingleStore | |
| SingleStore 7+ | |
| Snowflake | |
| Teradata | |
| Trino | |
| Vector | |
| Vertica |
Tempos 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 tempos limite podem ser aplicados à 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 máximas por conexão. As consultas adicionais além do limite de conexão vão expirar após 0 segundos. Para mudar esses padrões, configure as conexões máximas, o número máximo de consultas simultâneas para essa conexão e as configurações de 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 de fila correspondente para consultas enfileiradas devido ao limite de consultas simultâneas. O limite por usuário se aplica a usuários que fazem login no Looker usando o processo de autenticação normal e a usuários que fazem login usando credenciais de usuário da API. Há duas maneiras de definir o número máximo de consultas simultâneas por usuário para conexões na instância do Looker:
- A opção de inicialização
per-user-query-limit. Essa é uma configuração de toda a instância que define o padrão para conexões na instância. A opção de inicializaçãoper-user-query-limitlimita o número de consultas simultâneas por usuário, por conexão e por nó na instância do Looker. O máximo padrão de 15 consultas simultâneas por usuário se aplica a cada conexão válida e, se a instância do Looker estiver em cluster, a cada nó do cluster. Por padrão, cada usuário pode executar um máximo de 15 consultas simultâneas por conexão, por nó, com um tempo limite de 600 segundos. Por exemplo, se você tiver um cluster de 5 nós com umper-user-query-limitde 15, cada nó vai permitir 15 consultas simultâneas por usuário para essa conexão, totalizando 75 consultas em todos os nós (15 * 5 = 75).
É possível mudar o limite de consultas por usuário para uma conexão usando a configuração Número máximo de consultas simultâneas por usuário para esta conexão na página Configurações de conexão da conexão. Se a instância do Looker for hospedada pelo cliente, você poderá mudar o número máximo padrão de consultas simultâneas por usuário configurando a opção de inicialização
--per-user-query-limite configurar o tempo limite da fila usando a opção de inicialização--per-user-query-timeout.- A opção Número máximo de consultas simultâneas por usuário para esta conexão nas Configurações de conexões de uma conexão. A configuração Número máximo de consultas simultâneas por usuário para esta conexão tem um padrão de 25 e é por usuário e por conexão, mas não por nó. Por exemplo, se você tiver um cluster de 5 nós e definir esse valor como 15, cada nó vai permitir 3 consultas simultâneas por usuário para essa conexão (15 / 5 = 3), totalizando 15 consultas em todos os nós. Para uma conexão, se um valor for fornecido para a configuração Número máximo de consultas simultâneas por usuário para esta conexão, o valor Número máximo de consultas simultâneas por usuário para esta conexão vai substituir a opção de inicialização
per-user-query-limitpara a conexão.
- A opção de inicialização
Limite e tempo limite de consulta do programador: para evitar a sobrecarga do processo do programador do Looker, uma instância do Looker pode executar um máximo de 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
--scheduler-query-limite--scheduler-query-timeoutopções de inicialização.Limite e tempo limite de consulta do renderizador: para evitar a sobrecarga do processo do renderizador do Looker, uma instância do Looker pode renderizar um máximo de 2 downloads simultâneos baseados em imagens, como formatos PDF e PNG. Se a instância do Looker for hospedada pelo cliente, você poderá mudar esse padrão configurando a
--concurrent-render-jobsopção de inicialização.
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 por trá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 enfileiramento 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 enfileirada no banco de dados. Consulte a documentação do banco de dados para mais informações sobre como personalizar os tempos limite de consulta do banco de dados.