Visualizza parametri

Una vista rappresenta una tabella di dati in Looker, sia che la tabella sia integrata nel database sia che sia stata creata utilizzando la funzionalità delle tabelle derivate 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 campi, ognuna delle quali corrisponde in genere a una colonna nella 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.

Esistono anche una serie di impostazioni a livello di visualizzazione, descritte in questa pagina.

Esempio di utilizzo

Tieni il puntatore del 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, ...]

  # CUSTOM CALENDAR PARAMETERS

    calendar_definition: {
      Custom calendar mapping parameters ;;
    }

  # 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_analytic_model: {
    sql: analytic_model_definition ;;
  }
  sql_analytic_model_name: analytic_model_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 la vista)	Specifica l'elenco predefinito di campi visualizzati quando si esegue il drill-down nelle misure definite nella vista
extends (per la vista)	Specifica le viste che verranno estese da questa vista
extension (per la vista)	Specifica che la vista richiede un'estensione e non può essere esposta agli utenti
include	Aggiunge file a una vista
test	Crea un test sui dati per verificare la logica del modello. Le impostazioni progetto includono un'opzione per richiedere i test sui dati. Quando questa opzione è abilitata per un progetto, gli sviluppatori del progetto devono eseguire i 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 la vista)	Specifica come verrà visualizzato il nome della vista nel selettore campi
fields_hidden_by_default	Aggiunto nella versione 21.12 Se impostato su yes, nasconde per impostazione predefinita tutti i campi della vista. Utilizza il parametro hidden: no in un campo per visualizzarlo.
Parametri di filtro
suggestions (per la vista)	Attiva o disattiva i suggerimenti per tutte le dimensioni di questa vista
Parametri di query
autogenerate_primary_keys (per la vista)	Attiva o disattiva la generazione automatica chiave primaria
required_access_grants (per la vista)	Limita l'accesso alla vista solo agli utenti i cui valori degli attributi utente corrispondono alle concessioni di accesso
sql_table_name (per la vista)	Modifica la tabella SQL su cui si basa una vista
Parametri delle tabelle derivate
cluster_keys	Specifica che una PDT deve essere raggruppata in cluster in base a uno o più campi in BigQuery Aggiunto il supporto per cluster_keys in Snowflake
create_process	Specifica una sequenza ordinata di passaggi per creare una PDT in un dialetto di 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 rigenerazione della 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 PDT creata in Redshift
explore_source	Definisce una tabella derivata nativa basata su un Explore
increment_key	Aggiunto nella versione 21.4 Trasforma la tabella derivata in una PDT incrementale. increment_key specifica l'incremento di tempo per cui devono essere eseguite 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 (in base alla granularità della chiave di incremento) che vengono ricreati per tenere conto dei dati ricevuti in ritardo.
interval_trigger	Aggiunto nella versione 21.20 interval_trigger specifica una pianificazione di rigenerazione 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 una PDT creata in un database tradizionale (ad es. 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 in base a un singolo campo data/ora in BigQuery
persist_for (per derived_table)	Imposta l'età massima di una PDT prima che venga rigenerata
publish_as_db_view	L'istruzione publish_as_db_view: yes crea una vista di database stabile 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 PDT in un dialetto di 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 vista esistente per aggiungere un perfezionamento alla vista esistente. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione sui perfezionamenti LookML.
final	Indica che il perfezionamento corrente è il perfezionamento finale consentito per la vista. Per ulteriori informazioni e casi d'uso, consulta la pagina della documentazione sui perfezionamenti LookML.
Parametri da evitare
distkey	Rimosso nella versione 3.26 Sostituito da distribution
view_label	Evita nella versione 4.4 Sostituito da label