Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La pagina Query nella sezione Database del menu Amministrazione elenca informazioni sulle ultime 50 query che Looker ha inviato al tuo database. Per informazioni sulle query meno recenti delle ultime 50, consulta la sezione Utilizzo di Looker.
Cache: Looker ha restituito i risultati dalla cache anziché eseguire una query duplicata sul database.
Completata: la query è stata completata correttamente.
Errore: la query non è stata completata correttamente perché si è verificato un errore, i cui dettagli sono disponibili facendo clic sul pulsante Dettagli.
Annullata: la query è stata annullata da Looker o dall'utente.
In attesa di PDT: la query deve attendere la creazione di una tabella derivata persistente prima di poter essere eseguita.
In coda: la query è in attesa di essere eseguita perché sono già in corso troppe query (le query possono essere limitate da Looker nella configurazione della connessione o nel database).
In esecuzione: la query è in fase di esecuzione.
Sconosciuto: Looker non è riuscito a determinare cosa è successo con questa query.
Connessione
La connessione di Looker in base alla quale è stata eseguita questa query.
Utente
L'utente che ha eseguito questa query, se è possibile determinarlo. Alcune query non vengono eseguite da un utente specifico, ad esempio quando Looker crea una tabella derivata persistente o quando un utente sconosciuto accede a un Look pubblico.
Origine
L'origine della query in Looker, ad esempio la pagina Esplora o SQL Runner. Se possibile, viene visualizzato anche un link al Look salvato o all'ID query insieme al nome del modello e dell'esplorazione. Alcune query non hanno informazioni aggiuntive, ad esempio quelle eseguite in SQL Runner. Le query emesse dall'interfaccia SQL aperta hanno un valore Origine pari a Sql_interface.
Runtime
Il tempo necessario per eseguire la query. Ciò include la creazione della query, il tempo trascorso in coda, il transito da e verso il database e l'esecuzione della query nel database.Se la query è in esecuzione, il runtime mostrerà la durata dell'esecuzione. Per le query eseguite in precedenza, il runtime mostrerà anche una stima del tempo necessario per completare l'esecuzione della query. La stima si basa sulla durata dell'ultima esecuzione della query e indica un valore simile a "circa 2 secondi".
Pulsante Dettagli
Per ulteriori dettagli, consulta la sottosezione Il pulsante Dettagli in questa pagina.
Pulsante Dettagli
Se fai clic sul pulsante Dettagli a destra di una query, vengono visualizzate informazioni aggiuntive. Il menu Dettagli query include quanto segue:
Una sezione Informazioni che include i dettagli della query (vedi la tabella seguente).
Una sezione SQL che mostra l'SQL non elaborato eseguito sul database. I commenti contestuali non verranno visualizzati nelle informazioni Dettagli query. Per evitare che i commenti influiscano sulla memorizzazione nella cache delle query, Looker aggiunge i commenti di contesto ai comandi SQL in uscita appena prima di inviare il codice SQL al database.
Una sezione Query interfaccia SQL che viene visualizzata quando una query è stata emessa tramite l'interfaccia SQL aperta. Questa sezione mostra la query SQL inviata a Looker dallo strumento di BI esterno e può aiutarti a risolvere i problemi e a riprodurli.
Un link Apri in SQL Runner che aprirà la query in SQL Runner.
La sezione Informazioni include le seguenti informazioni:
La connessione di Looker in base alla quale è stata eseguita questa query.
Utente
L'utente che ha eseguito questa query, se è possibile determinarlo. Alcune query non vengono eseguite da un utente specifico, ad esempio quando Looker crea una tabella derivata persistente o quando un utente sconosciuto accede a un Look pubblico.
Origine
L'origine della query in Looker, ad esempio la pagina Esplora o SQL Runner. Se possibile, vengono visualizzate informazioni aggiuntive, ad esempio un link al Look salvato, l'ID query, il nome del modello, il nome dell'esplorazione o i campi selezionati.
Quando chiudi la scheda del browser in cui è in esecuzione una query, Looker la interrompe automaticamente. Gli amministratori di Looker possono anche interrompere una query in esecuzione dalla pagina Query. Gli utenti con l'autorizzazione see_queries possono visualizzare la pagina Query, ma solo gli amministratori di Looker possono interrompere una query in esecuzione. Per qualsiasi query ancora in esecuzione viene visualizzato un pulsante Interrompi a destra della query. Fai clic su Interrompi per interrompere la query.
Affinché Looker possa interrompere le query, il dialetto del database deve supportare l'interruzione delle query. Il seguente elenco mostra quali dialetti supportano l'interruzione delle query nell'ultima release di Looker:
Dialetto
Supportato?
Actian Avalanche
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
Sì
Amazon Redshift
Sì
Amazon Redshift 2.1+
Sì
Amazon Redshift Serverless 2.1+
Sì
Apache Druid
No
Apache Druid 0.13+
No
Apache Druid 0.18+
No
Apache Hive 2.3+
Sì
Apache Hive 3.1.2+
Sì
Apache Spark 3+
Sì
ClickHouse
Sì
Cloudera Impala 3.1+
Sì
Cloudera Impala 3.1+ with Native Driver
Sì
Cloudera Impala with Native Driver
Sì
DataVirtuality
Sì
Databricks
Sì
Denodo 7
Sì
Denodo 8 & 9
Sì
Dremio
Sì
Dremio 11+
Sì
Exasol
Sì
Firebolt
Sì
Google BigQuery Legacy SQL
Sì
Google BigQuery Standard SQL
Sì
Google Cloud PostgreSQL
Sì
Google Cloud SQL
Sì
Google Spanner
Sì
Greenplum
Sì
HyperSQL
No
IBM Netezza
Sì
MariaDB
Sì
Microsoft Azure PostgreSQL
Sì
Microsoft Azure SQL Database
Sì
Microsoft Azure Synapse Analytics
Sì
Microsoft SQL Server 2008+
Sì
Microsoft SQL Server 2012+
Sì
Microsoft SQL Server 2016
Sì
Microsoft SQL Server 2017+
Sì
MongoBI
Sì
MySQL
Sì
MySQL 8.0.12+
Sì
Oracle
Sì
Oracle ADWC
Sì
PostgreSQL 9.5+
Sì
PostgreSQL pre-9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA
Sì
SAP HANA 2+
Sì
SingleStore
Sì
SingleStore 7+
Sì
Snowflake
Sì
Teradata
Sì
Trino
Sì
Vector
Sì
Vertica
Sì
Timeout delle query e accodamento
Looker interrompe le query in attesa in coda da troppo tempo. Questa operazione è chiamata timeout. Alla tua query potrebbero essere applicati diversi timeout:
Timeout del pool di connessioni e query simultanee massime: per evitare il sovraccarico del database con query simultanee, Looker mantiene le query simultanee in eccesso nella coda di query di Looker e interrompe le query che rimangono in coda troppo a lungo. Per impostazione predefinita, sono consentite 75 query simultanee per connessione. Le query aggiuntive oltre il limite di connessione scadranno dopo 0 secondi. Per modificare questi valori predefiniti, configura le impostazioni Numero massimo di connessioni, Numero massimo di query contemporanee per questa connessione e Timeout pool di connessioni nella pagina Impostazioni connessioni di una connessione.
Limite di query e timeout per utente: per impedire a un singolo utente di riempire la coda di query di Looker, ogni utente ha un numero massimo di query simultanee consentite e un timeout della coda corrispondente. Per impostazione predefinita, ogni utente può eseguire un massimo di 15 query simultanee e il timeout è di 600 secondi per le query in coda a causa di questo limite. Queste impostazioni si applicano sia agli utenti che accedono a Looker utilizzando il normale processo di autenticazione sia a quelli che accedono utilizzando le credenziali utente API. Per modificare questi valori predefiniti, configura le impostazioni Numero massimo di query contemporanee per utente per questa connessione nella pagina Impostazioni connessioni di una connessione. Se la tua istanza di Looker è ospitata dal cliente, puoi modificare questi valori predefiniti configurando le opzioni di avvio--per-user-query-limit e --per-user-query-timeout.
Limite e timeout delle query dello scheduler: per evitare il sovraccarico del processo dello scheduler di Looker, un'istanza di Looker può eseguire un massimo di 10 query programmate simultanee e il timeout per le query nella coda dello scheduler è di 1200 secondi. Se la tua istanza di Looker è ospitata dal cliente, puoi modificare questi valori predefiniti configurando le opzioni di avvio--scheduler-query-limit e --scheduler-query-timeout.
Limite e timeout delle query del renderer: per evitare il sovraccarico del processo di rendering di Looker, un'istanza di Looker può eseguire il rendering di un massimo di due download simultanei basati su immagini, ad esempio nei formati PDF e PNG. Se la tua istanza di Looker è ospitata dal cliente, puoi modificare questo valore predefinito configurando l'opzione di avvio--concurrent-render-jobs.
Timeout webhook: Looker tenterà la distribuzione dei dati a un webhook per un massimo di 30 minuti. Se Looker non riesce a comunicare con la destinazione del webhook entro 30 minuti, la query andrà in timeout. Questo timeout non è configurabile.
Timeout proxy: le istanze ospitate dal cliente spesso utilizzano proxy con un timeout predefinito di 60 secondi. Ti consigliamo di aumentare questo timeout a 60 minuti. Per ulteriori informazioni, consulta il post della community di Looker Esecuzione di Looker dietro un server proxy o un bilanciatore del carico.
Timeout del database: la maggior parte dei database ha regole per la gestione delle code e dei timeout indipendenti da quelle di Looker. Ad esempio, una query potrebbe essere stata rimossa dalla coda di Looker, ma potrebbe essere ancora in coda nel database. Per ulteriori informazioni sulla personalizzazione dei timeout delle query del database, consulta la documentazione del database.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-08 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."]]
