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: mostra 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 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.
  • Completata: la query è stata completata correttamente.
  • Errore: la query non è stata completata correttamente 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 di PDT: la query deve attendere la creazione di una tabella derivata persistente 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 è stato in grado di determinare cosa è successo con questa query.
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, viene visualizzato anche un link al look salvato o l'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 inviate dall'interfaccia Open SQL hanno un valore Origine pari a Sql_interface.
Runtime Il tempo necessario per eseguire la query. Sono inclusi la creazione della query, il tempo trascorso dalla query nella coda, il transito da e verso il database e l'esecuzione della query nel database.

Se la query è attualmente in esecuzione, il tempo di esecuzione mostrerà da quanto tempo è in esecuzione. Per le query eseguite in precedenza, il tempo di esecuzione 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 sarà simile a "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. Il popup Dettagli query include quanto segue:

  • Una sezione Informazioni che include i dettagli della query (vedi la tabella seguente).
  • Una sezione SQL che mostra il codice SQL non elaborato eseguito sul database. I commenti sul contesto non vengono visualizzati nelle informazioni Dettagli della 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 è 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 un farmaco con obbligo di prescrizione medica, in questo campo viene visualizzato il commento relativo alla generazione del farmaco con obbligo di prescrizione medica. 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 fuso orario dell'applicazione.
Ora di fine L'ora di fine della query, visualizzata nel fuso orario dell'applicazione.
Runtime La durata dell'esecuzione della query.

Interruzioni delle query

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. Le query ancora in esecuzione sono contrassegnate da un pulsante Interrompi a destra. 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 i dialetti che supportano l'interruzione delle query nell'ultima release di Looker:

Dialetto Supportato?
Actian Avalanche
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 e versioni successive
Apache Hive 3.1.2 e versioni successive
Apache Spark 3 e versioni successive
ClickHouse
Cloudera Impala 3.1 e versioni successive
Cloudera Impala 3.1 e versioni successive con driver nativo
Cloudera Impala con driver nativo
DataVirtuality
Databricks
Denodo 7
Denodo 8
Dremio
Dremio 11+
Exasol
Fulmine
SQL precedente di Google BigQuery
SQL standard di Google BigQuery
No
PostgreSQL di Google Cloud
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 e versioni successive
Oracle
Oracle ADWC
PostgreSQL 9.5 e versioni successive
PostgreSQL precedente alla versione 9.5
PrestoDB
PrestoSQL
SAP HANA 2 e versioni successive
SingleStore
SingleStore 7 e versioni successive
Snowflake
Teradata
Trino
Vettoriale
Vertica

Timeout delle query e coda

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 scadranno dopo 0 secondi. Per modificare questi valori predefiniti, configura le impostazioni Connessioni massime e Timeout pool di connessioni nella pagina Impostazioni 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 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 la normale procedura di autenticazione sia a quelli che accedono utilizzando le credenziali utente dell'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 dell'organizzatore: per evitare il sovraccarico del processo di pianificazione di Looker, un'istanza di Looker può eseguire un massimo di 10 query pianificate in contemporanea e il timeout per le query nella coda dell'organizzatore è 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 contemporaneamente 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 webhook: Looker tenterà di distribuire i dati a un webhook per un massimo di 30 minuti. Se Looker non riesce a comunicare con la destinazione dell'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. Consigliamo di aumentare questo timeout a 60 minuti. Per ulteriori informazioni, consulta il post della community di Looker Eseguire Looker dietro un server proxy o un bilanciatore del carico.

    • Timeout del database: la maggior parte dei database ha regole per le code 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. Per ulteriori informazioni sulla personalizzazione dei timeout delle query del database, consulta la documentazione del tuo database.