Looker 错误目录

下表汇总了 Looker 中显示的一些常见错误消息、解释了这些消息的根本原因及出现这些消息的位置，以及问题排查资源。系统会根据向 Looker 支持团队报告这些错误的频率显示错误，这些错误会按降序排列，支持请求数量最多的放在顶部。

Location 列指明了错误消息在 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 不兼容。例如：{% dynamic if parameters.change_value._parameter_value == "'AA'" %}。查看 parameter type，确保能够正确计算值（type: string 与 type: unquoted）。 字段在 Liquid 中正确引用为 view_name.field_name，但 field_name 未在限定了作用域的视图 view_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 参数的其他视图中的字段，或者引用在具有 from 参数的 explore 中别名的视图。	错误：未知或无法访问的字段（最佳实践页面） 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	文件的路径中的拼写错误会导致 en 错误。 文件夹引用使用的语法不正确。 项目导入引用使用的语法不正确。	include 模型参数参考 将 include 与 IDE 文件夹搭配使用 包含导入项目中的文件 引用已导入项目中的文件
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored.	Ex	数据库方言不支持使用对称聚合来衡量 type: median 或 type: percentile。	并非所有数据库方言都支持具有对称聚合的 median 或 percentile 测量类型 了解对称聚合（“最佳实践”页面）
Using project_name or local_dependency in manifest.lkml without Local Project Import enabled is not supported. Params ignored.	IDE	停用 Local Project Import Labs 功能时，清单文件中使用本地项目导入参数。除非启用了 Local Project Import Labs 功能，否则不能在清单文件中使用本地项目导入参数。	project_name 参数参考 local_dependency 参数参考 本地项目导入实验室功能
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，它需要一个或多个 sql_step 子参数。 即使已添加 sql_step，缓存的 LookML 验证工具错误也标记了缺少 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 扩展了另一个 explore，但后者缺少用于指定基本视图的 view_name 参数。	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	在 type: location 的字段中使用了 sql 参数。位置类型字段需要 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 无法连接到您的数据库”错误是什么意思？（社区帖子） 最大连接数连接设置参考 连接池连接设置参考
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（适用于视图） 通过扩展重复使用代码
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 实例在预定作业运行期间不可用。在版本更新和计划维护期间可能会发生这种情况。	针对 Looker 托管的服务的 Google 维护政策