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 une erreur semblable à celle-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 de 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 que vous référencez n'existe pas.
2. Le champ que vous référencez correspond à un groupe de dimensions entier (par exemple, un groupe de dimensions est référencé sans qu'un timeframe soit ajouté).
3. Certaines explorations ne peuvent pas accéder au champ, 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 référencez des groupes de dimensions dans LookML, vous devez ajoutez 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 l'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 opérateurs de substitution ${} pour référencer le 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 indiquent 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éclenche 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 puis-je corriger l'erreur lorsqu'elle est causée par une jointure manquante ?

Si l'erreur est causée par une jointure manquante, vous pouvez corriger cette erreur de plusieurs 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 là 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.

Joindre 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 de l'IDE pour voir 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}
    }
  }

Cette erreur ne devrait plus apparaître si vous exécutez à nouveau le programme de validation LookML.

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

Il se peut que vous ne souhaitiez pas joindre la vue user_order_facts à toutes les explorations dans lesquelles users est joint. Par exemple, vous ne voulez peut-être pas que les utilisateurs accèdent aux champs de la vue user_order_facts dans l'exploration orders, mais que vous voulez qu'ils accèdent aux champs de la vue users sans erreur. Pour ce faire, vous pouvez exclure le champ à l'origine de l'erreur : users.lifetime_orders : à partir de l'exploration orders, en utilisant la 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}
    }
  }