错误:未知或无法访问的字段

当您处理 LookML 文件并且对更新感到满意时,部署 LookML 更改的下一步是运行 LookML 验证器以执行完整的模型验证。

有时,您可能会看到如下错误:

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

在此示例中,错误是指 users 视图中的 lifetime_orders 字段。该错误表示 users.lifetime_orders 无法访问其引用的 user_order_facts.lifetime_orders 字段。

为什么会发生此错误?

导致此错误的原因有以下几种:

  1. 您引用的字段不存在
  2. 您引用的字段是整个维度组 - 例如,引用的维度组没有附加 timeframe
  3. 由于缺少联接,某些探索无法访问该字段

选项 1:该字段不存在

如果 LookML 字段中引用了字段 user_order_facts.lifetime_orders,但字段本身并不存在,您将收到 unknown or inaccessible field 错误。

您可以通过将触发错误的字段(在此示例中为 user_order_facts.lifetime_orders)添加到包含相关字段的视图中来解决该错误。在这种情况下,您可以确保已在 user_order_facts 视图中定义该字段;如果该字段不存在,您可以自行添加。

选项 2:该字段引用整个维度组

维度组表示一组维度。type: time 维度组表示在 timeframe 参数中定义的一组时间段维度。在 LookML 中引用维度组时,必须将相应的维度(在本例中为 timeframe)附加到维度组名称。

例如,请考虑以下维度组:

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

如果要在另一个 LookML 字段中引用 created 维度组,则必须引用组内的特定时间范围维度,例如以下维度之一:

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

如果您尝试仅使用维度组的名称 ${created},Looker 将不知道您所指的时间范围,并会生成错误。

选项 3:缺少联接

以下是 users.lifetime_orders 的 LookML 定义:

  dimension: lifetime_orders {
    type: number
    sql: ${user_order_facts.lifetime_orders};;
  }
请注意使用替换运算符 ${} 来引用 LookML 字段 user_order_facts.lifetime_orders

users 视图中的 lifetime_orders 维度引用 user_order_facts 视图中的 lifetime_orders 字段。在本例中,系统会触发错误,因为模型文件中存在 users 视图与探索联接的实例,而 user_order_facts 未联接到相应探索中。

如需查看导致问题的探索,您可以展开错误消息中突出显示的发生实例:

展开的错误消息,显示了由以下两个原因引起的视图、查看代码行和探索:users:79 (ecommerce:order_items) 和 users:79 (ecommerce:orders)。

这些情况表明,ecommerce 模型中的 order_itemsorders 探索导致了该错误。这些探索具有多个联接,在模型文件中定义如下:

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

在这两个探索中,users 视图会在不加入 user_order_facts 视图的情况下进行联接,因此这两个探索都无法访问 user_order_facts.lifetime_orders 字段。如果您尝试在任一探索中查询 users.lifetime_orders 字段(该字段引用 user_order_facts.lifetime_orders),就会触发错误。

LookML 验证程序会警告您,用户在查询 users_order_facts.lifetime_orders 时将收到错误。在 user_order_facts 也联接的探索中,users.lifetime_orders 字段不会触发错误。

users 探索为例:

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

这里的 user_order_facts 联接的,因此查询 users.lifetime_orders 不会触发错误。

如何修复因联接缺失而导致的错误?

如果错误是由联接缺失引起的,您可以通过以下几种方式修复此错误:

  1. 所有情况下,联接缺失的视图。对于本页面中使用的示例,请确保在探索中联接 users 视图时联接 user_order_facts 视图。
  2. 如果您不想加入缺失的视图,请排除导致“探索”出错的字段。

加入缺失的视图

在前面的示例中,可以通过将 user_order_factsusers 也联接的所有探索来解决错误。这将确保探索在查询中使用 users.lifetime_orders 时可以访问 user_order_facts.lifetime_orders

您可以使用 IDE 中的元数据面板 查看所有使用 users 视图的探索。

以下示例联接缺失的视图:

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

现在,如果您重新运行 LookML 验证程序,应该不会再出现此错误。

从“探索”部分排除导致错误的字段

您可能不想将“user_order_facts”视图加入到users已加入的所有探索。例如,可能不希望用户从 orders 探索中的 user_order_facts 视图访问这些字段,但确实希望用户从 users 视图访问这些字段时不会出错。为此,您可以使用 fields 参数从 orders 探索中排除导致错误的字段 (users.lifetime_orders)。

借助探索的 fields 参数,您可以在探索中包含或排除特定字段。在这种情况下,您可以从 orders 探索中排除 users.lifetime_orders,如下所示:

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