sql_table_name (pour les explorations)

Cette page fait référence au sql_table_name paramètre 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 une jointure, comme décrit sur la page de documentation du paramètre sql_table_name (pour les jointures).

Utilisation

explore: explore_name {
  sql_table_name: table_name ;;
}

Hiérarchie Fichier de modèle explore sql_table_name

Valeur par défaut Table de base de données sur laquelle repose la vue de l'exploration Acceptation Nom d'une table de base de données Règles spéciales sql_table_name pour les explorations ne doit être utilisé que lorsque la même vue peut décrire plusieurs tables dans votre base de données. La table référencée par sql_table_name doit être accessible dans la connexion à la base de données de son modèle. Si la table se trouve dans une base de données, un schéma, un projet ou un ensemble de données différent du chemin par défaut que vous avez défini dans votre connexion à la base de données, vous devez définir le champ d'application du nom de la table.

Définition

Le paramètre sql_table_name spécifie la table de votre base de données qui sera interrogée par l'exploration. En règle générale, 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, vous pouvez utiliser le paramètre sql_table_name sous le paramètre explore pour remplacer la table de base spécifiée dans le fichier d'affichage. Vous pouvez ainsi prendre les dimensions et les mesures que vous avez définies dans le fichier de vue et les appliquer à des tables de base de données autres que celle spécifiée dans le fichier de vue.

Définir le champ d'application des noms de tables

Lorsque vous référencez une table en utilisant uniquement son nom, Looker utilise le chemin de recherche par défaut (la base de données et le schéma) que votre administrateur Looker a configuré dans les paramètres de la connexion à la base de données. Pour en savoir plus, consultez la section Éléments à prendre en compte de cette page.

Si vous devez référencer une table dans une base de données et un schéma différents qui ne figurent pas dans le chemin de recherche par défaut de l'utilisateur de la base de données, vous pouvez définir le champ d'application du nom de la table en utilisant le format <database_name>.<schema_name>.<table_name> pour pointer vers une autre base de données ou un autre schéma :

• Pour référencer une table à partir d'un schéma différent, utilisez <schema_name>.<table_name>, comme illustré dans l'exemple de cette page.
• Pour référencer une table à partir d'une base de données différente, utilisez le format complet <database_name>.<schema_name>.<table_name>.

Pour une connexion Google BigQuery, vous pouvez référencer une table dans un projet et un ensemble de données différents en définissant le champ d'application du nom de la table au format <project_name>.<dataset_name>.<table_name>. Pour en savoir plus, consultez la page de documentation sur la connexion Google BigQuery.

Exemples

Dans cet exemple, l'exploration customers repose sur la table customer_1 de la base de données/du schéma par défaut :

explore: customers {
  sql_table_name: customer_1 ;;
}

Dans cet exemple, l'exploration customers repose sur la table customer_1 du schéma analytics en définissant le champ d'application du nom de la table pour inclure le nom du schéma (au format <schema_name>.<table_name>) :

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

Remarque : Pour une connexion Google BigQuery, vous pouvez définir entièrement le champ d’application du nom de la table au format <project_name>.<dataset_name>.<table_name>. Pour en savoir plus, consultez la page de documentation sur la connexion Google BigQuery.

Éléments à prendre en compte

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

Lorsque le sql_table_name paramètre est utilisé dans un explore objet, cet explore objet est à son tour inclus dans un modèle objet. (La hiérarchie de cette page illustre cette chaîne de relations.) L'objet de modèle comporte une base de données connection définie. Lorsque vous référencez une table de base de données dans le paramètre sql_table_name, la table doit être accessible dans la connexion associée spécifiée dans le fichier de modèle.

La base de données et le schéma par défaut (ou, pour Google BigQuery, le projet de facturation et l'ensemble de données) sont définis par votre administrateur Looker lorsqu'il crée la connexion Looker à votre base de données.

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

L'utilisation de sql_table_name au niveau de l'explore, comme décrit sur cette page, est peu courante. Elle ne doit être utilisée que lorsque la même view peut décrire plusieurs tables.

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

Autrement dit, au lieu de ceci :

Fichier de modèle

explore: customers {
  sql_table_name: customer_1 ;;
}

Procédez comme suit :

Fichier de modèle

explore: customers { ... }

Fichier de vue

view: customers {
  sql_table_name: customer_1 ;;
}