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 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
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 ne doit être utilisé que lorsque la même vue peut décrire plusieurs tables.
  • 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érents du chemin d'accès 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

sql_table_name définit la table de votre base de données qui sera interrogée par l'exploration. En général, la vue pour laquelle une exploration est nommée définit la table qui sera interrogée. Toutefois, dans les cas où 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 laquelle de ces tables doit être utilisée.

Noms de tables de portée

Lorsque vous faites référence à 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 Points à prendre en compte de cette page.

Si vous devez faire référence à 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 nom de la table à l'aide du 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 provenant d'un autre schéma, utilisez <schema_name>.<table_name>, comme indiqué dans l'exemple de cette page.
  • Pour référencer une table provenant d'une autre base de données, utilisez le <database_name>.<schema_name>.<table_name> complet.

Pour une connexion Google BigQuery, vous pouvez faire référence à une table dans un autre projet et ensemble de données en définissant le 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

Cet exemple fait en sorte que l'exploration customers s'appuie sur la table customer_1 de la base de données/du schéma par défaut :

explore: customers {
  sql_table_name: customer_1 ;;
}

Cet exemple montre comment faire en sorte que l'exploration customers s'appuie 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 ;;
}

É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 paramètre sql_table_name est utilisé dans un objet explore, cet objet explore est à son tour inclus dans un objet model. (La hiérarchie sur cette page montre cette chaîne de relations.) L'objet de modèle contient une connection de base de données. 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 la connexion à la base de données.

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

L'utilisation de sql_table_name au niveau explore, comme décrit sur cette page, n'est pas très courante. Elle ne doit être utilisée que lorsque le même 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 ceci :

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 ;;
}