Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Questa pagina è stata tradotta dall'API Cloud Translation.

Impostazioni di amministrazione - 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 aiutare a monitorare il comportamento delle PDT e a risolvere i relativi problemi nella pagina Persistent Derived Tables (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 delle PDT, consulta la pagina della documentazione Tabelle derivate in Looker.

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

La PDT 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 PDT fa parte di un modello configurato correttamente.
La PDT 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 Modello di log eventi PPD di 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:

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.
Digita le parole chiave nella casella di ricerca per restringere l'elenco PDT alle PDT i cui nomi includono la parola chiave. La tabella mostra le PDT con il termine di ricerca corrispondente in grassetto. Fai clic sulla X nella barra di ricerca per cancellare i termini di ricerca.
Fai clic sull'icona Filtri per definire un filtro per la tabella.
Fai clic sull'icona di chiusura/apertura per visualizzare o nascondere la sezione Riepilogo.
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.
Fai clic sull'icona Seleziona colonne da visualizzare per nascondere o visualizzare le colonne della tabella.
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.

Applicazione dei filtri

Puoi utilizzare l'icona Filtri accanto alla barra di ricerca per scegliere le PDT da visualizzare nella pagina Tabelle derivate permanenti. Ad esempio, puoi filtrare per Stato ultima build per visualizzare solo le PDT in cui si verifica un errore di build oppure puoi filtrare per Modello per limitare le PDT mostrate a un modello specifico.

Per filtrare la pagina Tabelle derivate permanenti:

Fai clic sull'icona Filtri .
Seleziona un'opzione di filtro dal primo selettore di filtro nel menu del filtro. Sono disponibili le seguenti opzioni:
- Senza trigger nell'ultima: filtra la pagina Tabelle derivate permanenti in base a PDT che non sono state attivate in un numero di ore e minuti specificato.
- Attivate nell'ultima: 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 model 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 di 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 che non sono state 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.
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.
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.
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 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:

Per impostazione predefinita, la scheda Produzione mostra le PDT di produzione. Queste sono le PDT di cui è stato eseguito il deployment in produzione nella tua istanza. Queste PDT forniscono i dati per le query di esplorazione degli utenti. Se sei in modalità Produzione o se non disponi delle autorizzazioni develop, nella pagina Tabelle derivate permanenti non verranno visualizzate schede e verranno mostrate informazioni solo per le PDT di produzione.
La scheda Sviluppo mostra le PDL 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 ha creato 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 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 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 PDT.

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 (Nome PDT) mostra il nome della PDT come definito nel parametro view del file di vista LookML della PDT.

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, visualizza il popup Dettagli PST nel menu Opzioni.
Incrementale indica che la PDT è una PDT incrementale.
La vista materializzata indica che la PDT è una vista materializzata del 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 non è stata creata una PDT.
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 accedere al LookML della PDT se disponi delle autorizzazioni appropriate per visualizzare il LookML. 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 la data e l'ora dell'ultima build PDT riuscita.

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 inoltre l'ultima volta che è stata verificata una PDT creata correttamente (per le PDT di tipo trigger) o la 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.
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 PDT.

Connessione

Se selezioni All Connections (Tutte le connessioni) nella selezione della connessione, viene visualizzata la colonna Connection (Connessione) che mostra il nome della connection su cui è abilitata la PDT.

Modello

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

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:

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 PST: apre un popup contenente ulteriori informazioni e statistiche per una PDT specifica. Per saperne di più, consulta la sezione Dati modale dei dettagli della data di pubblicazione (PDT) di 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 di vista della PDT.
Nome stabile: il nome della vista database stabile della PDT sul tuo database, se la PDT è stata pubblicata come vista 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 rendere la tabella derivata una vista materializzata.
Connessione: il nome della connessione su cui è abilitata la PDT.
Old Build: un valore booleano che mostra Yes se una build è una vecchia build PDT, 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 PDT è 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 PDT 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 PDT creata correttamente.
- Un nodo giallo rappresenta una PDT in fase di creazione o incremento.
- Un nodo rosso rappresenta una PDT che non è stato possibile creare.
- 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: tempo medio necessario per creare la PDT (in secondi; visualizza - se la tabella non è stata ancora creata).
- Motivo build: il motivo per cui è stata creata una PDT (avvio per una build iniziale; gruppo di dati attivato se la PDT è persistente con un gruppo di dati; modifica del valore dell'attivatore se il valore del trigger SQL della PDT è cambiato).
- Chiave di aumento: 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).
- Ultimo tentativo SQL: l'SQL utilizzato per eseguire 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 PDT di tipo Persist, il valore della durata di persistenza. Non applicabile per le PDT di tipo Trigger.
- Gruppo di dati: per le PDT dei trigger del gruppo di dati, specifica 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 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 PDT di tipo Trigger, il valore che ha attivato la build delle PDT (viene visualizzato - per le PDT create correttamente e persistenti con un datagroup_trigger; per visualizzare il valore del 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: quando scade la PDT, se applicabile (non applicabile per gli attivatori dei gruppi di dati).

Dashboard attività PDT

La dashboard PDT Activity mostra informazioni sulla PDT, sulle relative ricostruzioni e sulle 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à diPDT include riquadri che mostrano le seguenti informazioni:

Un riepilogo della PDT che include il nome del modello LookML e la vista 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 è una PDT incrementale, la data e l'ora della più recente ricompilazione incrementale della PDT.
Se la PDT è una PDT incrementale, il numero di ricostruzioni incrementali avvenute dall'ultima ricompilazione completa.
Il tempo medio impiegato per ricreare la PDT.
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 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 incrementali, il trigger che ha causato ogni ricompilazione e il numero di build di PDT.
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 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 per la rigenerazione della PDT, inclusi il numero ID dell'evento, la data dell'evento, il tipo di evento e i dati inclusi nell'evento.
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, 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.

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 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 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; 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 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 che è stato scritto per crearla.
ID	L'ID univoco dell'istanza di Looker che ha generato la PDT. 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 modello	Il nome del modello attraverso il quale è stata generata la tabella.
Data occorrenza	La data e l'ora in cui si è verificato l'evento.
Data di visualizzazione Utc	La data e l'ora in cui si è verificato l'evento nel fuso orario 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.