Impostazioni amministratore - Tabelle derivate permanenti

Le funzioni delle tabelle derivate permanenti (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.

Nota: per accedere a tutte le pagine di amministrazione di Looker, devi disporre del ruolo Amministratore. Se disponi di un'autorizzazione che attiva solo alcune parti del riquadro Amministrazione, ad esempio manage_schedules o manage_themes, ma non disponi del ruolo Amministratore, Looker potrebbe non visualizzare la pagina o le pagine descritte in questo articolo nel riquadro Amministrazione. Inoltre, l'autorizzazione see_admin concede l'autorizzazione di sola lettura alla maggior parte (ma non a tutte) delle pagine Amministrazione. Per saperne di più, consulta la descrizione di see_admin.

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.
• Il PDT fa parte di un modello configurato correttamente.
• Il PDT fa parte di un modello per cui hai 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 tabelle derivate permanenti e carica le tabelle derivate permanenti per tutte le connessioni per cui disponi dell'accesso ai dati nell'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 per cui sono abilitati i dati proprietari e a cui 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 le colonne da visualizzare per nascondere o mostrare le colonne nella 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 Tabelle derivate permanenti in base alle PDT incluse in un modello specificato.
   • Regola di permanenza: filtra la pagina Tabelle derivate permanenti in base al tipo di permanenza delle PDT.
   • Stato ultimo tentativo: filtra la pagina Tabelle derivate permanenti in base a uno stato della PDT specificato.
   • Pubblicata come visualizzazione stabile: un valore booleano che filtra la pagina Tabelle derivate permanenti in base alle PDT e mostra Sì per le PDT pubblicate come visualizzazione stabile e No per le PDT non pubblicate come visualizzazione stabile, in base al valore parametro publish_as_db_view.
   • Durata dell'ultima build superiore a: filtra la pagina Tabelle derivate permanenti in base alle PDT le cui build hanno richiesto più di un numero specificato di secondi.
   • Progetto: filtra la pagina Tabelle derivate permanenti 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 dei filtri. Per le opzioni Non attivato nell'ultimo o Attivato nell'ultimo, inserisci un numero di ore o minuti. Per l'opzione Durata dell'ultima build superiore a, 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 le selezioni dei filtri 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 vengono 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.

Informazioni sulla 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 Tabelle derivate permanenti avrà due schede:

• La scheda Produzione è selezionata per impostazione predefinita e mostra i PDC di produzione. Si tratta dei PDT di cui è stato eseguito il deployment in produzione nella tua istanza. Questi PDT 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. I file PDT di sviluppo non sono ancora stati inviati 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 portano Looker a creare la PDT di sviluppo, ma Looker non la genera effettivamente a meno che non venga eseguita una query sulla PDT dopo 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.

Per ulteriori informazioni su cosa spinge Looker a creare PDT di sviluppo e per quanto tempo queste vengono mantenute nel database, consulta la pagina della documentazione dedicata alle tabelle derivate in Looker.

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 le colonne da visualizzare per nascondere o visualizzare alcune delle 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 di previsione (PDT) come definito nel parametro view del file della visualizzazione LookML del report di dati di previsione.

La colonna Nome PDT mostra queste informazioni aggiuntive sotto il nome del PDT, se applicabile:

• Build precedente indica che la riga mostra informazioni su una build PDT precedente. Per ulteriori informazioni su questo messaggio, consulta il popup Dettagli PDT 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 compilazione di ogni PDT elencato:

• In fase di rigenerazione indica che è possibile eseguire query sulla PDT e che è in corso la creazione di una tabella aggiornata. Un timestamp indica quando è iniziata la compilazione del report PDT.
• Success indica che una PDT è stata creata correttamente.
• In fase di compilazione indica che una PDT è attualmente in fase di compilazione e non può essere sottoposta a query finché la compilazione non è completata.
• 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 di questa pagina per scoprire di più sulla risoluzione dei problemi relativi alle PDT dalla pagina Tabelle derivate permanenti.

Ultimo tentativo alle ore

La colonna Ultimo tentativo indica l'ora dell'ultimo tentativo di compilazione del report 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 il tempo in secondi necessario per l'ultima build della PDT e il tempo necessario per compilare la PDT in media in secondi.

Regola di persistenza

La colonna Regola di persistenza mostra il tipo di persistenza applicata a un PDT, come definito nel file di visualizzazione del 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:

• Mantieni per: (ora) viene visualizzato per le PDT che vengono mantenute con il parametro persist_for.
• 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 i dati 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 è definito il 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 del PDT.

Nota: se un file di visualizzazione 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 quando si includono i file delle viste nei modelli, poiché l'inclusione di tutti i file delle viste potrebbe ingombrare lo schema del database e causare la creazione di più copie dei PDT nel database o in 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 il codice LookML.
• Dashboard dell'attività PDT: apre la dashboard dell'attività PDT, filtrata in modo da mostrare l'attività per il PDT selezionato 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 tabelle PDT nella pagina della documentazione Tabelle derivate in Looker.

Finestra modale dei dettagli della PDT

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

Le informazioni nel popup dipendono dalla configurazione del PDT. Di seguito sono riportate le informazioni che potresti visualizzare:

• 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 PDT nel tuo database, se il PDT è 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 è attivato il PDT.
• Build precedente: un valore booleano che mostra Sì se una build è una build PDT precedente 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 Sostituto.
• 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 che è stata 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 PDT riuscita.
  • Durata ultima compilazione: il tempo impiegato per la compilazione PDT più recente (in secondi; viene visualizzato – se la tabella non è ancora stata compilata).
  • 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 le build incrementali.
  • Righe aggiunte/rimosse dalla build incrementale: il numero di righe aggiunte o rimosse dalla tabella quando è stata incrementata l'ultima volta (viene visualizzato – se non sono state aggiunte o rimosse righe quando la strategia di persistenza della tabella ha attivato l'ultimo incremento).
  • SQL dell'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. Per i possibili valori, consulta la sezione della colonna Regola di persistenza in questa pagina.
  • Persistenza: per le PDT di tipo Persistenza, il valore della durata della persistenza. Non applicabile alle tabelle 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 i set di dati di tipo gruppo di dati e trigger SQL, il blocco di codice mostrerà l'istruzione SQL dell'attivatore. Per gli attivatori di gruppi di dati, si tratta del codice SQL per il parametro sql_trigger del gruppo di dati. Per gli attivatori SQL, questo è il codice 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).
  • Ultima verifica: per le PDT di tipo Trigger, l'ultima volta che è stato controllato il valore dell'attivatore.
  • 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à PDT include riquadri che mostrano le seguenti informazioni:

• Un riepilogo della PDT che include il nome del modello e della vista LookML che definiscono la PDT, il nome della connessione al database utilizzata dalla PDT, il numero totale di tentativi di compilazione riusciti e non riusciti della PDT e la percentuale di tentativi di compilazione totali non riusciti.
• La data e l'ora dell'ultima ricostruzione completa della PDT.
• Se la PDT è incrementale, la data e l'ora della ricostruzione incrementale più recente della PDT.
• Se la PDT è incrementale, il numero di ricostruzioni incrementali avvenute dall'ultima ricostruzione 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 ricostruzioni del PDT avvenute durante il periodo di tempo della dashboard, inclusa la data di completamento di ogni ricostruzione, il numero di secondi necessari per completare ogni ricostruzione, se le ricostruzioni erano incrementali, l'attivatore che ha causato ogni ricostruzione e il numero di ricostruzioni del 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 di attivazione della ricostruzione del PDT, inclusi il numero ID evento, la data dell'evento, il tipo di evento e i dati inclusi nell'evento di attivazione.
• 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 nel PDT.
• Un elenco di tutti i campi PDT sottoposti a query, inclusi la visualizzazione e il modello LookML in cui è definito il campo, il nome del campo, il nome dell'esecuzione dell'esplorazione che includeva 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 PDT, ovvero una tabella nello schema temporaneo di una connessione al database che monitora l'attività di attivazione e compilazione dei report pianificati.

Puoi accedere al modello con i link Eventi di compilazione recenti e Eventi di attivazione 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 accedi dalla pagina Tabelle derivate permanenti, l'esplorazione Log eventi PDT viene filtrata in base a una PDT specifica.

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

Campo	Descrizione
Azione	Descrive l'azione che si è verificata, ad esempio attività di rigenerazione, abbandono, creazione e raccolta. Per ulteriori informazioni su come visualizzare e comprendere le azioni dei log PDT e i relativi dati di azione, consulta la pagina di documentazione Informazioni sulle azioni dei log PDT.
Dati azione	Fornisce dettagli più specifici su un'azione, tra cui l'attivatore utilizzato, il valore di un attivatore, la data e l'ora di scadenza di una tabella permanente, la causa di una ricostruzione, il testo di un messaggio di errore e così via. Per ulteriori informazioni su come visualizzare e comprendere le azioni dei log PDT e i relativi dati di azione, consulta la pagina di documentazione Informazioni sulle azioni dei log 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 il report 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 di staging o qualcosa di simile, potresti vedere più ID.
Nome modello	Il nome del modello tramite 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 compilazione del PDT.
Hash breve	Una versione troncata dell'hash dell'istruzione SQL scritta per creare la tabella derivata.
Nome tabella	Il nome completo del PDT, incluso il prefisso del tipo di tabella, un hash e il nome della visualizzazione.
Tid	L'ID transazione.
Visualizza nome	Il nome della vista per la tabella derivata.