Impostazioni amministratore - Query

Gli amministratori di Looker possono attivare la funzionalità sperimentale Admin Query Admin per migliorare la pagina Query. La funzionalità Labs migliora le prestazioni nella pagina Query e elenca 500 query impaginate anziché 50.

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
Ora L'ora di inizio della query, visualizzata nel fuso orario dell'applicazione.
Stato Lo stato della query, che può includere:
  • Cache: Looker ha restituito i risultati dalla cache anziché eseguire una query duplicata sul database.
  • Completed (Completata): la query è stata completata correttamente.
  • Errore: la query non è stata completata a causa di un errore. Puoi visualizzarne i dettagli facendo clic sul pulsante Dettagli.
  • Annullata: la query è stata annullata da Looker o dall'utente.
  • In attesa di PDT: per poter essere eseguita, la query deve attendere la creazione di una tabella derivata permanente.
  • Creazione di PDT: durante la creazione di una tabella derivata permanente è in corso la creazione.
  • 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 ha potuto determinare cosa è accaduto con questa query.
Connessione La connessione Looker in cui è stata eseguita la query.
Utente L'utente che ha eseguito questa query, se possibile. Alcune query non vengono eseguite da un utente specifico, come 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 Explore o SQL Runner. Se possibile, viene visualizzato anche un link al Look salvato o all'ID query, insieme al nome del modello ed Esplora. Alcune query non avranno informazioni aggiuntive, come quelle eseguite in SQL Runner.
Runtime Il tempo impiegato per eseguire la query. Questo include la costruzione della query, ogni volta che la query viene utilizzata nella coda, in transito da e verso il database ed esecuzione del database della query.

Se la query è attualmente in esecuzione, il tempo di esecuzione mostra per quanto tempo la query è in esecuzione. Per le query che erano state eseguite in precedenza, il tempo di esecuzione 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 restituisce un testo simile a "di circa 2 s".
Pulsante Dettagli Per ulteriori dettagli, consulta la sottosezione Pulsante Dettagli in questa pagina.

Il pulsante Dettagli

Fai clic sul pulsante Dettagli a destra di una query per visualizzare ulteriori informazioni sulla query. Il popup Dettagli query include quanto segue:

  • Una sezione Informazioni che include dettagli sulla query (vedi la seguente tabella).
  • Una sezione SQL che mostra l'SQL non elaborato eseguito sul database. I commenti del contesto non verranno visualizzati nelle informazioni di dettagli delle query. Per evitare che i commenti influiscano sulla memorizzazione nella cache delle query, Looker aggiunge i commenti relativi al contesto ai comandi SQL in uscita, appena prima di inviare il codice SQL 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 sopra.
Connessione La connessione Looker in cui è stata eseguita la query.
Utente L'utente che ha eseguito questa query, se possibile. Alcune query non vengono eseguite da un utente specifico, come 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, come un link al Look salvato, l'ID query, il nome del modello, il nome dell'Esplora, i campi selezionati e così via.
Ora di inizio L'ora di inizio della query, visualizzata nel fuso orario dell'applicazione.
Ora di fine L'ora di fine della query, visualizzata nel fuso orario dell'applicazione.
Runtime Il tempo impiegato per eseguire la query.

Termine query

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

Per consentire a Looker di terminare le query, il dialetto del tuo database deve supportare l'interruzione delle query. Nell'elenco seguente sono indicati i dialetti che supportano l'interruzione delle query nell'ultima release di Looker:

Timeout delle query e coda

Looker elimina le query in attesa da troppo tempo. Questa operazione è chiamata timeout. Alla query potrebbero essere applicati diversi timeout:

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

  • Limite di query e timeout per utente: per evitare che un singolo utente compili la coda delle 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 in parallelo e il timeout per le query in coda a causa di questo limite è di 600 secondi. Se la tua 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 di query e timeout dello scheduler: per evitare il sovraccarico del processo di 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 la tua istanza di Looker è ospitata dal cliente, puoi modificare queste impostazioni predefinite configurando le opzioni di avvio --scheduler-query-limit e --scheduler-query-timeout.

    Se la tua istanza di Looker è in cluster, ogni nodo del cluster utilizza la propria coda dello scheduler. Pertanto, l'aggiunta di nodi al cluster aumenta la quantità totale di query pianificate simultanee consentite, senza sovraccaricare ulteriormente il processo dello scheduler di Looker.

  • Limite di query e timeout 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 basati su immagini simultanei, ad esempio formati PDF e PNG. Se la tua istanza di Looker è ospitata dal cliente, puoi modificare questa impostazione predefinita configurando l'opzione di avvio --concurrent-render-jobs.

    Se la tua istanza di Looker è in cluster, ogni nodo del cluster utilizza la propria coda di renderer. Pertanto, l'aggiunta di nodi al cluster aumenta la quantità totale di job del renderer simultanei consentiti senza imporre un ulteriore carico di lavoro sul processo del renderer di Looker.

  • Timeout 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 webhook entro 30 minuti, la query scade. 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 impostare un timeout di 60 minuti. Per ulteriori informazioni, consulta il post della community di Looker che esegue Looker dietro un server proxy o un bilanciatore del carico.

  • Timeout del database: la maggior parte dei database prevede regole per la coda e i timeout, che sono 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 sul tuo database. Consulta la documentazione relativa al tuo database per ulteriori informazioni sulla personalizzazione dei timeout delle query del database.