当您处理 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
字段。
为什么会发生此错误?
导致此错误的原因有以下几种:
- 您引用的字段不存在。
-
您引用的字段是整个维度组 - 例如,引用的维度组没有附加
timeframe
。 - 由于缺少联接,某些探索无法访问该字段。
选项 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
未联接到相应探索中。
如需查看导致问题的探索,您可以展开错误消息中突出显示的发生实例:
这些情况表明,ecommerce
模型中的 order_items
和 orders
探索导致了该错误。这些探索具有多个联接,在模型文件中定义如下:
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
不会触发错误。
如何修复因联接缺失而导致的错误?
如果错误是由联接缺失引起的,您可以通过以下几种方式修复此错误:
-
在所有情况下,联接缺失的视图。对于本页面中使用的示例,请确保在探索中联接
users
视图时联接user_order_facts
视图。 - 如果您不想加入缺失的视图,请排除导致“探索”出错的字段。
加入缺失的视图
在前面的示例中,可以通过将 user_order_facts
与 users
也联接的所有探索来解决错误。这将确保探索在查询中使用 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} } }