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, consulte a seção Uso do Looker.
Informações básicas de consulta
| Coluna | Definição |
|---|---|
| Tempo | O horário de início da consulta, mostrado no 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 "Explorar" ou o SQL Runner. Se possível, um link para o Look salvo ou o ID da consulta junto com o nome do modelo e da Análise também será exibido. Algumas consultas não terão informações adicionais, como as executadas no SQL Runner. |
| Ambiente de execução | O tempo que levou para executar a consulta. Isso inclui a construção da consulta, o tempo que ela passou na fila, o trânsito de/para o banco de dados e a execução do banco de dados da consulta.Se a consulta estiver em execução no momento, o ambiente 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 mostrará uma estimativa de quanto tempo a consulta levará para ser concluída. A estimativa é baseada na duração da última execução da consulta e informa algo como "de aproximadamente 2s". |
| Botão "Detalhes" | Consulte a subseção O botão de detalhes nesta página para mais detalhes. |
O botão "Detalhes"
Para acessar mais informações sobre a consulta, clique no botão Detalhes à direita. O pop-up Detalhes da consulta inclui o seguinte:
- Uma seção Info 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 aparecem nas informações de Query Details. 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 antes do SQL ser enviado ao banco de dados.
- Um link Abrir no SQL Runner que abre a consulta no SQL Runner.
A seção Info 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. |
| Mensagem | Se a consulta contiver uma TDP, o comentário de geração de TDP aparecerá neste campo. Se a consulta não contiver uma TDP, 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 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 Explorar ou o SQL Runner. 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 do Explore, campos selecionados e assim por diante. |
| Horário de início | O horário de início da consulta, mostrado 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 a consulta levou para ser executada. |
Encerramento de consultas
O Looker vai interromper automaticamente uma consulta que ainda está em execução quando você fechar a guia do navegador em que ela está sendo 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 acessar a página Consultas, mas apenas os administradores do Looker podem interromper uma consulta em execução. Qualquer consulta em execução mostra um botão Parar à direita da consulta. Clique em Parar para interromper a consulta.
Para que o Looker elimine consultas, o dialeto do seu banco de dados precisa ser compatível com o encerramento da consulta. A lista a seguir mostra quais dialetos são compatíveis com o encerramento de consultas na versão mais recente do Looker:
| Dialeto | Compatível? |
|---|---|
| Avalanche | Sim |
| Amazon Athena | Sim |
| MySQL do Amazon Aurora | Sim |
| Amazon Redshift | Sim |
| Apache Druid | No |
| Apache Druid 0.13 ou superior | No |
| Apache Druid 0.18 ou superior | No |
| Apache Hive 2.3 ou superior | Sim |
| Apache Hive 3.1.2 ou superior | Sim |
| Apache Spark 3 ou mais recente | Sim |
| ClickHouse | Sim |
| Cloudera Impala 3.1 ou mais recente | 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 |
| Fio de fogo | Sim |
| SQL legado do Google BigQuery | Sim |
| SQL padrão do Google BigQuery | Sim |
| PostgreSQL no Google Cloud | Sim |
| Google Cloud SQL | Sim |
| Google Spanner | Sim |
| Verde ameixa | Sim |
| HyperSQL | No |
| IBM Netezza | Sim |
| MariaDB | Sim |
| PostgreSQL do Microsoft Azure | Sim |
| Banco de dados SQL do Microsoft Azure | Sim |
| Análise do Microsoft Azure Synapse | Sim |
| Microsoft SQL Server 2008 ou mais recente | Sim |
| Microsoft SQL Server 2012 ou mais recente | Sim |
| Microsoft SQL Server 2016 | Sim |
| Microsoft SQL Server 2017 ou mais recente | Sim |
| MongoBI | Sim |
| MySQL | Sim |
| MySQL 8.0.12 ou superior | Sim |
| Oracle | Sim |
| ADWC do Oracle | Sim |
| PostgreSQL 9.5 ou mais recente | Sim |
| PostgreSQL anterior à versão 9.5 | Sim |
| PrestoDB | Sim |
| PrestoSQL | Sim |
| SAP HANA 2 ou posterior | Sim |
| SingleStore | Sim |
| SingleStore 7 ou mais recente | Sim |
| Snowflake | Sim |
| Teradata | Sim |
| Trino | Sim |
| Vetor | Sim |
| Vertica | Sim |
Tempos limite de consultas e enfileiramento
O Looker encerra as consultas que estão esperando na fila por muito tempo. Essa operação é chamada de tempo limite. Vários tempos limite podem ser aplicados à sua consulta:
Tempo limite do pool de conexão: 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 aquelas que permanecem na fila por muito tempo. Por padrão, são permitidas no máximo 75 consultas simultâneas por conexão. Consultas adicionais além do limite de conexão serão expiradas após 0 segundo. Para alterar esses padrões, defina as configurações de máximo de conexões e tempo limite do pool de conexão na página Configurações de conexões da conexão.
Tempo 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 para consultas na fila devido a esse limite é de 600 segundos. Essas configurações são válidas para os usuários que fazem login no Looker com o processo de autenticação normal e para aqueles que usam credenciais de usuário da API. Se a instância do Looker for hospedada pelo cliente, será possível mudar os padrões configurando as opções de inicialização
--per-user-query-limite--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 para consultas na fila do programador é de 1.200 segundos. Se a instância do Looker for hospedada pelo cliente, será possível mudar os padrões configurando as opções de inicialização
--scheduler-query-limite--scheduler-query-timeout.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 no máximo dois downloads simultâneos baseados em imagem, como os formatos PDF e PNG. Se a instância do Looker for hospedada pelo cliente, é possível alterar esse padrão configurando a opção de inicialização
--concurrent-render-jobs.
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. Confira mais informações na postagem Como executar o Looker em um servidor proxy ou balanceador de carga na Comunidade do Looker.
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 estar na fila do banco de dados. Verifique a documentação do seu banco de dados para mais informações sobre como personalizar tempos limite de consulta do banco de dados.