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 La connessione di Looker in base alla 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 in coda, il transito verso e dal database e l'esecuzione della query nel database.

Se la query è in esecuzione, il tempo di esecuzione mostra 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 menu 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 li aggiunge 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 PDT, in questo campo viene visualizzato il commento relativo alla generazione del PDT. Se la query non contiene un PDT, il campo non viene visualizzato.
Connessione La connessione di Looker in base alla 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+
No
Apache Druid 0.18+
No
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8
Dremio
Dremio 11+
Exasol
Firebolt
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
No
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
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 e query contemporanee massime: per evitare il sovraccarico del database con query contemporanee, Looker mantiene le query contemporanee 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, Numero massimo di query contemporanee per questa connessione e Timeout del 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. Per modificare questi valori predefiniti, configura le impostazioni Numero massimo di query contemporanee per utente per questa connessione nella pagina Impostazioni connessioni di una connessione. 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 dell'organizzatore di Looker, un'istanza di Looker può eseguire un massimo di 10 query programmate 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.