Looker 错误目录

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

下表汇总了 Looker 中显示的一些常见错误消息，以及其根本原因和出现位置的说明，以及排查资源。错误的显示顺序是按向 Looker 支持团队报告的频率降序排列的，支持请求数量最多的错误会显示在顶部。

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

IDE = LookML 验证器/IDE

Ex = 探索

SQL = SQL Runner

LD = LookML 信息中心

D = 信息中心

S = 时间表

错误消息	位置	可能的原因	问题排查资源
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，但 view_name 范围内的视图中未定义 field_name，或者该视图在探索中使用 from 作为别名。 对变量的 Liquid 引用未定义，或引用包含拼写错误。 Liquid 引用包含 type: time 维度组，但不包含具体时间范围。例如，引用应使用 {{ view_name.creation_date_year }}，而不是 {{ view_name.creation_date }}。 某个字段使用了带有 LookML 替换运算符语法（${view_name.field_name}）的 Liquid，而不是不带（view_name.field_name）。	Liquid 变量参考 基于模板的过滤条件和派生表（社区帖子） from（适用于探索） from（用于联接） 必须通过各个维度来引用维度组
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?).	IDE	引用的视图不存在。 缺少联接，导致某些探索无法访问该视图。 在“探索”中，使用 from 参数重命名视图。	错误：字段未知或无法访问（“最佳做法”页面） from（适用于探索） 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（适用于探索） fields（用于联接） 必须通过各个维度来引用维度组
Unknown view (?).	IDE Ex SQL	模型文件中未包含视图。 explore 正在扩展缺少 view_name 参数的基本 explore。 explore 参数中定义的探索名称基于拼写错误或不存在的视图名称。 基于模型的 SQL Runner 查询正在运行，但所选的模型不正确。	include 模型参数参考文档 extends（适用于探索） 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（适用于探索） 限定和命名 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 方言（如果与用于编写该代码的方言不同）。 为 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（适用于探索） from（用于联接） fields（适用于探索） 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 参数中定义的探索以外的一个或多个探索联接。	使用 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 参数参考 在模型中包含模型
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml?	IDE	模型包含视图文件夹，但特定视图文件位于该文件夹之外。 模型包含视图的名称，但不包含视图文件（如果名称不同）。 视图多次联接到 explore，但在第二次联接时缺少 from 参数。	将 include 与 IDE 文件夹搭配使用 include 参数参考 您可以使用 from 多次联接同一表
Unknown field '(?)'	IDE Ex	您尝试引用的字段不存在、拼写有误或已注释掉。 引用的字段是在其他视图中定义的，并且未使用其视图名称进行限定。 字段是在未联接到必要探索的其他视图中定义的，或者视图在联接中被别名化，导致某些探索无法访问该字段。 required_fields 参数引用了无法访问、拼写有误、不存在或已注释掉的字段。	错误：字段未知或无法访问（“最佳做法”页面） from（适用于探索） 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	未在管理面板的连接设置页面上为连接设置 Persistent Derived Tables 设置，并且/或者 Temp Database 设置中未指定临时数据库架构。	永久性派生表连接设置参考 临时数据库连接设置参考文档
Can't construct aggregate table (?), connection (?) could not be registered.	IDE Ex	未在管理面板中连接的连接设置页面上设置 Temp Database 设置，或者 Looker 没有对 Temp Database 设置中指定的临时数据库的适当权限。	汇总表必须持久化 临时数据库连接设置参考文档
Unknown view (?) referenced by explore (?)	IDE	使用默认的 include: "*.view.lkml" 包含视图，但视图位于其他文件夹中。 include 语句中的视图名称或文件路径拼写有误，或者 include 语句包含视图的名称，但不包含视图文件（如果名称不同）。 文件夹中存在特殊字符（例如 _views）问题。 一个 explore 正在扩展另一个缺少用于指定基视图的 view_name 参数的 explore。	include 参数参考 将 include 与 IDE 文件夹搭配使用 extends（适用于探索） 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_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 或汇总表定义包含尚未指定 PDT 或汇总表列的 index。	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 托管服务的维护政策