Impostazioni amministratore - Query

La pagina Query nella sezione Database del menu Amministrazione elenca le informazioni sulle ultime 50 query inviate da Looker al tuo database. Per informazioni sulle query precedenti, consulta la sezione Utilizzo di Looker.

Informazioni di base sulle query

Colonna Definizione
Tempo L'ora di inizio della query, visualizzata nel tuo fuso orario applicazione.
Stato Lo stato della query, che può includere:
  • Cache: Looker ha restituito i risultati dalla propria cache invece di eseguire una query duplicata sul database.
  • Completata: la query è stata completata.
  • Errore: la query non è stata completata a causa di un errore i cui dettagli sono disponibili facendo clic sul pulsante Dettagli.
  • Annullata: la query è stata annullata da Looker o dall'utente.
  • In attesa della PDT: la query deve attendere la creazione di una tabella derivata permanente prima di poter essere eseguita.
  • Creazione di PDT: è in corso la creazione di una tabella derivata permanente.
  • 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 tuo database).
  • In esecuzione: la query è in fase di esecuzione.
  • Sconosciuto: Looker non è riuscito a determinare cosa è successo con questa query.
Connessione La connessione Looker tramite la quale è stata eseguita la query.
Utente L'utente che ha eseguito la query, se possibile. Alcune query non vengono eseguite da un utente specifico, ad esempio quando Looker crea una tabella derivata permanente 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 all'esplorazione. Alcune query non avranno informazioni aggiuntive, come quelle eseguite in SQL Runner.
Runtime Il tempo necessario per eseguire la query. Ciò include la creazione della query, ogni volta che la query è rimasta in coda, il transito da e verso il database ed esecuzione della query del database.

Se la query è attualmente in esecuzione, il runtime mostrerà da quanto tempo è in 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 indicherà ad esempio "di circa 2 secondi".
Pulsante Dettagli Per ulteriori dettagli, consulta la sottosezione Il pulsante Dettagli di questa pagina.

Pulsante Dettagli

Se fai clic sul pulsante Dettagli a destra di una query, vengono visualizzate ulteriori informazioni sulla query in questione. Il popup Dettagli query include quanto segue:

  • Una sezione Informazioni che include dettagli sulla query (vedi la tabella seguente).
  • Una sezione SQL che mostra il codice 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 contestuali ai comandi SQL in uscita subito prima che l'SQL venga inviato al database.
  • Un link Apri in SQL Runner che aprirà la query in SQL Runner.

La sezione Informazioni include le seguenti informazioni:

Sezione Definizione
ID cronologia L'ID cronologia della query, se disponibile.
Stato Lo stato della query, come descritto nella tabella con le informazioni di base sulle query.
Messaggio Se la query contiene una PDT, in questo campo viene visualizzato il commento sulla generazione PPD. Se la query non contiene una PDT, il campo non viene visualizzato.
Connessione La connessione Looker tramite la quale è stata eseguita la query.
Utente L'utente che ha eseguito la query, se possibile. Alcune query non vengono eseguite da un utente specifico, ad esempio quando Looker crea una tabella derivata permanente 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, i campi selezionati e così via.
Ora di inizio L'ora di inizio della query, visualizzata nel tuo fuso orario applicazione.
Ora di fine L'ora di fine della query, visualizzata nel tuo fuso orario dell'applicazione.
Runtime Il tempo necessario per eseguire la query.

Fine query

Looker interromperà automaticamente una query ancora in esecuzione quando chiudi la scheda del browser in cui è in esecuzione. 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 il pulsante Interrompi a destra della query. Fai clic su Interrompi per interrompere la query.

Affinché Looker possa terminare le query, il tuo dialetto del database deve supportarlo. Il seguente elenco mostra i dialetti che supportano l'eliminazione delle query nell'ultima release di Looker:

Dialetto Supportata?
Valanga Actia
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Druid Apache
No
Apache Druid 0.13 o versioni successive
No
Apache Druid 0.18 o versioni successive
No
Apache Hive 2.3 o versioni successive
Apache Hive 3.1.2 o versioni successive
Apache Spark 3 e versioni successive
ClickHouse
Cloudera Impala 3.1 o versioni successive
Cloudera Impala 3.1 o versioni successive con driver nativo
Cloudera Impala con driver nativo
DataVirtuality
Databricks
Denodo 7
Denodo 8
Dremio
Dremio 11+
Exasol
Firebolt
SQL precedente di Google BigQuery
SQL standard di Google BigQuery
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
No
Netezza di IBM
MariaDB
PostgreSQL Microsoft Azure
Database SQL di Microsoft Azure
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008 e versioni successive
Microsoft SQL Server 2012 o versioni successive
Microsoft SQL Server 2016
Microsoft SQL Server 2017 o versioni successive
MongoBI
MySQL
MySQL 8.0.12 o versioni successive
Oracle
Oracle ADWC
PostgreSQL 9.5 e versioni successive
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA 2 o versioni successive
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vettore
Vertica

Timeout e accodamento delle query

Looker elimina le query che sono rimaste in coda troppo a lungo. Questa operazione è chiamata timeout. Alla query possono essere applicati diversi timeout:

  • Timeout del pool di connessioni: per evitare il sovraccarico del database con query simultanee, Looker trattiene le query simultanee in eccesso nella coda di query di Looker e termina le query che rimangono in coda per troppo tempo. Per impostazione predefinita, è consentito un massimo di 75 query in parallelo per connessione. Le query aggiuntive oltre il limite di connessioni verranno scadute dopo 0 secondi. Per modificare queste impostazioni predefinite, configura le impostazioni per numero massimo di connessioni e timeout del pool di connessioni nella pagina Impostazioni delle connessioni di una connessione.

  • Limite e timeout delle query per utente: per evitare che un singolo utente riempia la coda di query di Looker, a ogni utente è consentito un numero massimo di query simultanee e il corrispondente timeout della coda. Per impostazione predefinita, ogni utente può eseguire un massimo di 15 query in parallelo e il timeout per le query in coda a causa di questo limite è di 600 secondi. Queste impostazioni si applicano sia agli utenti che accedono a Looker utilizzando il normale processo di autenticazione sia agli utenti che accedono con credenziali utente API. Se l'istanza di Looker è ospitata dal cliente, puoi modificare queste impostazioni predefinite 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 pianificate in parallelo e il timeout per le query nella coda dello scheduler è di 1200 secondi. Se l'istanza di Looker è ospitata dal cliente, puoi modificare queste impostazioni predefinite 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 del renderer di Looker, un'istanza di Looker può eseguire il rendering di un massimo di due download simultanei basati su immagini, ad esempio i formati PDF e PNG. Se l'istanza di Looker è ospitata dal cliente, puoi modificare questa impostazione predefinita configurando l'opzione di avvio di --concurrent-render-jobs.

  • Timeout del webhook: Looker tenta di inviare i 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 scadrà. Questo timeout non è configurabile.
    • Timeout del 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 scheda Community di Looker su come eseguire Looker dietro un server proxy o un bilanciatore del carico.

    • Timeout del database: la maggior parte dei database ha regole per l'accodamento e i timeout indipendenti dalle code e dai timeout di Looker. Ad esempio, una query potrebbe aver lasciato la coda di Looker, ma può comunque essere messa in coda nel database. Consulta la documentazione del tuo database per ulteriori informazioni sulla personalizzazione dei timeout delle query del database.