Looker 错误目录

下表汇总了 Looker 中显示的一些常见错误消息，并说明了其根本原因和发生位置，还提供了问题排查资源。这些错误会按向 Looker 支持团队报告的频率降序显示，最上方的错误是支持请求数量最多的错误。

位置列表示错误消息在 Looker 中的显示位置，包含以下选项（某些错误可能会显示在产品中的多个位置）：

IDE = LookML 验证器/IDE

Ex = 探索

SQL = SQL Runner

LD = LookML 信息中心

D = 信息中心

S = Schedules

错误消息 位置 可能的原因 问题排查资源
Variable not found (?). IDE
  • 变量引用的 Liquid {{ }} 嵌套在逻辑的 Liquid {% %} 中。
  • 模板化过滤条件引用了未联接到派生表的表。
  • Liquid 中引用的字段未完全限定视图名称 (view_name.field_name)。
  • 过滤条件的值在另一个 LookML 信息中心过滤条件中被引用。
  • parameter 参数的值与相应的 type 不兼容。例如：{% if parameters.change_value._parameter_value == "'AA'" %} 查看 parameter type，确保值求值正确（type: string 与 type: unquoted）。
  • 某个字段在 Liquid 中被正确引用为 view_name.field_name，但 field_name 未在范围限定的视图 view_name 中定义，或者该视图在 Explore 中被别名为 from。
  • 对变量的 Liquid 引用未定义，或者引用中包含拼写错误。
  • Liquid 参考包含维度组 type: time，但不包含具体的时间范围。例如，引用应使用 {{ view_name.creation_date_year }}，而不是 {{ view_name.creation_date }}。
  • 某个字段使用了带有 LookML 替换运算符语法的 Liquid，即 ${view_name.field_name}，而不是不带该语法的 Liquid，即 view_name.field_name。
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). IDE
  • 引用的视图不存在。
  • 缺少联接，导致某些探索无法访问该视图。
  • 在探索中，使用 from 参数重命名视图。
Unknown or inaccessible field (?). Check for typos or append a timeframe to the name if the field is type time. IDE Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). 错误中列出的任何可能原因都可能适用，此外，还可能存在以下原因：
  • 字段名称或对字段的引用中存在拼写错误。
  • 该字段已通过 fields 参数从探索中排除。
  • 引用的是未指定时间范围的 dimension_group。
Unknown view (?). IDE Ex SQL
  • 模型文件中未包含视图。
  • explore 正在扩展缺少 view_name 参数的基础 explore。
  • explore 参数中定义的探索名称基于拼写错误的视图名称或不存在的视图名称。
  • 基于模型的 SQL Runner 查询正在运行，但所选模型不正确。
Unknown view (?). View does not exist in model (?). Check for typos or missing include statements. IDE Ex SQL
  • explore 正在扩展缺少 view_name 参数的基础 explore，并且任何联接视图中的字段都引用了基础 explore 名称。
  • 某个字段引用了拼写错误、不存在或未与适用的探索联接的视图。
Unknown field (?) in filter IDE
  • 原生派生表 (NDT) 定义包含 LookML 中未定义的自定义字段的 bind_all_filters 参数。
  • LookML 过滤条件引用了已注释掉或不存在的 LookML 字段。
  • LookML 过滤条件引用了其他视图中的 LookML 字段，但该字段未完全限定范围，也未加入到所有相关的 explore 参数中。
Measures with Looker aggregations (sum, average, min, max, list types) may not reference other measures. IDE 某个指标在另一个汇总型指标的 SQL 定义中被引用。
Unknown view (?). View (?) does not exist in model (?). Check for typos or missing include statements in (?). IDE 视图未包含在模型文件中，或者包含在模型文件中但拼写错误。
Can't construct persistent derived table (?), connection (?) could not be registered IDE Ex
  • 现有 PDT 的任何依赖项都未能成功构建。
  • 连接存在问题，需要通过测试连接来诊断问题（例如，测试连接可能会发现 Looker 用户可能没有足够的数据库自有权或写入权限）。
  • 导入的项目文件中不包含导入的项目，例如定义失败 PDT 的视图或失败 PDT 引用的视图。
  • 数据库连接未启用永久性派生表设置。
  • 如果 Looker 模块的代码与编写该模块时所用的 SQL 方言不同，则该代码尚未更新为连接的 SQL 方言。
  • 已为 Snowflake 或 BigQuery 连接启用 OAuth。
  • Snowflake 数据库 AUTOCOMMIT 参数已设置为非默认值 TRUE 的值。
Unknown or excluded suggest_dimension (?) in field (?) IDE
  • suggest_dimension 参数引用的字段不存在、已被注释掉，或者在探索中被 fields 参数排除。
  • suggest_dimension 参数引用的字段在另一个视图中定义，但在引用中未完全限定为 view_name.field_name。
  • suggest_dimension 参数引用了未联接到所有相关 explore 参数中的其他视图中的字段，或者引用了在 explore 中使用 from 参数别名的视图。
A view named (?) has been defined multiple times. Each view in a model must have a unique name. IDE 同一模型中引用了名称相同的视图，包括导入到项目中的视图。视图名称在模型中必须是唯一的。 view 参数参考
This include does not match any files IDE
  • 文件路径中的拼写错误导致了错误。
  • 文件夹引用使用了错误的语法。
  • 项目导入参考使用的语法不正确。
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored. Ex 数据库方言不支持具有对称聚合的 type: median 或 type: percentile 度量。
Cannot use native derived table (?) with bind_all_filters outside of its source explore (?) IDE Ex 具有 bind_all_filters 参数的原生派生表 (NDT) 与一个或多个非 explore_source 参数中定义的 Explore 联接。 使用 bind_all_filters
Measures of type count do not use the sql parameter. Use count_distinct to count by something other than the primary key, or remove the sql parameter. IDE sql 参数用于 type: count 的衡量。计数类型度量会根据视图文件中声明的主键执行计数，不需要 sql 参数。
An explore named (?) has been defined multiple times. Each explore in a model must have a unique name. IDE LD
  • 模型文件的 explore 参数中定义的探索名称与另一个现有探索名称重复。Explore 名称在模型中必须是唯一的。
  • 导入的项目具有与导入项目中的现有 explore 同名的 explore。
  • 所包含的模型文件具有与包含项目模型文件中的现有 explore 同名的 explore。*
  • 代码中存在循环引用，多次引用 explore（或模型文件）。
* 不建议在其他模型文件中包含模型文件。
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml? IDE
  • 模型包含视图文件夹，但特定视图文件位于该文件夹之外。
  • 如果视图的命名方式不同，模型会包含视图的名称，但不包含视图文件。
  • 视图多次联接到 explore 中，但在第二次联接时缺少 from 参数。
Unknown field '(?)' IDE Ex
  • 您尝试引用的字段不存在、拼写有误或已被注释掉。
  • 被引用的字段是在其他视图中定义的，并且未限定其视图名称。
  • 某个字段是在未联接到必需的“探索”中的其他视图中定义的，或者该视图在联接中被别名化，导致某些“探索”无法访问该字段。
  • required_fields 参数引用了无法访问、拼写错误、不存在或被注释掉的字段。
Cannot use (?) as access filter since any user can edit their own value. Ex 在探索的 access_filter 参数中使用了将用户访问权限选项设置为修改的用户属性。
label_from_parameter of (?) must refer to a parameter. IDE Ex
  • label_from_parameter 参数引用的字段不存在、拼写有误或被注释掉了。
  • label_from_parameter 参数引用的字段存在，但不是 parameter 类型。
Cannot use user-editable attribute (?) for access_grant (?) IDE Ex 在模型文件的 access_grant 参数中使用了将用户访问权限选项设置为修改的用户属性。
datagroup (?) has a sql_trigger. This is not allowed in models with a parameterized connection. IDE 数据库连接使用用户属性作为数据库登录凭据，并且未为 PDT 进程配置单独的数据库用户，以用于 PDT 替换列。
relationship missing, assumed to be many_to_one. IDE 未定义联接的 relationship。如果未指定 relationship，Looker 默认采用 many-to-one 关系。 relationship 参数参考
No distribution_style specified in persistent derived table (?). Using default distribution style (?). IDE Redshift 连接 PDT 的 derived_table 定义中未指定 distribution_style 参数。如果未指定 distribution_style，Looker 会默认使用 ALL。 distribution_style 参数参考
always_filter: unknown filter field '(?)' IDE
  • always_filter 参数引用的字段不存在、拼写有误或被注释掉了。
  • always_filter 参数引用的字段是 type: time 的 dimension_group，但未附加时间范围。
  • 由 always_filter 参数引用的字段是在未联接到所有相关 explore 参数的视图中定义的字段，或者该字段未限定为视图名称。
The location field type requires both sql_latitude and sql_longitude. IDE type: location 字段缺少 sql_latitude 或 sql_longitude 子参数。位置类型字段需要同时提供这两个值。 location 字段类型参考
Missing required sql_step in create_process of derived table '(?)'. IDE
  • create_process 中未指定 sql_step，而 create_process 需要一个或多个 sql_step 子参数。
  • 缓存的 LookML 验证器错误标记了缺失的 sql_step，即使已添加 sql_step 也是如此。再次验证以解决错误。
create_process 参数参考
Can't construct aggregate table (?), temporary schema for (?) is unset. IDE Ex
Can't construct aggregate table (?), connection (?) could not be registered. IDE Ex 临时数据库设置未在管理面板的连接设置页面中设置，或者 Looker 没有对临时数据库设置中指定的临时数据库的相应权限。
Unknown view (?) referenced by explore (?) IDE
  • 使用默认 include: "*.view.lkml" 包含了一个视图，但该视图位于不同的文件夹中。
  • include 语句中的视图名称或文件路径拼写有误，或者 include 语句包含视图名称，但不包含视图文件（如果视图文件名称不同）。
  • 文件夹中存在特殊字符（例如 _views）。
  • 一个 explore 正在扩展另一个缺少指定基本视图的 view_name 参数的 explore。
The location field type does not use the sql parameter. Please use sql_latitude and sql_longitude instead. IDE sql 参数用于 type: location 的字段中。位置类型字段需要 sql_latitude 和 sql_longitude 子参数，而不是 sql 参数。 location 字段类型参考
A list_field must be defined for measures of type list. IDE Ex 如需根据某个字段生成列表，必须为 type: list 的衡量指标指定该字段。 list 字段类型参考
Query failed with unexpected exception (?) IDE Ex SQL LD D S
  • 在管理面板中的连接的连接设置页面上，PDT 替换项列中指定了主连接数据库以外的数据库。
  • 已超出每个用户的查询限制，并且排队的查询已达到连接池超时时间。
  • JDBC 连接失败。
  • Looker 应用发生了意外故障。
Looker is having trouble connecting to your database. Ex SQL 连接已达到连接池上限，并且排队的查询在连接池超时窗口结束后已超时。
SQL Error in incremental PDT: Query execution failed Ex D S 基于 SQL 的增量 PDT 中引用的一个或多个表的底层架构已发生更改。 架构更改后，增量 PDT 构建失败
Missing dates/values for '(?)' were not filled. Ex
  • 由于在探索中选择了多个维度，因此无法应用维度填充。
  • 由于在探索中透视了一个或多个字段，因此无法应用维度填充。
  • 由于某个字段具有不同的字符串值（例如 allowed_value 或 case 参数），并且该字段应用了过滤条件，因此无法应用维度填充。
填充缺失的日期和值
filters: ` is not supported for measures of non-aggregate type '(?)' IDE Ex filters 参数与以下以外的任何衡量类型搭配使用：count、sum、average 和 count_distinct。
Unknown source explore (?) in lookml test (?) declaration. IDE
  • 数据测试的 explore_source 子形参中使用了拼写错误、不存在或已注释掉的 Explore 名称。
  • 数据测试定义在不包含或未包含在包含 Explore 的 explore_source 定义的文件中。
  • 使用包含 extension: required 参数规范的探索作为数据测试的 explore_source。
filter_expression: is not supported for measures of non-aggregate type '(?)' IDE Ex filters_expression 参数与以下以外的任何衡量类型搭配使用：count、sum、average 或 count_distinct。
Field references an aggregate but is specified as a dimension. If you want to use aggregations such as sum, average, count, use a measure type instead. IDE Ex 维度在其 sql 参数中引用度量或其他聚合
Cannot specify both sql_table_name and derived_table for view (?) IDE 视图同时定义了 sql_table_name 和 derived_table 参数。视图只能引用一个表，即数据库连接中具有 sql_table_name 的现有架构，或具有 derived_table 的新表。
Persistent Native Derived Table for view (?) has an explore source (?) that has access filters. Persisting this table may result in unexpected behavior. IDE 持久性 NDT 基于包含引用用户属性的 access_filter 参数的探索。
Unknown or unexpected parameter "(?)" in (?). IDE
  • distribution_style 参数用于不支持该参数的方言
  • cluster_keys 参数用于不支持该参数的方言
  • sql_always_where 参数是在 join 中定义的，而不是在 explore 中定义的。
  • dimension_group 中定义的时间段不是 type: time。
  • sql_distinct_key 参数是在维度中定义的，而不是在指标中定义的。
Could not find the constant IDE 在导入项目中引用了导入项目中的常量，但该常量仅在导入项目中定义。常量只能在定义它们的项目中引用。需要在清单文件中重新定义常量。 在导入的项目中使用文件中的常量
Multiple primary key definitions for view '(?)': '(?)' and '(?)' IDE 视图文件中存在多个主键。使用 primary_key: yes 将多个维度指定为主键，或者扩展视图使用 primary_key: yes 将新维度指定为主键。
Persistent Native Derived Table for view (?) references user attributes. Persisting this table may result in unexpected behavior. IDE 持久性 NDT 或汇总认知度表基于 explore，其中包含引用用户属性的 access_filter 或 sql_always_where 参数。
No map layer named (?) is defined. Must be one of countries, uk_postcode_areas, us_counties_fips, us_states, us_zipcode_tabulation_areas IDE 如果包含相应字段视图的所有模型中都没有定义地图层，则维度会引用具有 map_layer_name 的地图层。例如，一个视图包含在多个模型中，但地图图层仅在一个模型中定义。
Persistent derived table (?) should include at least one index IDE PDT 或汇总表定义包含 index，但未指定 PDT 或汇总表列。
The x database encountered an error while running this query. Ex SQL 数据库找不到字段的 sql 参数所引用的列。这可能是由以下某种情况引起的：
  • sql 参数中引用的表名或列名存在拼写错误。
  • 数据库中的底层数据（例如列名称）已更改。
Looker 中的常见 SQL 错误排查提示（社区帖子）
Render job (?) failed [orphaned job] S 在预定作业运行期间，Looker 实例不可用。这种情况可能会在版本更新和计划维护期间发生。 Google 针对 Looker 托管服务的维护政策