Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A página Consultas na secção Base de dados do menu Administração apresenta informações sobre as últimas 50 consultas que o Looker enviou para a sua base de dados. Para ver informações sobre consultas com mais de 50 consultas, consulte a secção Utilização do Looker.
Recente: apresenta consultas que foram executadas na última hora. Neste separador, os administradores do Looker podem cancelar consultas em execução.
Concluído: apresenta as 500 consultas mais recentes.
Se não tiver ativado a funcionalidade do Labs Administrador de consultas melhorado, a página Consultas apresenta as últimas 50 consultas numa única página.
Em fila: a consulta está a aguardar execução porque já existem demasiadas consultas em curso (as consultas podem ser limitadas pelo Looker na sua configuração de ligação ou na sua base de dados).
Em execução: a consulta está em processo de execução.
Desconhecido: o Looker não conseguiu determinar o que aconteceu com esta consulta.
Connection
A associação do Looker na qual esta consulta foi executada.
Utilizador
O utilizador que executou esta consulta, se for possível determinar. Algumas consultas não são executadas por um utilizador específico, como quando o Looker cria uma tabela derivada persistente ou quando um utilizador desconhecido acede a um Look público.
Origem
A origem da consulta no Looker, como a página Explorar ou a execução de SQL. Se possível, também é apresentado um link para a análise detalhada guardada ou o ID da consulta, juntamente com o nome do modelo e da exploração. Algumas consultas não têm informações adicionais, como as que são executadas no SQL Runner. As consultas emitidas a partir da interface SQL aberta têm um valor de origem de Sql_interface.
Tempo de execução
O tempo que demorou a executar a consulta. Isto inclui a criação da consulta, o tempo que a consulta passou na fila, o trânsito de e para a base de dados e a execução da consulta na base de dados.Se a consulta estiver em execução, o tempo de execução mostra há quanto tempo está a ser executada. Para consultas executadas anteriormente, o tempo de execução também mostra uma estimativa do tempo que a consulta vai demorar a terminar a execução. A estimativa baseia-se na duração da última execução da consulta e indica algo como "de cerca de 2 s".
Botão Detalhes
Consulte a subsecção O botão Detalhes nesta página para ver detalhes adicionais.
O botão Detalhes
Se clicar no botão Detalhes à direita de qualquer consulta, são apresentadas informações adicionais sobre essa consulta. O menu Detalhes da consulta inclui o seguinte:
Uma secção Informações que inclui detalhes sobre a consulta (consulte a tabela seguinte).
Uma secção SQL que mostra o SQL não processado que foi executado na base de dados. Os comentários de contexto não aparecem nas informações de detalhes da consulta. Para impedir que os comentários afetem o armazenamento em cache de consultas, o Looker adiciona os comentários de contexto aos comandos SQL de saída imediatamente antes de o SQL ser enviado para a base de dados.
Uma secção Consulta da interface SQL que aparece quando uma consulta foi emitida através da interface SQL aberta. Esta secção apresenta a consulta SQL que foi enviada para o Looker a partir da ferramenta de BI externa e pode ajudar na resolução de problemas e na reprodução de problemas.
Um link Abrir em execução de SQL que abre a consulta na execução de SQL.
A secção Informações inclui as seguintes informações:
Se a consulta contiver um PDT, o comentário de geração de PDT aparece neste campo. Se a consulta não contiver um PDT, o campo não é apresentado.
Connection
A associação do Looker na qual esta consulta foi executada.
Utilizador
O utilizador que executou esta consulta, se for possível determinar. Algumas consultas não são executadas por um utilizador específico, como quando o Looker cria uma tabela derivada persistente ou quando um utilizador desconhecido acede a um Look público.
Origem
A origem da consulta no Looker, como a página Explorar ou o SQL Runner. Se possível, são apresentadas informações adicionais, como um link para a análise detalhada guardada, o ID da consulta, o nome do modelo, o nome do Explorar ou os campos que foram selecionados.
Quando fecha o separador do navegador no qual uma consulta está a ser executada, o Looker para automaticamente a consulta. Os administradores do Looker também podem parar uma consulta em execução na página Consultas. (Os utilizadores com a autorização see_queries podem ver a página Consultas, mas apenas os administradores do Looker podem parar 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 parar a consulta.
Para que o Looker termine consultas, o dialeto da base de dados tem de suportar a terminação de consultas. A lista seguinte mostra os dialetos que suportam a anulaçã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 consultas e colocação em fila
O Looker termina as consultas que estão na fila há demasiado tempo. Esta operação é denominada tempo limite. Podem aplicar-se vários limites de tempo à sua consulta:
Limite de tempo da reserva de ligações e consultas simultâneas máximas: para evitar a sobrecarga da sua base de dados com consultas simultâneas, o Looker retém o excesso de consultas simultâneas na fila de consultas do Looker e termina as consultas que permanecem na fila durante demasiado tempo. Por predefinição, são permitidas 75 consultas simultâneas máximas por ligação. As consultas adicionais que excedam o limite de ligações vão expirar após 0 segundos. Para alterar estas predefinições, configure as definições Máximo de ligações, Máximo de consultas simultâneas para esta ligação e Limite de tempo do conjunto de ligações na página Definições de ligações de uma ligação.
Limite de consultas e tempo limite por utilizador: para impedir que um único utilizador preencha a fila de consultas do Looker, cada utilizador tem um número máximo de consultas simultâneas permitidas e um tempo limite da fila correspondente. Por predefinição, cada utilizador pode executar um máximo de 15 consultas simultâneas, e o tempo limite é de 600 segundos para consultas que são colocadas em fila devido a este limite. Estas definições aplicam-se aos utilizadores que iniciam sessão no Looker através do processo de autenticação normal e aos utilizadores que iniciam sessão através das credenciais de utilizador da API. Para alterar estas predefinições, configure as definições de Consultas simultâneas máximas por utilizador para esta associação na página Definições de associações de uma associação. Se a sua instância do Looker for alojada pelo cliente, pode alterar estas predefinições configurando as opções de arranque--per-user-query-limit e --per-user-query-timeout.
Limite de consultas do agendador e limite de tempo: para evitar a sobrecarga do processo do agendador do Looker, uma instância do Looker pode executar um máximo de 10 consultas agendadas em simultâneo, e o limite de tempo para consultas na fila do agendador é de 1200 segundos. Se a sua instância do Looker for alojada pelo cliente, pode alterar estas predefinições configurando as opções de arranque--scheduler-query-limit e --scheduler-query-timeout.
Limite de consultas e tempo limite do renderizador: para evitar a sobrecarga do processo do renderizador do Looker, uma instância do Looker pode renderizar um máximo de 2 transferências baseadas em imagens em simultâneo, como formatos PDF e PNG. Se a sua instância do Looker for alojada pelo cliente, pode alterar esta predefinição configurando a --concurrent-render-jobsopção de arranque.
Limite de tempo do webhook: o Looker tenta o envio de dados para um webhook durante um máximo de 30 minutos. Se o Looker não conseguir comunicar com o destino do webhook em 30 minutos, a consulta vai expirar. Este limite de tempo não é configurável.
Limite de tempo do proxy: as instâncias alojadas pelo cliente usam frequentemente proxies com um limite de tempo predefinido de 60 segundos. Recomendamos que este limite de tempo seja aumentado para 60 minutos. Consulte a publicação da comunidade do Looker Executar o Looker atrás de um servidor proxy ou um equilibrador de carga para mais informações.
Limite de tempo da base de dados: a maioria das bases de dados tem regras para filas e limites de tempo que são independentes das filas e dos limites de tempo do Looker. Por exemplo, uma consulta pode ter saído da fila do Looker, mas ainda pode estar na fila da sua base de dados. Consulte a documentação da sua base de dados para obter mais informações sobre a personalização dos limites de tempo das consultas da base de dados.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-20 UTC."],[],[],null,["# Admin settings - Queries\n\n| **Note:** Looker admins can enable the [**Enhanced Query Admin**](/looker/docs/admin-panel-general-labs#enhanced_query_admin) experimental Labs feature to enhance the **Queries** page. The Labs feature improves performance on the **Queries** page, and it lists 500 paginated queries, rather than 50.\n\nThe **Queries** page in the **Database** section of the **Admin** menu lists information about the last 50 queries that Looker submitted to your database. For information about queries that are older than the most recent 50 queries, see the [**Usage**](/looker/docs/admin-panel-server-usage) section of Looker.\n| **Note:** If you have a permission that provides access to only select pages in the Admin panel, such as [`manage_schedules`](/looker/docs/admin-panel-users-roles#manage_schedules), [`manage_themes`](/looker/docs/admin-panel-users-roles#manage_themes), or [`see_admin`](/looker/docs/admin-panel-users-roles#see_admin), but you don't have the [Admin role](/looker/docs/admin-panel-users-roles#default_roles), the page or pages that are described here may not be visible to you in the Admin panel.\n\nIf you have enabled the [Enhanced Query Admin](/looker/docs/admin-panel-general-labs#enhanced_query_admin) Labs feature, the **Queries** page displays the following tabs:\n\n- **Recent**: Displays queries that were run in the last hour. From this tab, Looker admins can cancel running queries.\n- **Complete**: Displays the most recent 500 queries.\n\nIf you haven't enabled the **Enhanced Query Admin** Labs feature, the **Queries** page lists the last 50 queries on a single page.\n\nBasic query information\n-----------------------\n\nThe Details button\n------------------\n\nClicking the **Details** button to the right of any query will bring up additional information about that query. The **Query Details** menu includes the following:\n\n- An **Info** section that includes details about the query (see the following table).\n- A **SQL** section that shows the raw SQL that was executed against the database. [**Context Comments**](/looker/docs/admin-panel-server-usage#sql_comments) will not appear in the **Query Details** information. To prevent comments from affecting query caching, Looker adds the context comments to outgoing SQL commands right before the SQL is sent to the database.\n- A **SQL Interface query** section that appears when a query has been issued through the [Open SQL Interface](/looker/docs/sql-interface#identifying-sql-interface-queries-in-the-looker-ui). This section displays the SQL query that was sent to Looker from the external BI tool and can aid in troubleshooting and reproducing issues.\n- An **Open in SQL Runner** link that will open the query in [SQL Runner](/looker/docs/sql-runner-basics).\n\nThe **Info** section includes the following information:\n\nQuery killing\n-------------\n\nWhen you close the browser tab in which a query is running, Looker will automatically stop the query. Looker admins can also stop a running query from the **Queries** page. (Users with the [`see_queries` permission](/looker/docs/admin-panel-users-roles#see_queries) can view the **Queries** page, but only Looker admins can stop a running query.) Any query that is still running shows a **Stop** button to the right of the query. Click **Stop** to stop the query.\n\nFor Looker to kill queries, your database dialect must support query killing. The following list shows which dialects support query killing in the latest release of Looker:\n\nQuery timeouts and queueing\n---------------------------\n\nLooker kills queries that have been waiting in queue for too long. This operation is called a *timeout*. Several timeouts may apply to your query:\n\n- **Connection pool timeout and maximum concurrent queries** : To prevent overloading of your database with concurrent queries, Looker holds excess concurrent queries in the Looker query queue, and will kill queries that remain in queue for too long. By default, 75 maximum concurrent queries are allowed per connection. Additional queries beyond the connection limit will be timed out after 0 seconds. To change these defaults, configure the [Max connections](/looker/docs/connecting-to-your-db#max_connections), [**Max concurrent queries for this connection**](/looker/docs/connecting-to-your-db#max-queries), and [**Connection pool timeout**](/looker/docs/connecting-to-your-db#connection_pool_timeout) settings on a connection's [**Connections Settings**](/looker/docs/connecting-to-your-db) page.\n\n- **Per-user query limit and timeout** : To prevent any single user from filling up the Looker query queue, each user has a maximum number of allowed concurrent queries and a corresponding queue timeout. By default, each user can run a maximum of 15 concurrent queries, and the timeout is 600 seconds for queries that are queued because of this limit. These settings apply to both users who log in to Looker using the regular authentication process, and to users who log in using API user credentials. To change these defaults, configure the [Max concurrent queries per user for this connection](/looker/docs/connecting-to-your-db#max-queries-per-user) settings on a connection's [**Connections Settings**](/looker/docs/connecting-to-your-db) page. If your Looker instance is customer-hosted, you can change these defaults by configuring the `--per-user-query-limit` and `--per-user-query-timeout` [startup options](/looker/docs/startup-options).\n\n | **Note:** The default maximum of 15 concurrent queries per user applies to each valid connection and, if your Looker instance is [clustered](/looker/docs/clustering-looker), to each node in the cluster. For example, if a user has access to 2 valid connections, they can run a maximum of 30 concurrent queries, 15 per connection. If the user is on a clustered instance with 2 nodes and has access to 1 valid connection, they can run 30 concurrent queries, 15 per node. If the user has 2 valid connections on a clustered instance with 2 nodes, they can run a maximum of 60 concurrent queries, 15 for each connection on each node.\n- **Scheduler query limit and timeout** : To prevent overloading of the Looker scheduler process, a Looker instance can run a maximum of 10 concurrent scheduled queries, and the timeout for queries in the scheduler queue is 1,200 seconds. If your Looker instance is customer-hosted, you can change these defaults by configuring the `--scheduler-query-limit` and `--scheduler-query-timeout` [startup options](/looker/docs/startup-options).\n\n | **Note:** If your Looker instance is [clustered](/looker/docs/clustering-looker), then each node of the cluster uses its own scheduler queue. Thus, adding nodes to your cluster increases your total amount of allowed concurrent scheduled queries without placing additional burden on the Looker scheduler process.\n- **Renderer query limit and timeout** : To prevent overloading of the Looker renderer process, a Looker instance can render a maximum of 2 concurrent image-based downloads, such as PDF and PNG formats. If your Looker instance is customer-hosted, you can change this default by configuring the `--concurrent-render-jobs` [startup option](/looker/docs/startup-options).\n\n | **Note:** If your Looker instance is [clustered](/looker/docs/clustering-looker), then each node of the cluster uses its own renderer queue. Thus, adding nodes to your cluster increases your total amount of allowed concurrent renderer jobs without placing additional burden on the Looker renderer process.\n\n\u003cbr /\u003e\n\n- **Webhook timeout** : Looker will attempt [data delivery to a webhook](/looker/docs/sharing-and-publishing/scheduling-and-sharing/send-webhook) for a maximum of 30 minutes. If Looker cannot communicate with the webhook destination in 30 minutes, the query will time out. This timeout is not configurable.\n - **Proxy timeout** : Customer-hosted instances often use proxies with a default timeout of 60 seconds. We recommend that this timeout be increased to 60 minutes. See the [Running Looker behind a proxy server or load balancer](https://discuss.google.dev/t/running-looker-behind-a-proxy-server-or-load-balancer/117104) Looker Community post for more information.\n\n - **Database timeout**: Most databases have rules for queueing and timeouts that are independent of Looker's queues and timeouts. For example, a query may have left the Looker queue, but it can still be queued on your database. Check the documentation for your database for more information on customizing database query timeouts."]]
