Impostazioni amministratore - Tabelle derivate permanenti

Le funzioni delle tabelle derivate persistenti (PDT) di Looker ti consentono di eseguire analisi complesse all'interno di Looker. Looker mostra diverse funzionalità di amministrazione che possono essere utili per monitorare e risolvere i problemi relativi al comportamento delle tabelle derivate permanenti nella pagina Tabelle derivate permanenti, a cui gli amministratori e gli utenti con le autorizzazioni appropriate possono accedere dalla sezione Database del riquadro Amministrazione di Looker. Per informazioni sulla risoluzione dei problemi relativi alle tabelle PDT, consulta la pagina della documentazione relativa alle tabelle derivate in Looker.

La pagina Tabelle derivate permanenti mostra solo le connessioni in cui sono abilitate le tabelle derivate permanenti e solo le tabelle derivate permanenti che soddisfano i seguenti criteri:

• Il file PDT è definito in un file di visualizzazione in produzione, a meno che tu non sia in modalità di sviluppo, nel qual caso puoi utilizzare la scheda Sviluppo per visualizzare la versione di sviluppo delle tabelle persistenti.
• La PDT fa parte di un modello configurato correttamente.
• Il PDT fa parte di un modello per cui disponi dell'accesso ai dati.

Le informazioni in questa pagina si basano su un log eventi PDT interno, descritto nella sezione Modello di log eventi PDT in questa pagina.

Personalizzazione della tabella

Per impostazione predefinita, la pagina Tabelle derivate permanenti mostra un massimo di 25 PDT e carica le PDT per tutte le connessioni per le quali disponi di accesso ai dati sull'istanza di Looker. Esistono diversi modi per modificare i dati visualizzati nella tabella:

1. Fai clic sulla freccia accanto a Tutte le connessioni per visualizzare le PDT solo da una connessione specifica. Il selettore mostra solo le connessioni con le PDT abilitate e le quali hai accesso ai dati.
2. Digita le parole chiave nella casella di ricerca per restringere l'elenco dei PDT ai PDT i cui nomi includono la parola chiave. La tabella mostrerà i PDT con il termine di ricerca corrispondente in grassetto. Fai clic sulla X nella barra di ricerca per cancellare i termini della query di ricerca.
3. Fai clic sull'icona Filtri per definire un filtro per la tabella.
4. Fai clic sull'icona di chiusura/apertura per visualizzare o nascondere la sezione Riepilogo.
5. Fai clic sul nome di una colonna per ordinare la tabella in base a quella colonna. Fai clic di nuovo sul nome della colonna per invertire l'ordinamento.
6. Fai clic sull'icona Seleziona colonne da visualizzare per nascondere o visualizzare le colonne della tabella.
7. Utilizza il selettore di visualizzazione per scegliere il numero di risultati da visualizzare in una singola pagina. Se la tabella è più lunga di una pagina, puoi fare clic sulle frecce in basso al centro della pagina per passare alla pagina successiva o precedente.

Filtri

Puoi utilizzare l'icona Filtri accanto alla barra di ricerca per scegliere quali PDT mostrare nella pagina Tabelle derivate permanenti. Ad esempio, puoi filtrare in base a Ultimo stato compilazione per visualizzare solo i PDT che presentano un errore di compilazione oppure puoi filtrare in base a Modello per limitare i PDT visualizzati a un modello specifico.

Per filtrare la pagina Tabelle derivate permanenti:

1. Fai clic sull'icona Filtri .
2. Seleziona un'opzione di filtro dal primo selettore di filtro nel menu dei filtri. Sono disponibili le seguenti opzioni:
   • Non attivate nell'ultima: filtra la pagina Tabelle derivate permanenti in base alle PDT che non sono state attivate in un numero specificato di ore e minuti.
   • Attivato nell'ultimo: filtra la pagina Tabelle derivate permanenti in base alle PDT che sono state attivate in un numero specificato di ore e minuti.
   • Modello: filtra la pagina Persistent Derived Tables (Tabelle derivate permanenti) per visualizzare le PDT incluse in un modello specificato.
   • Regola di persistenza: filtra la pagina Persistent Derived Tables (Tabelle derivate permanenti) in base al tipo di persistenza delle PDT.
   • Stato ultimo tentativo: filtra la pagina Tabelle derivate permanenti in base a uno stato PDT specificato.
   • Pubblicata come vista stabile: un valore booleano che filtra la pagina Persistent Derived Tables per le PDT e mostra Sì per le PDT pubblicate come vista stabile e No per le PDT non pubblicate come vista stabile, come determinato dal valore parametro publish_as_db_view.
   • Durata dell'ultima build più lunga di: filtra la pagina Tabelle derivate permanenti in base alle PDT le cui build hanno richiesto più di un numero di secondi specificato.
   • Progetto: filtra la pagina Persistent Derived Tables in base alle PDT del progetto LookML specificato.
3. Scegli il valore in base al quale vuoi filtrare la pagina Tabelle derivate permanenti nel secondo selettore di filtri. Per le opzioni Non attivato nell'ultimo o Attivato nell'ultimo, inserisci il numero di ore o minuti. Per l'opzione Durata ultima build più lunga di, inserisci un numero di secondi.
4. Fai clic su Aggiungi filtro per aggiungere altri filtri e ripeti i passaggi 2 e 3 per ogni filtro aggiunto.
   • Per cancellare i filtri selezionati e ricominciare in qualsiasi momento, fai clic su Cancella tutto.
   • Per rimuovere singoli filtri aggiuntivi, fai clic sull'opzione Cancella per il filtro da rimuovere.
5. Per applicare i criteri di filtro selezionati alla pagina Tabelle derivate permanenti, fai clic su Applica.

I filtri applicati verranno visualizzati nella parte superiore della pagina Tabelle derivate permanenti.

Fai clic sulla X accanto a un filtro applicato nella pagina Tabelle derivate permanenti per rimuovere il filtro dalla pagina Tabelle derivate permanenti. Fai clic su Cancella tutto per cancellare tutti i filtri.

Comprensione della pagina PDT

Le sezioni seguenti descrivono le informazioni nella pagina Tabelle derivate permanenti.

Schede Produzione e Sviluppo

Se sei uno sviluppatore LookML in modalità di sviluppo, la tabella Persistent Derived Tables contiene due schede:

• La scheda Produzione è selezionata per impostazione predefinita e mostra i PDC di produzione. Si tratta dei PDT che sono stati implementati in produzione nella tua istanza e forniscono i dati per le query di esplorazione degli utenti. Se sei in modalità di produzione o se non disponi delle autorizzazioni develop, la pagina Tabelle derivate permanenti non mostrerà alcuna scheda e mostrerà solo le informazioni relative alle tabelle derivate permanenti di produzione.

• La scheda Sviluppo mostra le PDT di sviluppo. Le PDT di sviluppo non sono ancora state inviate all'ambiente di produzione.

Looker crea una PDT di sviluppo quando uno sviluppatore LookML in modalità di sviluppo apporta modifiche che influiscono sui dati nella PDT o sul modo in cui viene eseguita la query sulla PDT. Queste modifiche richiedono a Looker di creare la PDT di sviluppo, ma in realtà non la crea, a meno che non venga eseguita una query sulla PDT dopo aver apportato le modifiche. La scheda Sviluppo può aiutarti a determinare quali PDT di sviluppo sono stati creati da Looker e se sono stati compilati.

Suggerimento: puoi anche visualizzare le PDT non create nel tuo progetto utilizzando l'IDE di Looker.

Consulta la pagina della documentazione Tabelle derivate in Looker per saperne di più su cosa richiede a Looker di creare PDT di sviluppo e sulla durata della loro permanenza nel database.

Sezione Riepilogo

La sezione Riepilogo mostra un riepilogo visivo dello stato delle PDT attualmente visualizzate nella tabella PDT. Se hai definito filtri per la tabella o se hai utilizzato la freccia accanto a Tutte le connessioni nella parte superiore della pagina per restringere la tabella a una connessione specifica, la sezione Riepilogo restringerà i risultati in modo che corrispondano a quanto mostrato nella tabella PDT.

Puoi mostrare o nascondere la sezione Riepilogo facendo clic sull'icona di chiusura/apertura nella parte superiore della sezione.

Colonne della tabella

Le sezioni seguenti descrivono le colonne della tabella nella pagina Tabelle derivate permanenti. Fai clic sull'icona Seleziona colonne da visualizzare per nascondere o visualizzare alcune colonne della tabella. Per ulteriori informazioni, consulta la sezione Personalizzazione della tabella in questa pagina.

Nome PDT

La colonna Nome PDT mostra il nome del report di dati proprietari come definito nel parametro view del file di visualizzazione LookML del report di dati proprietari.

La colonna PDT Name (Nome PDT) mostra queste informazioni aggiuntive sotto il nome della PDT, se applicabile:

• Build precedente indica che la riga mostra informazioni su una build PDT precedente. Per ulteriori informazioni su questo messaggio, vedi il popup Dettagli PST nel menu Opzioni.
• Incrementale indica che la PDT è una PDT incrementale.
• Vista materializzata indica che il report pianificato è una vista materializzata nel tuo database.

Stato ultimo tentativo

La colonna Stato ultimo tentativo mostra lo stato dell'ultimo tentativo di creare tutte le PDT elencate:

• La rigenerazione indica che è possibile eseguire query sulla PDT e che è attualmente in fase di creazione una tabella aggiornata. Un timestamp indica quando è iniziata la creazione della PDT.
• Operazione riuscita indica che una PDT è stata creata correttamente.
• Creazione indica che una PDT è attualmente in fase di creazione e non è possibile eseguire query fino al completamento della build.
• Non creata indica che al momento una PDT non è stata creata.
• Errore di compilazione indica che si è verificato un errore durante una compilazione. Se disponi delle autorizzazioni appropriate per visualizzare il codice LookML, puoi fare clic su Errore di compilazione per visualizzare l'origine dell'errore e passare al codice LookML del report di dati proprietari. Consulta la sezione menu Opzioni in questa pagina per scoprire di più sulla risoluzione dei problemi relativi alle PDT nella pagina Tabelle derivate permanenti.

Ultimo tentativo alle ore

La colonna Ultimo tentativo alle indica l'ora dell'ultimo tentativo di build PDT.

Ultima build riuscita

La colonna Ultima build riuscita indica l'ora dell'ultima build riuscita del file PDT.

Durata ultima build

La colonna Durata ultima build mostra la quantità di tempo in secondi impiegata per l'ultima build della PDT e quanto tempo impiega in media per crearla, in secondi.

Regola di persistenza

La colonna Regola di persistenza mostra il tipo di persistenza applicato a una PDT, come definito nel file di visualizzazione della PDT. Indica anche l'ultima volta che è stata controllata una PDT creata correttamente (per le PDT di tipo trigger) o la data di scadenza di una PDT creata correttamente (per le PDT di tipo persistente). Nella colonna Regola di persistenza sono visualizzati due tipi di persistenza:

• Per le PDT persistenti con il parametro persist_for viene visualizzata la dicitura Persist per: (tempo).
• Trigger: (nome gruppo di dati) viene visualizzato per le PDT persistenti con un parametro datagroup_trigger. Puoi fare clic sul link del nome del gruppo di dati per visualizzare il valore sql_trigger per il parametro datagroup.
• Trigger: SQL viene visualizzato per le PDT persistenti con un parametro sql_trigger_value. Puoi fare clic sul link per visualizzare l'istruzione sql_trigger_value.
• L'opzione Vista materializzata viene visualizzata per le viste materializzate, che sfruttano la funzionalità del database per rendere persistenti le tabelle derivate nel database.

Progetto

La colonna Progetto indica il nome del progetto LookML in cui è definita la PDT.

Connessione

Se nella selezione della connessione è selezionata l'opzione Tutte le connessioni, viene visualizzata la colonna Connessione con il nome della connessione su cui è attivato il PDT.

Modello

La colonna Modello mostra il nome del file del modello in cui è incluso il file di visualizzazione della PDT.

Nota: se un file di vista PDT è incluso in più file di modello che condividono la stessa connessione, nella colonna Modello verranno visualizzati più modelli. Se un file di visualizzazione PDT è incluso in più file di modelli con connessioni diverse, il file PDT verrà visualizzato anche in altri elenchi di file PDT di connessione.

È importante essere espliciti al momento di includere i file di vista nei modelli, poiché l'inclusione di tutti i file di vista potrebbe ingombrare lo schema del database e causare la creazione di più copie di PDT nel tuo database o su più database.

Menu Opzioni

Il menu Opzioni con tre puntini è particolarmente utile per la risoluzione dei problemi relativi a comportamenti imprevisti. Le opzioni che presenta ti consentono di controllare l'ultima volta che le tabelle sono state create, il tempo necessario per la loro creazione, confrontare l'ora di compilazione più recente con quella media e verificare se gli attivatori funzionano correttamente. Puoi scegliere tra:

• Vai a LookML: apre il file della vista in cui è definita la PDT se disponi delle autorizzazioni appropriate per visualizzare LookML.
• Dashboard attività PDT: apre la dashboard Attività diPDT, filtrata in modo da mostrare l'attività per la PDT selezionata nelle ultime quattro settimane.
• Dettagli PDT: si apre un popup contenente ulteriori informazioni e statistiche per un determinato PDT. Per ulteriori informazioni, consulta la sezione Finestra modale dei dettagli del PDT in questa pagina.

Per suggerimenti sulla risoluzione dei problemi, consulta la sezione Monitoraggio e risoluzione dei problemi relativi alle PDT nella pagina della documentazione Tabelle derivate in Looker della documentazione.

Modale dettagli PDT

Fai clic sull'opzione Dettagli PDT nel menu con tre puntini Opzioni della PDT per visualizzare la finestra modale dei dettagli della PDT.

Le informazioni nella finestra modale dipendono dalla configurazione della PDT. Ecco le informazioni che potresti vedere:

• Nome tabella: l'hash dell'ultima PDT creata correttamente.
• Modello: il nome del file del modello in cui è incluso il file della vista del PDT.
• Nome stabile: il nome della visualizzazione del database stabile del set di dati protetto nel tuo database, se il set di dati protetto è stato pubblicato come visualizzazione stabile. Puoi pubblicare una PDT come vista stabile nel tuo database aggiungendo l'istruzione publish_as_db_view: yes alla tabella derivata o utilizzando l'istruzione materialized_view: yes per trasformare la tabella derivata in una vista materializzata.
• Connessione: il nome della connessione su cui è abilitata la PDT.
• Old Build: un valore booleano che visualizza Yes se una build è una vecchia build PDT, o No in caso contrario.
  • Tipo di tabella: per le build precedenti, questo campo viene visualizzato e mostra il tipo di tabella. I valori includono Tabella di generazione precedente e Standin.
• PDT incrementale: un valore booleano che mostra Sì se una PDT è una PDT incrementale o No in caso contrario.
• Stato: indica lo stato dell'ultimo tentativo. Per le build non riuscite, fornisce un messaggio di errore SQL e un link al codice LookML del modello se l'utente dispone delle autorizzazioni appropriate per visualizzare il codice LookML.
• Dipendenze: fai clic sul pulsante Mostra grafico delle dipendenze per visualizzare un diagramma delle relazioni di tutte le tabelle derivate su cui si basa questa PDT. Ogni nodo del diagramma corrisponde a una tabella derivata. Il colore di ogni nodo corrisponde allo stato della tabella derivata, come segue:
  • Un nodo verde rappresenta una PDT creata correttamente.
  • Un nodo giallo rappresenta una PDT in fase di creazione o incremento.
  • Un nodo rosso rappresenta una PDT di cui non è stata completata la compilazione.
  • Un nodo grigio rappresenta una PDT non ancora creata.
  • Un nodo bianco rappresenta una tabella derivata temporanea, che non viene creata da Looker.
• Ultima build:
  • Ultima build riuscita: la data e l'ora dell'ultima build di PDT riuscita.
  • Durata build più recente: la durata della build PDT più recente (in secondi; visualizza - se la tabella non è stata ancora creata).
  • Durata media build: il tempo necessario per creare la PDT in media (in secondi; viene visualizzato – se la tabella non è ancora stata creata).
  • Motivo della compilazione: il motivo per cui è stata creata una PDT (inception per una compilazione iniziale; datagroup triggered se la PDT è persistente con un gruppo di dati; trigger value change se il valore dell'attivatore SQL della PDT è cambiato).
  • Increment Key (Chiave di incremento): il parametro increment_key per le PDT che utilizzano build incrementali.
  • Increment Offset: il parametro increment_offset per le PDT che utilizzano build incrementali.
  • Incremento delle righe aggiunte/rimosse: il numero di righe aggiunte o rimosse dalla tabella al momento dell'ultimo incremento della tabella (viene visualizzato – se non sono state aggiunte o rimosse righe quando la strategia di persistenza della tabella ha attivato l'ultima volta un incremento).
  • SQL ultimo tentativo: il codice SQL utilizzato per eseguire query sul database per creare l'ultima compilazione della tabella.
• Regola di persistenza:
  • Tipo: il tipo di persistenza utilizzato dalla tabella. Consulta la sezione Colonna Regola di persistenza di questa pagina per conoscere i possibili valori.
  • Persist per: per le PDT di tipo Persist, il valore della durata di persistenza. Non applicabile per le PDT di tipo Trigger.
  • Gruppo di dati: per le PDT attivate dal gruppo di dati, indica il nome del gruppo di dati.
  • Blocco di codice SQL: per le PDT con trigger SQL e per gruppo di dati, il blocco di codice mostrerà l'istruzione SQL del trigger. Per gli attivatori di gruppi di dati, si tratta del codice SQL per il parametro sql_trigger del gruppo di dati. Per i trigger SQL, si tratta dell'SQL per il parametro sql_trigger_value.
  • Valore trigger: per le PDT di tipo Trigger, il valore che ha attivato la compilazione della PDT (viene visualizzato – per le PDT create correttamente e rese permanenti con un datagroup_trigger; per visualizzare il valore trigger più recente per un gruppo di dati, consulta la pagina Gruppi di dati nel riquadro Amministrazione).
  • Ultimo controllo: per le PDT di tipo Trigger, quando è stato controllato il valore dell'attivatore l'ultima volta.
  • Scade: la data di scadenza della PDT, se applicabile (non applicabile per gli attivatori dei gruppi di dati).

Dashboard dell'attività PDT

La dashboard Attività PDT mostra informazioni sulla PDT, sulle sue ricostruzioni e sulle sue query.

Per impostazione predefinita, la dashboard Attività PDT mostra le informazioni sulle attività delle quattro settimane precedenti. Puoi modificare il periodo di tempo visualizzato utilizzando la barra dei filtri nella parte superiore della dashboard. La dashboard Attività PST include riquadri che mostrano le seguenti informazioni:

• Un riepilogo della PDT che include il nome del modello e la vista LookML che definiscono la PDT, il nome della connessione al database utilizzata dalla PDT, il numero totale di tentativi di build riusciti e non riusciti della PDT e la percentuale di tentativi di build totali non riusciti.
• La data e l'ora della più recente ricompilazione completa della PDT.
• Se la PDT è incrementale, la data e l'ora dell'ultima ricostruzione incrementale della PDT.
• Se la PDT è una PDT incrementale, il numero di ricostruzioni incrementali avvenute dall'ultima ricompilazione completa.
• Il tempo medio necessario per ricostruire il file PDT.
• Una visualizzazione che mostra tutti gli eventi di creazione avvenuti di recente, raggruppati in base a un riepilogo dei tipi di azioni che li hanno causati.
• Un elenco di tutte le ricreazioni di PDT avvenute durante il periodo di tempo della dashboard, che include la data di completamento di ciascuna ricompilazione, il numero di secondi necessari per completare ogni ricostruzione, se le ricompilazioni erano build incrementali, il trigger che ha causato ogni ricompilazione e il numero di build di PDT.
• Un elenco di tutti i tentativi di ricostruzione non riusciti, incluse la data e l'ora di inizio della ricostruzione non riuscita, il tipo di errore che ha causato il fallimento, il messaggio di errore e il numero di errori di creazione.
• Un elenco di tutti gli eventi degli attivatori di rigenerazione della PDT, inclusi il numero ID dell'evento, la data dell'evento, il tipo di evento e i dati inclusi nell'evento di trigger.
• Un elenco di tutti gli eventi di ricostruzione del PDT, inclusi il numero di ID evento, la data dell'evento, il tipo di evento e i dati inclusi nell'evento di ricostruzione.
• Il numero di query che hanno eseguito query direttamente su un campo, raggruppate in base all'origine della query e al tempo di esecuzione medio per ogni origine query.
• Il numero totale di query eseguite sulla PDT.
• Un elenco di tutti i campi PDT sottoposti a query, incluse la visualizzazione e il modello LookML in cui è definito il campo, il nome del campo, il nome dell'esecuzione dell'esplorazione che ha incluso il campo e il numero di volte in cui il campo è stato incluso in una query.

Modello di log eventi PDT

Looker include un modello predefinito denominato system_activity che consente di esplorare facilmente il log eventi delle PDT, ovvero una tabella nello schema temporaneo di una connessione di database che monitora l'attività di trigger e creazione delle PDT.

Puoi accedere al modello con i link Eventi di creazione recenti ed Eventi trigger recenti nel menu con tre puntini Opzioni della pagina Tabelle derivate permanenti o dalla pagina Connessioni nel riquadro Amministrazione di Looker.

Per accedere all'esplorazione del log eventi PDT dalla pagina Connessioni, seleziona l'opzione Mostra log eventi PDT dal menu a discesa con l'icona a forma di ingranaggio per ogni connessione.

Puoi esplorare il modello come qualsiasi altra esplorazione di Looker. Se accedi dalla pagina Connessioni, l'esplorazione Log eventi PDT viene filtrata per l'intera connessione. Se si accede dalla pagina Persistent Derived Tables (Tabelle derivate permanenti), l'esplorazione PDT Event Log viene filtrata in base a una PDT specifica.

Questa è una breve guida ai campi disponibili nell'esplorazione del log degli eventi PST:

Campo	Descrizione
Azione	Descrive l'azione che si è verificata, ad esempio attività di rigenerazione, abbandono, creazione e raccolta. Per saperne di più su come visualizzare e comprendere le azioni dei log delle PDT e i relativi dati sulle azioni, consulta la pagina Informazioni sulle azioni dei log delle PDT.
Dati azione	Fornisce dettagli più specifici su un'azione, inclusi il trigger utilizzato, il valore di un trigger, la data e l'ora di scadenza di una tabella persistente, la causa di una ricompilazione, il testo di un messaggio di errore e così via. Per saperne di più su come visualizzare e comprendere le azioni dei log delle PDT e i relativi dati sulle azioni, consulta la pagina Informazioni sulle azioni dei log delle PDT.
Connessione	Il nome della connessione in cui esiste la tabella derivata.
Hash	Ogni tabella derivata contiene un hash del codice SQL scritto per crearla.
ID	L'ID univoco dell'istanza di Looker che ha generato la PDT. In molti casi, esisterà una sola istanza di Looker che punta a un database, quindi vedrai un solo ID. Tuttavia, se hai un'istanza temporanea o qualcosa del genere, potresti vedere più ID.
Nome modello	Il nome del modello attraverso il quale è stata generata la tabella.
Data di occorrenza	La data e l'ora in cui si è verificato l'evento.
Occur Utc Display Date	La data e l'ora in cui si è verificato l'evento in UTC.
Sequenza	Un numero di passaggio nella build PDT.
Hash breve	Una versione troncata dell'hash dell'SQL scritto per creare la tabella derivata.
Nome tabella	Il nome completo della PDT, inclusi il prefisso del tipo di tabella, un hash e il nome della vista.
Meditazione	L'ID della transazione.
Visualizza nome	Il nome della vista della tabella derivata.