Erreur: champ inconnu ou inaccessible

Lorsque vous travaillez sur vos fichiers LookML et que vous êtes satisfait de vos modifications, la prochaine étape consiste à exécuter l'outil de validation LookML pour effectuer une validation complète du modèle.

Il est possible que vous rencontriez parfois un message d'erreur semblable à celui-ci:

 Unknown or inaccessible field "user_order_facts.lifetime_orders" referenced in "users.lifetime_orders". Check for typos and missing joins.

Dans cet exemple, l'erreur fait référence au champ lifetime_orders dans la vue users. L'erreur indique que users.lifetime_orders ne peut pas accéder au champ user_order_facts.lifetime_orders qu'il référence.

Pourquoi cette erreur se produit-elle ?

Cette erreur peut se produire pour plusieurs raisons:

1. Le champ auquel vous faites référence n'existe pas.
2. Le champ auquel vous faites référence est un groupe de dimensions entier : par exemple, un groupe de dimensions est référencé sans timeframe ajouté.
3. Le champ est inaccessible par certaines explorations, car une jointure est manquante.

Option 1: Le champ n'existe pas

Si le champ user_order_facts.lifetime_orders est référencé dans les champs LookML, mais qu'il n'existe pas en tant que champ, l'erreur unknown or inaccessible field s'affiche.

Pour résoudre l'erreur, ajoutez le champ qui la déclenche (user_order_facts.lifetime_orders dans cet exemple) à la vue qui contient le champ en question. Dans ce cas, vous pouvez vous assurer que le champ est défini dans la vue user_order_facts. S'il n'existe pas, vous pouvez l'ajouter.

Option 2: Le champ fait référence à un groupe de dimensions entier

Les groupes de dimensions représentent un groupe de dimensions. Les groupes de dimensions type: time représentent un groupe de dimensions de période définies dans le paramètre timeframe. Lorsque vous faites référence à des groupes de dimensions dans LookML, vous devez ajouter la dimension appropriée (timeframe, dans ce cas) au nom du groupe de dimensions.

Prenons l'exemple du groupe de dimensions suivant:

  dimension_group: created {
    type: time
    timeframes: [date, week, month]
    sql: ${TABLE}.created_at ;;
  }

Si vous souhaitez faire référence au groupe de dimensions created dans un autre champ LookML, vous devez faire référence à une dimension période spécifique du groupe, par exemple l'une des suivantes:

• date : ${created_date}
• week : ${created_week}
• month: ${created_month}

Si vous essayez d'utiliser uniquement le nom du groupe de dimensions (${created}), Looker ne saura pas à quelle période vous faites référence et générera une erreur.

Option 3: Il manque une jointure

Voici la définition LookML de users.lifetime_orders:

  dimension: lifetime_orders {
    type: number
    sql: ${user_order_facts.lifetime_orders};;
  }

Notez l'utilisation des opérateurs de substitution ${} pour faire référence au champ LookML user_order_facts.lifetime_orders.

La dimension lifetime_orders de la vue users fait référence au champ lifetime_orders de la vue user_order_facts. Dans ce cas, l'erreur est déclenchée, car le fichier de modèle contient des instances où la vue users est jointe à une exploration sans que user_order_facts ne l'ait également été.

Pour identifier les explorations à l'origine du problème, vous pouvez développer les occurrences mises en surbrillance dans le message d'erreur:

Ces occurrences montrent que les explorations order_items et orders du modèle ecommerce sont à l'origine de l'erreur. Ces explorations comportent de nombreuses jointures et sont définies comme suit dans le fichier de modèle:

  explore: orders {
    join: users { # users joined without user_order_facts
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
  }

  explore: order_items {
    join: inventory_items {
      relationship: many_to_one
      sql_on: ${order_items.inventory_item_id} = ${inventory_items.id}
    }
    join: orders {
      relationship: many_to_one
      sql_on: ${order_items.order_id} = ${orders.id}
    }
    join: users { # users joined without user_order_facts
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
  }

Dans ces deux explorations, la vue users est jointe sans également joindre la vue user_order_facts. Par conséquent, aucune exploration ne peut accéder au champ user_order_facts.lifetime_orders. Si vous essayez d'interroger le champ users.lifetime_orders (qui fait référence à user_order_facts.lifetime_orders) dans l'une des explorations, une erreur s'affiche.

L'outil de validation LookML vous avertit que les utilisateurs recevront l'erreur lorsqu'ils interrogeront users_order_facts.lifetime_orders. Le champ users.lifetime_orders ne déclenchera pas l'erreur dans une exploration à laquelle user_order_facts est également joint.

Prenons l'exemple de l'exploration users:

  explore: users {
    join: user_order_facts {
      sql_on: ${users.id} = ${user_order_facts.users_id}
    }
  }

Ici, user_order_facts est joint, donc l'interrogation de users.lifetime_orders ne déclenchera pas d'erreur.

Comment corriger l'erreur lorsqu'elle est causée par une jointure manquante ?

Si l'erreur est due à une jointure manquante, vous pouvez la résoudre de deux manières:

1. Associez la vue manquante à tous les cas. Pour l'exemple utilisé sur cette page, assurez-vous que la vue user_order_facts est jointe partout où la vue users est jointe dans une exploration.
2. Excluez le champ à l'origine de l'erreur des explorations si vous ne souhaitez pas joindre la vue manquante.

Rejoindre la vue manquante

Dans l'exemple précédent, l'erreur peut être résolue en joignant user_order_facts à toutes les explorations où users est également joint. Cela garantit que les explorations peuvent accéder à user_order_facts.lifetime_orders lorsque users.lifetime_orders est utilisé dans une requête.

Vous pouvez utiliser le panneau des métadonnées dans l'IDE pour afficher toutes les explorations qui utilisent la vue users.

L'exemple suivant joint les vues manquantes:

  explore: order_items {
    join: inventory_items {
      relationship: many_to_one
      sql_on: ${inventory_items.id} = ${order_items.inventory_item_id}
    }
    join: orders {
      relationship: many_to_one
      sql_on: ${order_items.order_id} = ${orders.id}
    }
    join: users {
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
    join: user_order_facts { # join user_order_facts through users
      relationship: many_to_one
      sql_on: ${users.id} = ${user_order_facts.users_id}
    }
  }

Si vous exécutez à nouveau l'outil de validation LookML, cette erreur ne devrait plus s'afficher.

Excluez le champ à l'origine de l'erreur des explorations.

Vous ne souhaitez peut-être pas joindre la vue user_order_facts à toutes les explorations où users est joint. Par exemple, vous ne souhaitez peut-être pas que les utilisateurs accèdent aux champs à partir de la vue user_order_facts dans l'exploration orders, mais vous voulez qu'ils y accèdent à partir de la vue users sans erreur. Pour ce faire, excluez le champ à l'origine de l'erreur (users.lifetime_orders) de l'exploration orders à l'aide du paramètre fields.

Le paramètre fields des explorations vous permet d'inclure ou d'exclure des champs spécifiques d'une exploration. Dans ce cas, vous pouvez exclure users.lifetime_orders de l'exploration orders comme suit:

  explore: orders {
    fields: [ALL_FIELDS*, -users.lifetime_orders] # exclude users.lifetime_orders
    join: users {
      relationship: many_to_one
      sql_on: ${orders.user_id} = ${users.id}
    }
  }