sql_table_name (per le esplorazioni)

Questa pagina si riferisce al parametro sql_table_name, che fa parte di un'Esplora.

sql_table_name può essere utilizzato anche nell'ambito di una vista, come descritto nella pagina della documentazione dedicata al parametro sql_table_name (per le viste).

sql_table_name può essere utilizzato anche nell'ambito di un join, come descritto nella pagina della documentazione dedicata al parametro sql_table_name (per i join).

Utilizzo

explore: explore_name {
  sql_table_name: table_name ;;
}

Gerarchia File modello explore sql_table_name

Valore predefinito La tabella del database su cui si basa la visualizzazione dell'esplorazione Accetta Il nome di una tabella del database Regole speciali Il parametro sql_table_name per le esplorazioni deve essere utilizzato solo quando la stessa vista può descrivere più tabelle nel database. La tabella a cui fa riferimento sql_table_name deve essere accessibile all'interno della connessione al database del modello. Se la tabella si trova in un database, uno schema, un progetto o un set di dati diverso dal percorso predefinito definito nella connessione al database, devi definire l'ambito del nome della tabella.

Definizione

Il parametro sql_table_name specifica la tabella del database su cui verrà eseguita la query dall'esplorazione. In genere, la vista per cui viene denominata un'esplorazione definisce la tabella su cui verrà eseguita la query. Tuttavia, nei casi in cui più tabelle hanno la stessa struttura, puoi utilizzare il parametro sql_table_name nel parametro explore per sostituire la tabella di base specificata nel file di vista. In questo modo, puoi prendere le dimensioni e le misure che hai definito nel file di vista e applicarle a tabelle del database diverse dalla tabella specificata nel file di vista.

Definizione dell'ambito dei nomi delle tabelle

Quando fai riferimento a una tabella utilizzando solo il nome della tabella, Looker utilizzerà il percorso di ricerca predefinito (il database e lo schema) configurato dall'amministratore di Looker nelle impostazioni della connessione al database. Per ulteriori informazioni, consulta la sezione Aspetti da considerare in questa pagina.

Se devi fare riferimento a una tabella in un database e uno schema diversi che non si trovano nel percorso di ricerca predefinito dell'utente del database, puoi definire l'ambito del nome della tabella utilizzando il formato <database_name>.<schema_name>.<table_name> per puntare a un altro database o schema:

• Per fare riferimento a una tabella di uno schema diverso, utilizza <schema_name>.<table_name>, come mostrato nell'esempio in questa pagina.
• Per fare riferimento a una tabella di un database diverso, utilizza il formato completo <database_name>.<schema_name>.<table_name>.

Per una connessione Google BigQuery, puoi fare riferimento a una tabella in un progetto e un set di dati diversi definendo l'ambito del nome della tabella con il formato <project_name>.<dataset_name>.<table_name>. Per ulteriori informazioni, consulta la pagina della documentazione relativa alla connessione Google BigQuery.

Esempi

Questo esempio fa sì che l'esplorazione customers si basi sulla tabella customer_1 del database/schema predefinito:

explore: customers {
  sql_table_name: customer_1 ;;
}

Questo esempio fa sì che l'esplorazione customers si basi sulla tabella customer_1 dello schema analytics definendo l'ambito del nome della tabella in modo da includere il nome dello schema (utilizzando il formato <schema_name>.<table_name>):

explore: customers {
  sql_table_name: analytics.customer_1 ;;
}

Nota: per una connessione Google BigQuery, puoi definire completamente l'ambito del nome della tabella con il formato <project_name>.<dataset_name>.<table_name>. Per ulteriori informazioni, consulta la pagina della documentazione relativa alla connessione Google BigQuery.

Aspetti da considerare

Le tabelle a cui fa riferimento sql_table_name devono essere accessibili dalla connessione corrente

Quando il sql_table_name parametro viene utilizzato all'interno di un explore oggetto, quest'ultimo viene a sua volta incluso in un modello oggetto.explore (La gerarchia in questa pagina mostra questa catena di relazioni.) L'oggetto modello ha una connection al database definita al suo interno. Quando fai riferimento a una tabella del database nel parametro sql_table_name, la tabella deve essere accessibile all'interno della connessione associata specificata nel file del modello.

Il database e lo schema predefiniti (o, per Google BigQuery, il progetto di fatturazione e il set di dati) vengono definiti dall'amministratore di Looker quando crea la connessione di Looker al tuo database.

Per assegnare a una view un nome diverso dalla tabella sottostante, applica sql_table_name a livello di view

L'utilizzo di sql_table_name a livello di explore, come descritto in questa pagina, non è molto comune. Deve essere utilizzato solo quando la stessa view può descrivere più tabelle.

Il metodo più comune consiste nell'utilizzare sql_table_name a livello di view quando vuoi assegnare a una vista un nome diverso da quello della tabella sottostante.

In altre parole, anziché:

File modello

explore: customers {
  sql_table_name: customer_1 ;;
}

Esegui questa azione:

File modello

explore: customers { ... }

File della vista

view: customers {
  sql_table_name: customer_1 ;;
}