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。	Liquid 变量参考 模板化过滤条件和派生表（社区帖子） from（适用于 Explore） from（用于联接） 维度组必须通过其各个维度进行引用
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?).	IDE	引用的视图不存在。 缺少联接，导致某些探索无法访问该视图。 在探索中，使用 from 参数重命名视图。	错误：字段未知或无法访问（“最佳实践”页面） from（适用于 Explore） 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。	fields（适用于 Explore） fields（用于联接） 维度组必须通过其各个维度进行引用
Unknown view (?).	IDE Ex SQL	模型文件中未包含视图。 explore 正在扩展缺少 view_name 参数的基础 explore。 explore 参数中定义的探索名称基于拼写错误的视图名称或不存在的视图名称。 基于模型的 SQL Runner 查询正在运行，但所选模型不正确。	include 模型参数参考文档 extends（适用于 Explore） explore 参数 在 SQL Runner 中针对 LookML 模型运行查询
Unknown view (?). View does not exist in model (?). Check for typos or missing include statements.	IDE Ex SQL	explore 正在扩展缺少 view_name 参数的基础 explore，并且任何联接视图中的字段都引用了基础 explore 名称。 某个字段引用了拼写错误、不存在或未与适用的探索联接的视图。	extends（适用于 Explore） 确定 LookML 对象的范围和命名
Unknown field (?) in filter	IDE	原生派生表 (NDT) 定义包含 LookML 中未定义的自定义字段的 bind_all_filters 参数。 LookML 过滤条件引用了已注释掉或不存在的 LookML 字段。 LookML 过滤条件引用了其他视图中的 LookML 字段，但该字段未完全限定范围，也未加入到所有相关的 explore 参数中。	原生派生表 explore_source 参考 LookML 信息中心的 filters always_filter 参考文档 access_filter 参考文档 filters 适用于衡量指标
Measures with Looker aggregations (sum, average, min, max, list types) may not reference other measures.	IDE	某个指标在另一个汇总型指标的 SQL 定义中被引用。	衡量指标类型类别参考 错误：采用 Looker 汇总（总和、平均值、最小值、最大值、列表类型）的度量可能无法引用其他度量（最佳实践页面） 如何在 Looker 中将度量转化为维度（最佳实践页面）
Unknown view (?). View (?) does not exist in model (?). Check for typos or missing include statements in (?).	IDE	视图未包含在模型文件中，或者包含在模型文件中但拼写错误。	模型/视图/探索功能使用入门问题（社区帖子） include 模型参数参考文档
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 的值。	在 Looker 中测试数据库连接 包含导入项目中的文件 永久性派生表连接设置 BigQuery 连接的 OAuth Snowflake 连接的 OAuth
Unknown or excluded suggest_dimension (?) in field (?)	IDE	suggest_dimension 参数引用的字段不存在、已被注释掉，或者在探索中被 fields 参数排除。 suggest_dimension 参数引用的字段在另一个视图中定义，但在引用中未完全限定为 view_name.field_name。 suggest_dimension 参数引用了未联接到所有相关 explore 参数中的其他视图中的字段，或者引用了在 explore 中使用 from 参数别名的视图。	错误：字段未知或无法访问（“最佳实践”页面） suggest_dimension 参数参考 from（适用于 Explore） from（用于联接） fields（适用于 Explore） fields（用于联接）
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	文件路径中的拼写错误导致了错误。 文件夹引用使用了错误的语法。 项目导入参考使用的语法不正确。	include 模型参数参考文档 将 include 与 IDE 文件夹搭配使用 包含导入项目中的文件 引用导入项目中的文件
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored.	Ex	数据库方言不支持具有对称聚合的 type: median 或 type: percentile 度量。	并非所有数据库方言都支持具有对称汇总的 median 或 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 参数。	count 指标类型参考 如何统计非主键（社区帖子）
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（或模型文件）。 * 不建议在其他模型文件中包含模型文件。	explore 参数参考 在模型中包含模型
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml?	IDE	模型包含视图文件夹，但特定视图文件位于该文件夹之外。 如果视图的命名方式不同，模型会包含视图的名称，但不包含视图文件。 视图多次联接到 explore 中，但在第二次联接时缺少 from 参数。	将 include 与 IDE 文件夹搭配使用 include 参数参考 您可以使用 from 多次联接同一表
Unknown field '(?)'	IDE Ex	您尝试引用的字段不存在、拼写有误或已被注释掉。 被引用的字段是在其他视图中定义的，并且未限定其视图名称。 某个字段是在未联接到必需的“探索”中的其他视图中定义的，或者该视图在联接中被别名化，导致某些“探索”无法访问该字段。 required_fields 参数引用了无法访问、拼写错误、不存在或被注释掉的字段。	错误：字段未知或无法访问（“最佳实践”页面） from（适用于 Explore） from（用于联接） required_fields 参数参考
Cannot use (?) as access filter since any user can edit their own value.	Ex	在探索的 access_filter 参数中使用了将用户访问权限选项设置为修改的用户属性。	创建用户属性 在访问权限过滤条件中使用用户属性 access_filter 参数参考
label_from_parameter of (?) must refer to a parameter.	IDE Ex	label_from_parameter 参数引用的字段不存在、拼写有误或被注释掉了。 label_from_parameter 参数引用的字段存在，但不是 parameter 类型。	label_from_parameter 参数参考 parameter 参数参考
Cannot use user-editable attribute (?) for access_grant (?)	IDE Ex	在模型文件的 access_grant 参数中使用了将用户访问权限选项设置为修改的用户属性。	创建用户属性 通过访问权限授予控制访问权限 access_grant 参数参考
datagroup (?) has a sql_trigger. This is not allowed in models with a parameterized connection.	IDE	数据库连接使用用户属性作为数据库登录凭据，并且未为 PDT 进程配置单独的数据库用户，以用于 PDT 替换列。	在数据库连接中使用用户属性 为 PDT 进程配置单独的登录凭据 datagroup 和 sql_trigger 参数参考
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 参数的视图中定义的字段，或者该字段未限定为视图名称。	错误：字段未知或无法访问（“最佳实践”页面） 维度组必须通过其各个维度进行引用 always_filter 参数参考
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。	include 参数参考 将 include 与 IDE 文件夹搭配使用 extends（适用于 Explore） view_name 参数参考
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 应用发生了意外故障。	为 PDT 进程配置单独的登录凭据 连接池超时 Looker 启动选项 查询超时和排队 连接设置的其他参数（包括 JDBC 参数）
Looker is having trouble connecting to your database.	Ex SQL	连接已达到连接池上限，并且排队的查询在连接池超时窗口结束后已超时。	“Looker 无法连接到您的数据库”错误是什么意思？（社区帖子） “最大连接数”连接设置参考 连接池连接设置参考文档
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。	filters 参数参考 创建动态过滤的度量
Unknown source explore (?) in lookml test (?) declaration.	IDE	数据测试的 explore_source 子形参中使用了拼写错误、不存在或已注释掉的 Explore 名称。 数据测试定义在不包含或未包含在包含 Explore 的 explore_source 定义的文件中。 使用包含 extension: required 参数规范的探索作为数据测试的 explore_source。	test 参数参考 explore_source（用于数据测试） LookML 数据测试建议和最佳实践（社区帖子）
filter_expression: is not supported for measures of non-aggregate type '(?)'	IDE Ex	filters_expression 参数与以下以外的任何衡量类型搭配使用：count、sum、average 或 count_distinct。	filter_expression LookML 信息中心查询参数参考（适用于瀑布图） LookML 信息中心查询参数参考（适用于表格图表）
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 参数中引用度量或其他聚合	维度和度量字段 sql（适用于维度）
Cannot specify both sql_table_name and derived_table for view (?)	IDE	视图同时定义了 sql_table_name 和 derived_table 参数。视图只能引用一个表，即数据库连接中具有 sql_table_name 的现有架构，或具有 derived_table 的新表。	view 参数参考 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 参数的探索。	在决定是否保留派生表时应考虑的事项 access_filter 参数参考
Unknown or unexpected parameter "(?)" in (?).	IDE	distribution_style 参数用于不支持该参数的方言 cluster_keys 参数用于不支持该参数的方言 sql_always_where 参数是在 join 中定义的，而不是在 explore 中定义的。 dimension_group 中定义的时间段不是 type: time。 sql_distinct_key 参数是在维度中定义的，而不是在指标中定义的。	针对 distribution_style 的方言支持 针对 cluster_keys 的方言支持 dimension_group 字段类型参考 sql_distinct_key 参数参考
Could not find the constant	IDE	在导入项目中引用了导入项目中的常量，但该常量仅在导入项目中定义。常量只能在定义它们的项目中引用。需要在清单文件中重新定义常量。	在导入的项目中使用文件中的常量
Multiple primary key definitions for view '(?)': '(?)' and '(?)'	IDE	视图文件中存在多个主键。使用 primary_key: yes 将多个维度指定为主键，或者扩展视图使用 primary_key: yes 将新维度指定为主键。	primary_key 参数参考 extends（适用于视图） 通过 extends 重用代码
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 参数。	在决定是否保留派生表时应考虑的事项 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 的地图层。例如，一个视图包含在多个模型中，但地图图层仅在一个模型中定义。	map_layer 参数参考 map_layer_name 的内置地图图层
Persistent derived table (?) should include at least one index	IDE	PDT 或汇总表定义包含 index，但未指定 PDT 或汇总表列。	indexes 参数参考 永久性派生表参考 aggregate_table 参数参考
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 托管服务的维护政策