Impostazioni amministratore - Tabelle derivate permanenti

La pagina di amministrazione Tabelle derivate permanenti di Looker mostra lo stato delle tabelle persistenti dell'istanza di Looker (che includono sia le tabelle derivate permanenti sia le tabelle aggregate.

La pagina di amministrazione delle tabelle derivate permanenti mostra diverse funzionalità di amministrazione che possono aiutare a monitorare il comportamento delle tabelle persistenti e a risolvere i relativi problemi. Per informazioni sulla risoluzione dei problemi delle tabelle permanenti, consulta la pagina della documentazione Tabelle derivate in Looker.

Gli amministratori e gli utenti di Looker con l'autorizzazione see_pdts possono accedere alla pagina Tabelle derivate permanenti.

Per aprire la pagina Tabelle derivate permanenti, segui questi passaggi:

  1. Fai clic sull'icona del menu principale di Looker e seleziona Admin (Amministrazione) se il menu Admin (Amministrazione) non è già visualizzato. (se ti trovi nella sezione Esplora o Sviluppo del menu principale di Looker, potresti dover fare clic sulla Freccia indietro per visualizzare il menu Amministratore.)
  2. Dal menu Amministrazione, seleziona Tabelle derivate permanenti.

La pagina Tabelle derivate permanenti mostra solo le connessioni abilitate per le PDT e solo le tabelle persistenti che soddisfano i seguenti criteri:

  • La tabella persistente viene definita in un file di visualizzazione in produzione, a meno che non ti trovi in modalità di sviluppo. In questo caso, puoi utilizzare la scheda Sviluppo per visualizzare la versione di sviluppo delle tabelle persistenti.
  • La tabella persistente fa parte di un modello configurato correttamente.
  • La tabella persistente fa parte di un modello per il quale hai accesso ai dati.

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

Personalizzazione della tabella

Per impostazione predefinita, la pagina Tabelle derivate permanenti mostra un massimo di 25 tabelle permanenti e carica le tabelle persistenti 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. Per visualizzare le tabelle persistenti solo da una connessione specifica, fai clic sulla freccia accanto a Tutte le connessioni, quindi seleziona il nome della connessione specifica. Il selettore mostra solo le connessioni abilitate per le PDT e per le quali hai accesso ai dati.
  2. Inserisci le parole chiave nella casella di ricerca per restringere l'elenco delle tabelle persistenti alle tabelle persistenti i cui nomi includono la parola chiave. La tabella mostra le tabelle persistenti con il termine di ricerca corrispondente in grassetto. Fai clic sulla X nella barra di ricerca per cancellare i termini 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 sul nome della colonna una seconda volta 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 singola 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 tabelle persistenti mostrare nella pagina Tabelle derivate permanenti. Ad esempio, puoi filtrare per Stato ultima build per visualizzare solo le tabelle persistenti in cui si è verificato un errore di generazione oppure puoi filtrare per Modello per limitare le tabelle persistenti mostrate a un modello specifico.

Per filtrare la pagina Tabelle derivate permanenti, segui questi passaggi:

  1. Fai clic sull'icona Filtri .
  2. Seleziona un'opzione di filtro dal primo selettore di filtro nel menu del filtro. Sono disponibili le seguenti opzioni:
    • Senza attivazione nelle ultime: filtra la pagina Tabelle derivate permanenti in base a tabelle persistenti che non sono state attivate in un numero di ore e minuti specificato.
    • Attivato nell'ultimo: filtra la pagina Tabelle derivate permanenti in base a tabelle persistenti che sono state attivate in un numero specificato di ore e minuti.
    • Modello: filtra la pagina Tabelle derivate permanenti per visualizzare le tabelle persistenti incluse in un modello specificato.
    • Regola di persistenza: filtra la pagina Persistent Derived Tables (Tabelle derivate permanenti) per tipo di persistenza.
    • Stato ultimo tentativo: filtra la pagina Tabelle derivate permanenti in base a uno stato specificato per la tabella persistente.
    • Pubblicato come vista stabile: un valore booleano che filtra la pagina Tabelle derivate persistenti per le tabelle persistenti e visualizza per le tabelle persistenti pubblicate come vista stabile e No per le tabelle persistenti non pubblicate come vista stabile, come determinato dal valore del parametro publish_as_db_view.
    • Durata dell'ultima build più lunga di: filtra la pagina Tabelle derivate permanenti in base a tabelle persistenti le cui build hanno richiesto più di un numero di secondi specificato.
    • Progetto: filtra la pagina Tabelle derivate permanenti in base alle tabelle persistenti del progetto LookML specificato.
  3. Scegli il valore in base al quale filtrare la pagina Tabelle derivate permanenti nel secondo selettore di filtro. 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 ciascun filtro che stai aggiungendo.
    • 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.

Informazioni sulla pagina Tabelle derivate permanenti

Le seguenti sezioni 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 le tabelle persistenti di produzione. Si tratta delle tabelle persistenti di cui è stato eseguito il deployment nell'istanza di produzione nell'istanza e forniscono i dati per le query di esplorazione degli utenti. Se sei in modalità Produzione o se non hai le autorizzazioni develop, la pagina Tabelle derivate permanenti non mostrerà alcuna scheda e mostrerà le informazioni solo per le tabelle persistenti di produzione.

  • La scheda Sviluppo mostra le tabelle persistenti di sviluppo. Le tabelle persistenti di sviluppo non sono ancora state inviate nell'ambiente di produzione.

Looker crea una tabella persistente di sviluppo quando uno sviluppatore LookML in modalità di sviluppo apporta modifiche che influiscono sui dati nella tabella persistente o sul modo in cui vengono eseguite query sulla tabella persistente. Queste modifiche richiedono a Looker di creare la tabella persistente di sviluppo, ma Looker di fatto non crea la tabella persistente a meno che non vengano eseguite query sulla tabella persistente dopo le modifiche. La scheda Sviluppo può aiutarti a determinare quali tabelle di sviluppo persistenti sono state create da Looker e se sono state create.

Consulta la pagina della documentazione Tabelle derivate in Looker per saperne di più su cosa richiede a Looker di creare tabelle permanenti di sviluppo e per quanto tempo le tabelle di sviluppo persistenti rimangono nel database.

Sezione Riepilogo

La sezione Riepilogo mostra un riepilogo visivo dello stato delle tabelle persistenti visualizzate nella tabella persistente. Se hai definito i 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 restringe i risultati in modo che corrispondano a quanto visualizzato nella tabella della tabella persistente.

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

Colonne della tabella

Le seguenti sezioni 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 PDT Name mostra il nome della tabella persistente come definito nel parametro view del file di vista LookML della tabella persistente.

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

  • Old Build indica che la riga mostra informazioni su una vecchia build di tabella persistente. Per ulteriori informazioni su questo messaggio, consulta la finestra di dialogo Dettagli PST nel menu Opzioni.
  • Incrementale indica che la tabella persistente è una PDT incrementale.
  • Vista materializzata indica che la tabella persistente è una vista materializzata del tuo database.

Stato ultimo tentativo

La colonna Stato ultimo tentativo mostra lo stato dell'ultimo tentativo di creare ciascuna tabella persistente elencata:

  • La rigenerazione indica che è possibile eseguire query sulla tabella persistente e che è in corso la creazione di una tabella aggiornata. Un timestamp indica quando è iniziata la creazione della tabella persistente.
  • Operazione riuscita indica che una tabella persistente è stata creata correttamente.
  • Creazione indica che è in corso la creazione di una tabella persistente e non è possibile eseguire query fino al completamento della build.
  • Non creata indica che non è stata creata una tabella persistente.
  • Errore di build indica che si è verificato un errore durante una build. Puoi fare clic su Errore di build per visualizzare l'origine dell'errore e passare al LookML della tabella persistente se disponi delle autorizzazioni appropriate per visualizzare il LookML. Consulta la sezione del menu Opzioni in questa pagina per scoprire di più sulla risoluzione dei problemi delle tabelle persistenti nella pagina Tabelle derivate permanenti.

Ultimo tentativo alle ore

La colonna Ultimo tentativo alle indica l'ora dell'ultimo tentativo di creazione della tabella persistente.

Ultima build riuscita

La colonna Ultima build riuscita indica la data e l'ora dell'ultima creazione di una tabella persistente riuscita.

Durata ultima build

La colonna Durata ultima build mostra la quantità di tempo in secondi impiegata per l'ultima build di quella tabella persistente e quanto tempo è necessario per crearla in media in secondi.

Regola di persistenza

La colonna Regola di persistenza mostra il tipo di persistenza applicato a una tabella persistente, come specificato nella definizione LookML della tabella persistente. Indica inoltre l'ultima volta che è stata controllata una tabella persistente creata correttamente (per le tabelle persistenti di tipo trigger) o quando è prevista la scadenza di una tabella persistente creata correttamente (per le tabelle persistenti di tipo persistente). Nella colonna Regola di persistenza sono visualizzati due tipi di persistenza:

  • L'opzione Persist per: (time) viene visualizzata per le tabelle persistenti con il parametro persist_for.
  • Trigger: (nome gruppo di dati) viene visualizzato per le tabelle 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 tabelle persistenti con un parametro sql_trigger_value. Puoi fare clic sul link per visualizzare l'istruzione sql_trigger_value.
  • La 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 tabella persistente.

Connessione

Se selezioni Tutte le connessioni nella selezione della connessione, viene visualizzata la colonna Connessione con il nome della connessione su cui è abilitata la tabella persistente.

Modello

La colonna Modello mostra il nome del file del modello associato alla tabella persistente. Per una PDT, si tratta in genere del file del modello che include il file di vista in cui è definita la PDT. Per una tabella aggregata, si tratta in genere del file del modello in cui è definita la tabella aggregata.

Menu Opzioni

Il menu Opzioni con tre puntini è particolarmente utile per la risoluzione dei problemi relativi a comportamenti imprevisti. Le opzioni presentate ti consentono di verificare quando sono state create le tabelle, controllare quanto tempo è stato necessario per crearle, confrontare la durata della build più recente con quella media e verificare se gli attivatori funzionano correttamente. Puoi scegliere tra:

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 PST nel menu Opzioni con tre puntini della tabella persistente per visualizzare la finestra modale dei dettagli della PDT.

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

  • Nome tabella: l'hash dell'ultima tabella persistente creata correttamente.
  • Modello: il nome del file del modello in cui è incluso il file di visualizzazione della tabella persistente.
  • Nome stabile: il nome della vista stabile del database della tabella persistente sul tuo database, se la tabella persistente è stata pubblicata come vista stabile. Puoi pubblicare una tabella persistente come vista stabile sul tuo database aggiungendo l'istruzione publish_as_db_view: yes alla tabella PDT o alla tabella aggregata oppure utilizzando l'istruzione materialized_view: yes per rendere la tabella derivata una vista materializzata.
  • Connessione: il nome della connessione su cui è abilitata la tabella persistente.
  • Old Build: un valore booleano che visualizza Yes se una build è una vecchia build di tabella persistente 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 Yes se una tabella persistente è una PDT incrementale o No in caso contrario.
  • Stato: fornisce lo stato dell'ultimo tentativo. Per le build non riuscite, fornisce un messaggio di errore SQL e un link al LookML del modello se l'utente dispone delle autorizzazioni appropriate per visualizzare il LookML.
  • Dipendenze: fai clic sul pulsante Mostra grafico delle dipendenze per visualizzare un diagramma delle relazioni di tutte le tabelle derivate da cui la tabella persistente dipende. Ogni nodo nel diagramma corrisponde a una tabella derivata. Il colore di ciascun nodo corrisponde allo stato della tabella derivata, come segue:
    • Un nodo verde rappresenta una tabella persistente creata correttamente.
    • Un nodo giallo rappresenta una tabella persistente in fase di creazione o incremento.
    • Un nodo rosso rappresenta una tabella persistente che non è stato possibile creare.
    • Un nodo grigio rappresenta una tabella persistente 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 riuscita della tabella persistente.
    • Durata build più recente: tempo impiegato per la creazione della tabella persistente più recente (in secondi; visualizza - se la tabella non è stata ancora creata).
    • Durata media build: tempo medio necessario per creare una tabella persistente (in secondi; visualizza - se la tabella non è stata ancora creata).
    • Motivo build: il motivo per cui è stata creata una tabella persistente (inizio per una build iniziale; datagroup attivato se la tabella persistente è persistente con un gruppo di dati; modifica del valore del trigger se il valore del trigger SQL della tabella persistente è cambiato).
    • Chiave di aumento: il parametro increment_key per le tabelle persistenti che utilizzano build incrementali.
    • Offset incremento: il parametro increment_offset per le tabelle persistenti 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).
    • Ultimo tentativo SQL: l'SQL utilizzato per eseguire una query sul database per creare l'ultima build 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 tabelle persistenti di tipo Persist, il valore della durata di persistenza. Non applicabile per le tabelle persistenti di tipo Trigger.
    • Gruppo di dati: per le tabelle persistenti con trigger del gruppo di dati, specifica il nome del gruppo di dati.
    • Blocco di codice SQL: per le tabelle persistenti di tipo SQL e gruppo di dati, il blocco di codice mostrerà l'istruzione SQL del trigger. Per i trigger gruppo di dati, si tratta dell'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 tabelle persistenti di tipo Trigger, il valore che ha attivato la build della tabella persistente (visualizza per le tabelle persistenti create correttamente e rese persistenti con datagroup_trigger; per visualizzare il valore trigger più recente per un gruppo di dati, consulta la pagina Gruppi di dati nel pannello Amministrazione).
    • Ultimo controllo: per le tabelle persistenti di tipo Trigger, indica la data dell'ultima verifica del valore del trigger.
    • Scadenza: quando scade la tabella persistente, se applicabile (non applicabile per gli attivatori dei gruppi di dati).

Dashboard attività PDT

La dashboard PDT Activity mostra informazioni sulla tabella persistente, sulle relative ricreazioni e sulle relative query.

Per impostazione predefinita, la dashboard Attività PST 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 tabella persistente che include il nome del modello LookML e della vista che definiscono la tabella persistente, il nome della connessione al database utilizzata dalla tabella persistente, il numero totale dei tentativi di build riusciti e non riusciti della tabella persistente e la percentuale di tentativi di build totali non riusciti.
  • La data e l'ora della più recente ricompilazione completa della tabella persistente.
  • Se la tabella persistente è una PDT incrementale, la data e l'ora della più recente ricompilazione incrementale della PDT.
  • Se la tabella persistente è una PDT incrementale, il numero di ricostruzioni incrementali che si sono verificate dopo la ricompilazione completa più recente.
  • Il tempo medio necessario per ricreare la tabella persistente.
  • Una visualizzazione che mostra tutti gli eventi di creazione che si sono verificati di recente, raggruppati in base a un riepilogo dei tipi di azioni che hanno causato gli eventi.
  • Un elenco di tutte le ricreazioni delle tabelle persistenti che si sono verificate durante il periodo di tempo della dashboard, incluso la data di completamento di ciascuna ricompilazione, il numero di secondi necessari per completare ogni ricreazione, se le ricompilazioni erano build incrementali, il trigger che ha causato ogni ricompilazione e il numero di build di tabelle persistenti.
  • Un elenco di tutti i tentativi di rigenerazione non riusciti, inclusi la data e l'ora di inizio della rigenerazione non riuscita, il tipo di errore che ha causato l'errore, il messaggio di errore e il numero di errori di creazione.
  • Un elenco di tutti gli eventi di trigger di rigenerazione della tabella persistente, inclusi il numero ID evento, la data dell'evento, il tipo di evento e i dati inclusi nell'evento del trigger.
  • Un elenco di tutti gli eventi per la ricreazione della tabella persistente, inclusi il numero ID dell'evento, la data dell'evento, il tipo di evento e i dati inclusi nell'evento di ricreazione.
  • 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 nella tabella persistente.
  • Un elenco di tutti i campi della tabella persistenti sottoposti a query, inclusi la vista 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.

Esplora log eventi PDT

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

Puoi accedere al modello tramite i link Eventi di build recenti ed Eventi di trigger recenti nel menu a tre punti Opzioni della pagina Tabelle derivate persistenti oppure dalla pagina Connessioni nel pannello Amministrazione di Looker.

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

Puoi esplorare il modello come qualsiasi altra esplorazione di Looker. Se si accede dalla pagina Connessioni, l'esplorazione del log degli eventi PTP viene filtrata per l'intera connessione. Se si accede dalla pagina Persistent Derived Tables (Tabelle derivate permanenti), l'esplorazione del log eventi PST viene filtrata in base a una tabella persistente specifica.

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

CampoDescrizione
AzioneDescrive l'azione che si è verificata; può includere rigenerazione, caduta, creazione e attività di 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 azioneFornisce 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 e il testo di un messaggio di errore.

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.
ConnessioneIl nome della connessione in cui esiste la tabella derivata.
HashOgni tabella derivata contiene un hash del codice SQL che è stato scritto per crearla.
IDL'ID univoco dell'istanza di Looker che ha generato la tabella persistente. In molti casi, sarà presente 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 modelloIl nome del modello attraverso il quale è stata generata la tabella.
Data di occorrenzaLa data e l'ora in cui si è verificato l'evento.
Data di visualizzazione UtcLa data e l'ora in cui si è verificato l'evento nel fuso orario UTC.
SequenzaUn numero di passaggio nella build della tabella persistente.
Hash breveUna versione troncata dell'hash dell'SQL scritto per creare la tabella derivata.
Nome tabellaIl nome completo della tabella persistente, inclusi il prefisso del tipo di tabella, un hash e il nome della vista.
MeditazioneL'ID della transazione.
Visualizza nomeIl nome della vista della tabella derivata.