在处理 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 会导致错误。这些探索包含许多联接,并在模型文件中定义如下:
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_orders
的 users.lifetime_orders
字段,就会触发错误。
LookML 验证器警告您,用户在查询 users_order_facts.lifetime_orders
时将收到错误。如果“探索”中还联接了 user_order_facts
,users.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
不会触发错误。
如何修复由缺少联接引起的错误?
如果错误是由缺少联接引起的,您可以通过以下几种方式修复此错误:
-
在所有情况下联接缺失的视图。对于本页中使用的示例,请确保在“探索”中联接
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 验证程序,该错误应该不会再出现。
从“探索”部分排除导致错误的字段
你可能不想在 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} } }