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 alle 50 più recenti, consulta la sezione Utilizzo di Looker.

Se hai attivato la funzionalità Labs Amministrazione delle query avanzata, nella pagina Query vengono visualizzate le seguenti schede:

  • Recenti: vengono visualizzate le query eseguite nell'ultima ora. Da questa scheda, gli amministratori di Looker possono annullare le query in esecuzione.
  • Completa: vengono visualizzate le 500 query più recenti.

Se non hai attivato la funzionalità Labs Amministrazione delle query avanzata, la pagina Query elenca le ultime 50 query in un'unica pagina.

Informazioni di base sulle query

Colonna Definizione
Ora 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 della PDT: è in corso la creazione di una tabella derivata permanente.
  • In coda: la query è in attesa di esecuzione 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 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 hanno informazioni aggiuntive, ad esempio quelle eseguite in SQL Runner. Le query emesse da Open SQL Interface hanno un valore Source pari a Sql_interface.
Runtime Il tempo necessario per eseguire la query. Sono inclusi la creazione della query, il tempo trascorso dalla query in coda, il transito verso e dal database e l'esecuzione della query nel database.

Se la query è attualmente in esecuzione, il runtime mostrerà da quanto tempo è in esecuzione. Per le query eseguite in precedenza, il runtime mostra 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 in questa pagina.

Il 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.
  • Una sezione Query interfaccia SQL che viene visualizzata quando è stata eseguita una query tramite l'interfaccia Open SQL. Questa sezione mostra la query SQL inviata a Looker dallo strumento di BI esterno e può essere utile per la risoluzione dei problemi e la loro riproduzione.
  • 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 delle 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 un PDT, il campo non viene visualizzato.
Connessione Il collegamento di Looker in base al 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 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 o i campi selezionati.
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 fuso orario dell'applicazione.
Runtime Il tempo necessario per eseguire la query.

Interruzioni delle query

Quando chiudi la scheda del browser su 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 il 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'eliminazione delle query nell'ultima versione di Looker:

Dialetto Supportata?
Valanga Actia
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Apache Druid
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 e 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
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Database SQL di Microsoft Azure
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008 e versioni successive
Microsoft SQL Server 2012 e versioni successive
Microsoft SQL Server 2016
Microsoft SQL Server 2017 e 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
Vettoriale
Vertica

Timeout e accodamento delle query

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: per evitare il sovraccarico del database con query simultanee, Looker mantiene le query simultanee in eccesso nella coda delle query di Looker e interrompe le query che rimangono in coda per troppo tempo. Per impostazione predefinita, sono consentite 75 query simultanee massime per connessione. Le query aggiuntive oltre il limite di connessioni scadono 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 per query per utente: per impedire a un singolo utente di riempire la coda delle query di Looker, ogni utente ha un numero massimo di query contemporanee consentite e un timeout della coda corrispondente. Per impostazione predefinita, ogni utente può eseguire un massimo di 15 query in parallelo e il timeout è 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 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 la tua istanza di Looker è ospitata dal cliente, puoi modificare questo valore predefinito configurando l'opzione di avvio --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. 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ò essere ancora in coda nel database. Consulta la documentazione del tuo database per ulteriori informazioni sulla personalizzazione dei timeout delle query del database.