Visualizza parametri

Una vista rappresenta una tabella di dati in Looker, indipendentemente dal fatto che la tabella sia nativa del database o sia stata creata utilizzando la funzionalità tabella derivata di Looker. Le viste vengono in genere dichiarate nei file di visualizzazione, con una vista per file.

All'interno di ogni vista sono presenti definizioni di campo, ognuna delle quali corrisponde in genere a una colonna della tabella sottostante o a un calcolo in Looker. Questi campi sono descritti nel riferimento ai campi, nel riferimento al tipo di dimensione e nel riferimento al tipo di misura.

In questa pagina sono descritte anche una serie di impostazioni a livello di visualizzazione.

Esempio di utilizzo

Passa il mouse sopra il nome di un parametro per visualizzarne una breve descrizione. Fai clic su un parametro per visitare la relativa pagina di riferimento. Quando un parametro può essere impostato su una delle diverse opzioni specifiche, il valore predefinito viene elencato per primo.

## STRUCTURAL PARAMETERS

include:"filename_or_pattern"
## Possibly more include declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

view: view_name {
  extension: required
  extends: [view_name, view_name, ...]

  (dimension | dimension_group | measure | filter):field_name{
    # Desired field parameters (described on Field Parameters page)
  }
  # Possibly more field declarations

  set: set_name{
    fields:[field_or_set, field_or_set, ...]
  }
  # Possibly more set declarations

  drill_fields: [field_or_set, field_or_set, ...]

  # DISPLAY PARAMETERS

  label: "desired label"
  fields_hidden_by_default: yes | no

  # FILTER PARAMETERS

  suggestions: yes | no

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;

  # DERIVED TABLE PARAMETERS

  derived_table: {
    cluster_keys: ["column_name", "column_name", ...]
    create_process: {
      sql_step:SQL query ;;
    }
    datagroup_trigger: datagroup_name
    distribution: "column_name"
    distribution_style: all | even
    explore_source: explore_name {
      # Desired subparameters (described on explore_source page)
    }
    increment_key: "column_name"
    increment_offset: N
    indexes: ["column_name", "column_name", ...]
    interval_trigger: "N (seconds | minutes | hours)"
    materialized_view: yes | no
    partition_keys: ["column_name", "column_name", ...]
    persist_for: "N (seconds | minutes | hours)"
    publish_as_db_view: yes | no
    sortkeys: ["column_name","column_name", ...]
    sql: SQL query ;;
    sql_create: {
      SQL query ;;
    }
    sql_trigger_value: SQL query ;;
    table_compression: GZIP | SNAPPY
    table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE
  }
}

## REFINEMENT PARAMETERS
view: +view_name {
  final: yes
}

Definizioni dei parametri

Nome parametro	Descrizione
Parametri strutturali
drill_fields (per visualizzazione)	Specifica l'elenco predefinito dei campi visualizzati quando vengono visualizzati in dettaglio le misure definite nella visualizzazione
extends (per visualizzazione)	Specifica le visualizzazioni che verranno estese da questa visualizzazione
extension (per visualizzazione)	Specifica che la visualizzazione richiede un'estensione e non può essere esposta agli utenti
include	Aggiunge file a una visualizzazione
test	Crea un test sui dati per verificare la logica del modello. Le impostazioni del progetto includono un'opzione per richiedere test dei dati. Se questa opzione è abilitata per un progetto, gli sviluppatori del progetto devono eseguire test sui dati prima di eseguire il deployment delle modifiche in produzione. Questo parametro ha i sottoparametri explore_source e assert.
set	Definisce un insieme di dimensioni e misure da utilizzare in altri parametri
view	Crea una vista
Parametri di visualizzazione
label (per visualizzazione)	Specifica come verrà visualizzato il nome della vista nel selettore campi
fields_hidden_by_default	Aggiunto il 21/12 Se impostato su yes, nasconde per impostazione predefinita tutti i campi nella visualizzazione. Utilizza il parametro hidden: no in un campo per visualizzarlo.
Parametri di filtro
suggestions (per visualizzazione)	Attiva o disattiva i suggerimenti per tutte le dimensioni in questa visualizzazione
Parametri di query
autogenerate_primary_keys (per visualizzazione)	Attiva o disattiva la generazione automatica della chiave primaria
required_access_grants (per visualizzazione)	Limita l'accesso alla visualizzazione solo agli utenti i cui valori degli attributi utente corrispondono alle concessioni di accesso
sql_table_name (per visualizzazione)	Modifica la tabella SQL su cui si basa una vista
Parametri della tabella derivata
cluster_keys	Specifica che una PDT deve essere raggruppata in cluster in base a uno o più campi in BigQuery È stato aggiunto il supporto per cluster_keys su Snowflake
create_process	Specifica una sequenza ordinata di passaggi per creare una tabella derivata persistente in un dialetto del database che richiede comandi DDL personalizzati. Questo parametro ha il sottoparametro sql_step.
datagroup_trigger	Specifica il gruppo di dati da utilizzare per i criteri di ricreazione delle PDT
derived_table	Basa una vista su una tabella derivata
distribution	Imposta la chiave di distribuzione di una PDT creata in Redshift o Aster
distribution_style	Imposta lo stile di distribuzione di una tabella derivata persistente creata in Redshift
explore_source	Definisce una tabella derivata nativa basata su un'esplorazione
increment_key	Aggiunto 21.4 Trasforma la tabella derivata in una PDT incrementale. increment_key specifica l'incremento di tempo per il quale devono essere eseguiti query sui dati aggiornati e aggiunti alla PDT.
increment_offset	Aggiunto nella versione 21.4 Utilizzato insieme al parametro increment_key per le PDT incrementali. increment_offset specifica il numero di periodi di tempo precedenti (con la granularità della chiave di incremento) che vengono ricreati per tenere conto dei dati arrivati in ritardo.
interval_trigger	Aggiunto 21.20 interval_trigger specifica una pianificazione della ricompilazione per una tabella derivata permanente, nel formato "N (seconds | minutes | hours)"
materialized_view	Aggiunto nella versione 21.10 L'istruzione materialized_view: yes crea una vista materializzata nel database per una tabella derivata.
indexes	Imposta gli indici di un PDT creato in un database tradizionale (ad esempio MySQL, Postgres) o una chiave di ordinamento interleaved in Redshift
partition_keys	Specifica che una PDT deve essere partizionata in base a uno o più campi in Presto o a un singolo campo data/ora in BigQuery
persist_for (per derived_table)	Imposta l'età massima di un PDT prima che venga rigenerato
publish_as_db_view	L'istruzione publish_as_db_view: yes crea una vista stabile del database per la PDT per consentire l'esecuzione di query sulla tabella al di fuori di Looker
sortkeys	Imposta le chiavi di ordinamento di una PDT creata in Redshift
sql (per derived_table)	Dichiara la query SQL per una tabella derivata
sql_create	Definisce un'istruzione SQL CREATE per creare una tabella derivata persistente in un dialetto del database che richiede comandi DDL personalizzati
sql_trigger_value	Specifica la condizione che causa la rigenerazione di una PDT
table_compression	Specifica la compressione della tabella da utilizzare per una PDT in Amazon Athena
table_format	Specifica il formato della tabella da utilizzare per una PDT in Amazon Athena
Parametri di perfezionamento
view: +view_name	Aggiunge un segno più (+) davanti al nome di una visualizzazione esistente per aggiungere un perfezionamento alla visualizzazione esistente. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione relativa ai miglioramenti di LookML.
final	Indica che l'attuale perfezionamento è l'ultimo consentito per la visualizzazione. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione relativa ai miglioramenti di LookML.
Parametri da evitare
distkey	Rimossa la versione 3.26 Sostituita da distribution
view_label	Evita 4.4 Sostituito da label