sql_table_name (pour les explorations)

Cette page fait référence au paramètre sql_table_name qui fait partie d'une exploration.

sql_table_name peut également être utilisé dans une vue, comme décrit sur la page de documentation du paramètre sql_table_name (pour les vues).

sql_table_name peut également être utilisé dans le cadre d'une jointure, décrite sur la page de documentation du paramètre sql_table_name (pour les jointures).

Utilisation

explorer: explore_name {
sql_table_name: table_name ;;
}
Hiérarchie
sql_table_name
Valeur par défaut
Table de la base de données sur laquelle la vue Explorer est basée

Acceptation
Nom d'une table de base de données

Règles spéciales
  • sql_table_name ne doit être utilisé que lorsque la même vue peut décrire plusieurs tables
  • Toute table référencée par sql_table_name doit être accessible dans la connexion à la base de données de son modèle

Définition

sql_table_name définit la table de votre base de données qui sera interrogée par la fonction Explore (Explorer). En général, la vue pour laquelle une exploration est nommée définit la table qui sera interrogée. Toutefois, si plusieurs tables ont la même structure, la même vue peut être utilisée pour les décrire toutes. sql_table_name vous permet de spécifier quelles tables utiliser.

Si vous devez référencer une table d'une autre base de données/d'un autre schéma, vous pouvez utiliser database_or_schema_name.table_name. Si vous n'écrivez pas explicitement une base de données/schéma, Looker utilisera la valeur par défaut que vous avez définie. La valeur par défaut est configurée dans la section "Administration" de Looker sous Connexions.

Examples

Faites en sorte que customers Explore s'appuie sur la table customer_1 de la base de données/schéma par défaut:

explore: customers {
  sql_table_name: customer_1 ;;
}

Faites en sorte que customers Explore s'appuie sur la table customer_1 de la base de données/schéma analytics:

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

Difficultés courantes

Les tables référencées par sql_table_name doivent être accessibles à partir de la connexion actuelle

sql_table_name fait partie d'une exploration, qui à son tour fait partie d'un modèle. Une connexion à la base de données sera définie dans le modèle. Toute table que vous référencez dans sql_table_name doit être accessible via cette connexion à la base de données.

Bon à savoir

Pour nommer une view différente de la table sous-jacente, appliquez sql_table_name au niveau view

Il n'est pas courant d'utiliser sql_table_name au niveau explore, comme décrit sur cette page. Il ne doit être utilisé que lorsque le même objet view peut décrire plusieurs tables.

La méthode la plus courante consiste à utiliser sql_table_name au niveau view lorsque vous souhaitez nommer une vue différemment du nom de la table sous-jacente.

En d'autres termes, au lieu de:

Fichier de modèle

explore: customers {
  sql_table_name: customer_1 ;;
}

Procédez comme suit :

Fichier de modèle

explore: customers { ... }

Afficher le fichier

view: customers {
  sql_table_name: customer_1 ;;
}