Paramètres de jointure

Cette page contient des liens vers tous les paramètres LookML enfants du paramètre join. Pour en savoir plus sur l'utilisation des jointures, consultez la page de documentation Utiliser des jointures dans LookML.

Une jointure permet d'ajouter plusieurs vues à une même exploration. Les utilisateurs peuvent ainsi accéder à des champs provenant de différentes vues et les comparer en même temps. Vous déclarez l'exploration et tous les paramètres join souhaités dans un fichier de modèle.

Exemple d'utilisation

Pointez sur le nom d'un paramètre pour afficher une brève description. Cliquez dessus pour accéder à la page correspondante. Lorsqu'un paramètre peut être défini sur l'une des options spécifiques, la valeur par défaut est indiquée en premier.

## STRUCTURAL PARAMETERS
explore: explore_name {
  # Desired Explore parameters (described on Explore Parameters page)

  join: join_name  {

    # DISPLAY PARAMETERS
    view_label: "desired label for the view"

    # JOIN PARAMETERS
    fields: [field_or_set, field_or_set, ...]
    foreign_key: dimension_name
    from: view_name
    outer_only: no | yes
    relationship: many_to_one | many_to_many | one_to_many | one_to_one 
    required_joins: [view_name, view_name, ...]
    sql_on: SQL ON clause ;;
    sql_table_name: table_name ;;
    type: left_outer | cross | full_outer | inner 

    # QUERY PARAMETERS
    required_access_grants: [access_grant_name, access_grant_name, ...]
    sql_where: SQL WHERE condition ;;
  }
  # Possibly more join declarations
}

Définition des paramètres

Nom du paramètre	Description
Paramètres de structure
join	Joint une vue à une exploration
Paramètres d'affichage
view_label (pour la jointure)	Modifie la présentation du nom de vue d'une jointure dans le sélecteur de champs.
Paramètres de jointure
fields (pour la jointure)	Désigne les champs d'une jointure à insérer dans une exploration.
foreign_key	Définit la relation entre une exploration et une jointure en utilisant la clé primaire de la vue jointe.
from (pour la jointure)	Désigne la vue de départ d'une jointure.
outer_only	Indique si les requêtes doivent toutes utiliser une jointure externe.
relationship	Déclare une jointure comme établissant une relation un-à-un, plusieurs-à-un, un-à-plusieurs ou plusieurs-à-plusieurs.
required_joins	Désigne les jointures à appliquer à une exploration en cas de sélection des champs d'une jointure donnée.
sql_on	Définit une relation entre une exploration et une jointure en écrivant une clause SQL ON.
sql_table_name (pour la jointure)	Désigne la table de base de données sur laquelle doit reposer une jointure.
type (pour la jointure)	Déclare une jointure comme gauche, complète, interne ou croisée.
Paramètres de requête
required_access_grants (pour la jointure)	Limite l'accès à la jointure aux seuls utilisateurs dont les valeurs d'attribut utilisateur correspondent aux droits d'accès.
sql_where	Si cette jointure est incluse dans la requête, insère dans la clause WHERE de cette dernière des conditions que l'utilisateur ne peut pas modifier ni retirer de l'exploration. (BigQuery uniquement)
Paramètres à éviter
sql (pour la jointure)	Éviter 3.10 Remplacé par une combinaison de sql_on, foreign_key, type et/ou sql_table_name, comme décrit ici
sql_foreign_key	Éviter 3.16 Remplacé par foreign_key

Remarque : Le paramètre always_join spécifie les jointures qui doivent toujours être appliquées à une exploration. Ce paramètre est défini dans une exploration. Il est donc listé sur la page du paramètre explore.