sql_table_name (per le esplorazioni)

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

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'unione, come descritto nella pagina della documentazione relativa al parametro sql_table_name (per le unioni).

Utilizzo

explore: explore_name {
  sql_table_name: table_name ;;
}

Gerarchia File del 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 di database Regole speciali sql_table_name deve essere utilizzato solo quando la stessa vista può descrivere più tabelle. 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 delimitare il nome della tabella.

Definizione

sql_table_name imposta la tabella nel database su cui verrà eseguita la query da Esplora. 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, è possibile utilizzare la stessa vista per descriverle tutte. sql_table_name consente di specificare quale di queste tabelle deve essere utilizzata.

Nomi delle tabelle con ambito

Quando fai riferimento a una tabella utilizzando solo il nome della tabella, Looker utilizza il percorso di ricerca predefinito (il database e lo schema) che l'amministratore di Looker ha configurato nelle impostazioni per la connessione al database. Per saperne di più, consulta la sezione Aspetti da considerare di 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 indirizzare 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 <database_name>.<schema_name>.<table_name> completo.

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 utilizzando il formato <project_name>.<dataset_name>.<table_name>. Per ulteriori informazioni, consulta la pagina della documentazione relativa alla connessione a 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 limitando il nome della tabella in modo che includa 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 Connessione a Google BigQuery.

Aspetti da considerare

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

Quando il parametro sql_table_name viene utilizzato all'interno di un oggetto explore, quest'ultimo viene a sua volta incluso in un oggetto model.explore La gerarchia in questa pagina mostra questa catena di relazioni. L'oggetto di modello ha un database connection definito 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 Looker al database per la connessione al database.

Per assegnare un nome a un view diverso da quello della 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 lo stesso view può descrivere più tabelle.

Il metodo più comune è 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, invece di questo:

File del modello

explore: customers {
  sql_table_name: customer_1 ;;
}

Esegui questa azione:

File del modello

explore: customers { ... }

Visualizza file

view: customers {
  sql_table_name: customer_1 ;;
}