排查 Looker 连接器出现的错误

本页面介绍了数据洞察中的 Looker 连接器的以下主题:

Looker 连接器出错提示和建议的解决方法

在数据洞察中使用 Looker 连接器时,您可能会遇到以下错误:

身份验证和授权
问题说明或出错提示 解释 建议的解决方案
数据洞察会显示以下出错提示:

No dataset access

Couldn't access the underlying data set due to insufficient permissions

Session has expired or lacks credentials. This includes expired OAuth grants. Try logging in again.
您对 Looker 实例的授权已过期或已被撤销。 修改数据洞察数据源,然后点击重新连接。
数据洞察会显示以下出错提示:

No dataset access

Couldn't access the underlying data set due to insufficient permissions

Couldn't query a specific database table due to lack of permissions
您的 Looker 权限不足,无法查询 Looker 探索。 请与您的 Looker 管理员联系,让其授予您适当的权限,以便查询探索所基于的模型。
数据洞察会显示以下出错提示:

Authorization Required
您必须关联 Looker 账号和数据洞察账号,才能在数据洞察中查看 Looker 数据。 如在数据洞察中查看 Looker 数据并与之交互文档中所述,授权 Looker 连接器关联任何必要的账号。
下载的报告中不显示图表 如需下载基于一个或多个 Looker 探索的报告,您必须对探索所基于的一个或多个底层 LookML 模型拥有 download_with_limit 或 download_without_limit 权限。 请让您的 Looker 管理员为您授予一个角色,该角色对报告探索所依据的 LookML 模型具有 download_with_limit 或 download_without_limit 权限。这些权限仅适用于数据洞察 Pro 用户。
图表未在导出的文件中呈现 如需查看导出的报告中的图表,您必须对底层 LookML 模型或探索底层的模型拥有 download_with_limit 或 download_without_limit 权限。 请让您的 Looker 管理员为您授予一个角色,该角色对报告探索所依据的 LookML 模型具有 download_with_limit 或 download_without_limit 权限。这些权限仅适用于数据洞察 Pro 用户。
图表未在定期生成的报告中呈现 如需在定期生成的报告中查看图表,您必须对探索所基于的一个或多个底层 LookML 模型拥有 download_with_limit 或 download_without_limit 权限。 如果您是报告递送的所有者,则表示您的 Looker 权限不足,无法查看递送的报告中引用的至少一个模型。请让您的 Looker 管理员为您授予一个角色,该角色需包含对报告探索所基于的 LookML 模型的 schedule_look_emails 权限。此权限仅适用于数据洞察 Pro 用户。

如果您是报告接收者并收到此消息,请通知报告发送者。
当您下载报告时,数据洞察会显示以下出错提示:

Due to lack of permissions, some charts using Looker models will not download. Ask your Looker admin to grant permissions.
如需在下载的报告中查看图表,您必须拥有对探索所基于的一个或多个 LookML 模型具有 download_with_limit 或 download_without_limit 权限的角色。 请让您的 Looker 管理员为您授予一个角色,该角色包含对报告底层 LookML 模型的 download_with_limit 或 download_without_limit 权限。这些权限仅适用于数据洞察 Pro 用户。
在您安排定期发送报告时,数据洞察会显示以下出错提示:

Due to lack of permissions, some charts using Looker data will be missing from your scheduled report. Ask your Looker admin to grant permissions.
如需安排定期生成的报告递送,您必须拥有一个角色,该角色对探索所基于的一个或多个底层 LookML 模型具有 schedule_look_emails 权限。 请让您的 Looker 管理员为您授予一个角色,该角色需包含对报告底层 LookML 模型的 schedule_look_emails 权限。此权限仅适用于数据洞察 Pro 用户。
在设置报告生成时间列表中,数据洞察会显示以下出错提示:

Some Looker data may be missing from your report deliveries. Ask your Looker admin to grant permissions to deliver all data in this report.
如需查看定期生成的报告中的图表,您必须拥有一个角色,该角色对探索所基于的基础 LookML 模型具有 schedule_look_emails 权限。 请让您的 Looker 管理员为您授予一个角色,该角色需包含对报告底层 LookML 模型的 schedule_look_emails 权限。此权限仅适用于数据洞察 Pro 用户。
连接
问题说明或出错提示 解释 建议的解决方案
数据洞察会显示以下出错提示:

Looker connection failed
数据洞察无法连接到您指定的 Looker 实例
  • 确认 Looker 实例网址正确无误,并且没有尾随空格。
  • Looker 连接器仅适用于特定配置和版本的 Looker 实例。
  • 启用了启用许可清单功能的 Looker(原始版本)实例可能需要进行特殊设置 - 请与支持团队联系。
  • 确认 Looker 实例中的 API 主机网址配置正确。
数据洞察显示 HTTP 400 错误 Looker 服务器无法处理数据洞察的连接请求,因为它将该请求解读为格式不正确或无效。
您已创建的报告中的图表已损坏 与 Looker 实例的连接发生了变化。
  • 修改数据洞察数据源,然后点击重新连接。
  • 确认 Looker 实例中已启用数据洞察连接器。
  • 启用了启用许可清单功能的 Looker 实例可能需要进行特殊设置 - 与支持团队联系。
  • 确认 Looker 实例的 API 端点配置正确。
数据配置
问题说明或出错提示 解释 建议的解决方案
数据洞察会显示以下出错提示:

Couldn't complete the report query

Data Studio couldn't get data from the Explore. Reach out to your admin for more information.
数据洞察预期从 Looker 探索中接收的数据结构可能与实际接收的数据结构不一致。数据洞察无法解析或显示数据,因为数据格式不正确、不完整或结构不符合预期。
  • 在数据洞察数据源中,点击修改连接,然后点击刷新字段。
  • 在 Looker 探索中运行相同的查询。如果查询失败,则问题出在 Looker 本身,需要由 Looker 开发者解决。
数据洞察会显示以下出错提示:

LookML model configuration error
数据洞察无法运行查询,因为指定的 LookML 模型或视图不存在,或者未正确配置。 验证 Looker 探索的基础 LookML 是否正确,然后重试查询。
数据洞察会显示以下出错提示:

Invalid filter expression
过滤表达式中的语法、逻辑或字段引用不正确。 请检查过滤表达式,然后重试查询。
数据洞察会显示以下出错提示:

Couldn't complete the report query

A filter is not allowed by the LookML model configuration.
查询中的过滤表达式受到 Looker 探索的基础 LookML 的明确限制。LookML 可能包含 always_filter 参数,该参数要求对字段进行过滤、提供过滤建议或允许的值(限制您可用于该过滤条件的值),或完全禁止对字段进行过滤。 LookML 运行正常。如果该限制导致您无法进行必要的分析,请与您的 Looker 管理员或开发者联系。他们或许能够调整 LookML,以适应您的应用场景。
数据洞察会显示以下出错提示:

No Explores found
您选择的模型可能没有任何关联的“探索”,或者您可能无权访问其“探索”。 请选择其他 Looker 模型,或让 Looker 管理员授予您访问 LookML 模型的权限。
查询配置
问题说明或出错提示 解释 建议的解决方案
数据洞察会显示以下出错提示:

Query timed out
数据洞察已成功将查询发送到 Looker,但 Looker 与数据底层数据库(如 BigQuery、Redshift 或 Snowflake)的连接超时,导致数据库无法完成查询并返回数据。 如果超时是由过于复杂的查询引起的,请尝试简化查询,方法是应用更严格的过滤条件、减少图表中的维度和测量数量,或者尽可能使用更多汇总指标和更少的原始、精细维度。
数据洞察会显示以下出错提示:

Query limit exceeded
查询结果集过大,Looker 无法以增量方式进行流式传输。 请减少行数,然后重试,或与您的管理员联系以调整流式传输设置。
数据洞察会显示以下出错提示:

Couldn't complete the report query

Data Studio couldn't get data from the Explore. Reach out to your admin for more information.
报告查询可能包含语法错误(例如意外字符)、错放的关键字或不正确的结构。数据库无法解析该查询,或者由于管理员设置的限制或条件,该查询未能运行。 检查您手动输入的任何字段的语法,然后重试查询。
数据洞察会显示以下出错提示:

Database connection timed out

The connection to the underlying database within Looker timed out before completing the query
Looker 与数据底层数据库(例如 BigQuery、Redshift 或 Snowflake)的连接已超时。 请稍后再次尝试同一查询,以防查询超时是由数据库负载引起的。

如果此错误仍然存在,请与您的 Looker 管理员联系,让其提高数据库连接超时限制。
刷新统计信息摘要图表可视化图表(例如包含年同比比较指标的统计信息摘要图表)时,数据洞察无法呈现图表,并且底层 BigQuery 查询会返回以下出错提示:

Query execution failed: - Operands of >= cannot be literal NULL
Looker 探索的基础 LookML 使用 Liquid 日期变量(例如 {% date_start FILTER_NAME %} 或 {% date_end FILTER_NAME %})来引用日期过滤条件。在刷新期间,Looker 连接器可能无法始终如一地将过滤条件上下文传递给统计信息图表可视化图表。因此,Liquid 表达式的求值结果为 NULL,这会在 BigQuery 中生成无效的 SQL 比较(例如 DATE_FIELD >= NULL)。 请让您的 Looker 开发者更新 LookML 定义,以便使用 Liquid condition 标记(而非直接使用 Liquid 变量替换)来设置日期过滤条件(例如 {% condition DATE_FILTER %} ${DATE_FIELD} {% endcondition %})。

condition 标记通过生成适当的比较逻辑或在值为空时回退到 1=1 来处理未解析的过滤条件值,而不是插入字面量 NULL。

报告问题

向支持团队报告 Looker 连接器的问题。

如果您是数据洞察 Pro 客户,并且遇到与 Looker 连接器以外的数据洞察功能相关的问题,请与 Cloud Customer Care 联系。

如果您使用的是免费版数据洞察,请在数据洞察社区中发布您的问题。