Impostazioni amministratore - Query

A partire dalla versione 22.16 di Looker, gli amministratori di Looker possono attivare la funzionalità sperimentale di Enhanced Query Admin per ottimizzare la pagina Query. La funzionalità Lab migliora le prestazioni nella pagina Query e elenca 500 query impaginate, anziché 50.

La pagina Query nella sezione Database del menu Admin contiene 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 fuso orario dell'applicazione.
Stato Lo stato della query, che può includere:
  • Cache: Looker ha restituito i risultati dalla propria cache anziché eseguire una query duplicata sul database.
  • Completed (Completata): la query è stata completata correttamente.
  • Errore: la query non è stata completata correttamente a causa di un errore, i cui dettagli possono essere trovati 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 permanente prima di poter essere eseguita.
  • Creazione di PDT: è in corso la creazione di una tabella derivata permanente.
  • Queued (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 la query.
Utente L'utente che ha eseguito questa query, se può essere determinata. 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 Explore (Esplora) 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 necessario per eseguire la query. Ciò include la creazione della query, ogni volta che la query viene utilizzata nella coda, il trasporto da e verso il database e l'esecuzione del database per la query.

Se la query è attualmente in esecuzione, il tempo di esecuzione mostrerà per quanto tempo la query è in esecuzione. Per le query eseguite in precedenza, il runtime mostra anche una stima del tempo necessario per completarla. La stima si basa sulla durata dell'ultima esecuzione della query e avrà un testo simile a "di circa 2 secondi".
Pulsante Dettagli Per ulteriori dettagli, consulta la sottosezione Pulsante Dettagli di questa pagina.

Il pulsante Dettagli

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

  • Una sezione Informazioni che include i dettagli sulla query (vedi la seguente tabella).
  • Una sezione SQL che mostra le query SQL non elaborate eseguite sul database. Commenti contesto non apparirà nelle informazioni Dettagli query. Per evitare che i commenti interferiscano con la 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 di Looker in base alla quale è stata eseguita la query.
Utente L'utente che ha eseguito questa query, se può essere determinata. 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 Explore (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 della sezione 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 necessario per eseguire la query.

Termine query

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

Affinché Looker elimini le query, il tuo 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:

Timeout delle query e code

Looker blocca le query che sono in attesa 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 le query simultanee, Looker blocca le query simultanee in eccesso nella coda delle 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 e le query in coda scadono dopo 0 secondi. Per modificare queste impostazioni predefinite, configura le impostazioni Numero massimo di connessioni e 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 riempia 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 simultanee 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 e timeout delle query dello scheduler: per evitare il sovraccarico del processo dello scheduler di Looker, un'istanza di Looker può eseguire al massimo 10 query pianificate in parallelo e il timeout delle query nella coda degli 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 l'istanza di Looker è in cluster, ogni nodo del cluster utilizza la propria coda degli scheduler. Pertanto, l'aggiunta di nodi al tuo cluster aumenta il numero totale di query pianificate simultanee senza sovraccaricare il processo dello scheduler di Looker.

  • Limite e timeout della query del renderer: per evitare il sovraccarico del processo del renderer di Looker, un'istanza di Looker può eseguire il rendering di massimo 2 download simultanei basati su immagini, 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 l'istanza di Looker è in cluster, ogni nodo del cluster utilizza la propria coda di rendering. Pertanto, l'aggiunta di nodi al tuo cluster aumenta la quantità totale di job di renderer consentiti contemporaneamente senza sovraccaricare ulteriormente il processo di rendering 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 del webhook in 30 minuti, la query scade. Questo timeout non è configurabile.

  • Timeout proxy: le istanze ospitate da Looker utilizzano un proxy che termina qualsiasi query in esecuzione da 60 minuti. Questo timeout non è configurabile.

    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 sull'esecuzione di 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ò essere ancora inserita nella coda del database. Consulta la documentazione del tuo database per ulteriori informazioni sulla personalizzazione dei timeout delle query del database.