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

在处理 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 未联接的情况。

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

展开的错误消息,显示了 View、View 代码行和 Explores of 两个原因:users:79 (ecommerce:order_items) 和 users:79 (ecommerce:orders)。

这些出现情况表明,ecommerce 模型中的 order_itemsorders Explore 会导致错误。这些探索包含许多联接,并在模型文件中定义如下:

  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 字段。如果您尝试在任一“探索”中查询引用 user_order_facts.lifetime_ordersusers.lifetime_orders 字段,就会触发错误。

LookML 验证器警告您,用户在查询 users_order_facts.lifetime_orders 时将收到错误。如果“探索”中还联接了 user_order_factsusers.lifetime_orders 字段不会触发错误。

users 的“Explore:

  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 验证程序,该错误应该不会再出现。

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

你可能不想在 users 已加入的所有探索中加入 user_order_facts 视图。例如,您可能不希望用户访问 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}
    }
  }