Looker 连接器要求、限制、功能支持和问题排查概览

本页介绍了 Looker Studio 中 Looker 连接器的以下主题：

Looker 实例要求

如需在 Looker 数据洞察中使用 Looker 连接器设置 Looker 数据源，请先验证您的 Looker 实例是否满足以下要求：

Looker 连接器的限制

Looker 连接器存在以下限制，这些限制可能会限制您可以连接到的 Looker 实例和模型的类型：

  • Looker 连接器无法连接到客户自托管 Looker 实例。
  • 如果 Looker 模型非常大（通常是指包含 100 个以上的探索），则在创建数据源的过程中可能会出现长时间的延迟或超时。
  • 查询超时时间为 5 分钟。在 Looker 数据源上运行的查询的结果最多只能包含 5,000 行。
  • 数据下载的行数上限为 5,000 行。

Looker Studio 功能支持

Looker 数据源可能不支持或仅部分支持以下 Looker Studio 功能：

  • 字段数量：您可以在表格可视化图表中添加最多 100 个维度和最多 100 个指标。
  • 数据下载、安排、提醒和导出：
    • 如果报告是使用 Looker (Google Cloud Core) 实例中的 Looker 数据构建的，且该实例使用专用 IP 网络连接或配置为使用 Virtual Private Cloud (VPC) IP 地址，则不支持下载、安排、提醒和数据导出。如需详细了解 Looker (Google Cloud Core) 实例的网络，请参阅 Looker (Google Cloud Core) 网络选项文档。
    • 如果 Looker（原始）实例配置为使用 IP 许可名单，则不支持使用该实例中的 Looker 数据构建的报告的下载、安排、提醒和数据导出功能。
  • 计算字段：使用 Looker 连接器创建的数据源支持一些 Looker Studio 函数，用于计算字段。这些函数只能应用于维度。

    计算字段支持的函数

    名称 类型 说明 语法
    ABS 算术 返回数字的绝对值。了解详情。 ABS(X)
    ACOS 算术 返回 X 的余弦的倒数。了解详情。 ACOS(X)
    ASIN 算术 返回 X 的正弦的倒数。了解详情。 ASIN(X)
    ATAN 算术 返回 X 的正切的倒数。了解详情。 ATAN(X)
    AVG 聚合 返回 X 的所有值的平均值。了解详情。 AVG(X)
    CASE (Simple) 基于条件 将 input_expression 与每个连续 WHEN 子句的 expression_to_match 进行比较，并在该比较运算返回 true 的情况下返回第一个 result。了解详情。 
        CASE input_expression
    WHEN expression_to_match THEN result
    [WHEN expression_to_match THEN result]
    [...]
    [ELSE result]
    END
    CASE 基于条件 计算每个连续 WHEN 子句的 condition，并在 condition 为 true 的情况下返回第一个 result；其余所有 WHEN 子句和 ELSE 子句均不进行计算。如果所有条件均为 false 或 NULL，则返回 else_result（如果有）；如果没有，则返回 NULL。了解详情。 
        CASE
    WHEN condition THEN result
    [WHEN condition THEN result]
    [...]
    [ELSE else_result]
    END
    CAST 其他 将字段或表达式转换为 TYPE。CAST 中不允许使用聚合字段。TYPE 可以是 NUMBER、TEXT 或 DATETIME。了解详情。 CAST(field_expression AS TYPE)
    CEIL 算术 返回大于 X 的最接近的整数。例如，如果 X 的值为 v，则 CEIL(X) 大于或等于 v。了解详情。 CEIL(X)
    COALESCE 基于条件 返回在字段列表中找到的第一个非缺失值。了解详情。 COALESCE(field_expression[,field_expression, ...])
    CONCAT 文本 返回 X 和 Y 的级联文本。了解详情。 CONCAT(X, Y)
    CONTAINS_TEXT 文本 如果 X 包含文本，则返回 true，否则返回 false。区分大小写。了解详情。 CONTAINS_TEXT(X, text)
    COS 算术 返回 X 的余弦值。了解详情。 COS(X)
    COUNT_DISTINCT 聚合 返回 X 的唯一值数量。了解详情。 COUNT_DISTINCT(X)
    CURRENT_DATE 日期 返回默认时区的当前日期。了解详情。 CURRENT_DATE()
    CURRENT_DATETIME 日期 返回默认时区的当前日期和时间。了解详情。 CURRENT_DATETIME()
    DATE 日期 使用数字或 Date & Time 字段或表达式构造 Date 字段或值。了解详情。 DATE(year, month, day)
    DATE_DIFF 日期 返回 X 和 Y 之间的天数差 (X - Y)。了解详情。 DATE_DIFF(X, Y)
    DATE_FROM_UNIX_DATE 日期 将整数解释为从 1970-01-01 算起的天数。了解详情。 DATE_FROM_UNIX_DATE(integer)
    DATETIME 日期 使用数字构造日期和时间字段或值。了解详情。 DATETIME(year, month, day, hour, minute, second)
    DATETIME_ADD 日期 给日期加上指定的时间间隔。接受的 part 值包括 SECOND、MINUTE、HOUR、DAY、MONTH、YEAR。了解详情。 DATETIME_ADD(datetime_expression, INTERVAL integer part)
    DATETIME_DIFF 日期 返回两个日期之间的部分边界值数量。接受的 part 值包括 SECOND、MINUTE、HOUR、DAY、MONTH、YEAR。了解详情。 DATETIME_DIFF(date_expression, date_expression, part)
    DATETIME_SUB 日期 从日期中减去指定的日期间隔。接受的 part 值包括 SECOND、MINUTE、HOUR、DAY、MONTH、YEAR。了解详情。 DATETIME_SUB(datetime_expression, INTERVAL integer part)
    DATETIME_TRUNC 日期 将日期截断为指定的粒度。接受的 part 值包括 SECOND、MINUTE、HOUR、DAY、MONTH、YEAR。了解详情。 DATETIME_TRUNC(date_expression, part)
    DAY 日期 返回日期或日期和时间中的天。了解详情。 Day(date_expression)
    EXTRACT 日期 返回日期或日期时间的一部分。接受的 part 值包括 DAY、MONTH、YEAR。了解详情。 EXTRACT(part FROM date_expression)
    FLOOR 算术 返回小于 X 的最接近的整数。例如，如果值 X 为 v，则 FLOOR(X) 小于或等于 v。了解详情。 FLOOR(X)
    HOUR 日期 返回日期和时间的小时。了解详情。 HOUR(datetime_expression)
    IF 基于条件 如果 condition 为 true，则返回 true_result，否则返回 false_result。如果 condition 为 true，则不计算 false_result。如果 condition 为 false 或 NULL，则不计算 true_result。了解详情。 IF(condition, true_result, false_result)
    IFNULL 基于条件 如果输入为 null，则返回结果；否则，返回输入。了解详情。 IFNULL(input_expression, null_result)
    LEFT_TEXT  文本 返回 X 开头的一些字符。字符数由 length 指定。了解详情。 LEFT_TEXT(X, length)
    LENGTH 文本 返回 X 中的字符数。了解详情。 LENGTH(X)
    LOG 算术 返回 X 以 2 为底的对数。了解详情。 LOG(X)
    LOG10 算术 返回 X 以 10 为底的对数。了解详情。 LOG10(X)
    LOWER 文本 将 X 转换为小写。了解详情。 LOWER(X)
    MAX 聚合 返回 X 的最大值。了解详情。 MAX(X)
    MEDIAN 聚合 返回 X 的所有值的中位数。了解详情。 MEDIAN(X)
    MIN 聚合 返回 X 的最小值。了解详情。 MIN(X)
    MINUTE 日期 返回给定日期和时间的分钟部分。了解详情。 MINUTE(datetime_expression)
    MONTH 日期 从 Date & Time 值返回月份。了解详情。 MONTH(date_expression)
    NULLIF 基于条件 如果输入与表达式匹配，则返回 NULL，否则返回输入。了解详情。 NULLIF(input_expression, expression_to_match)
    POWER 算术 返回 X 的 Y 次幂的结果。了解详情。 POWER(X, Y)
    REPLACE 文本 返回 X 的副本，其中 X 中出现的所有 Y 都替换为 Z。了解详情。 REPLACE(X, Y, Z)
    RIGHT_TEXT  文本 返回 X 末尾的一些字符。字符数由 length 指定。了解详情。 RIGHT_TEXT(X, length)
    ROUND 算术 返回四舍五入到 Y 位精度的 X。了解详情。 ROUND(X, Y)
    SECOND 日期 返回给定日期和时间的秒数部分。了解详情。 SECOND(datetime_expression)
    SIN 算术 返回 X 的正弦值。了解详情。 SIN(X)
    SQRT 算术 返回 X 的平方根。请注意，X 必须为非负数。了解详情。 SQRT(X)
    SUBSTR 文本 返回 X 的子字符串。子字符串从 start index 开始，长度为 length 个字符。了解详情。 SUBSTR(X, start index, length)
    SUM 聚合 返回 X 的所有值的总和。了解详情。 SUM(X)
    TAN 算术 返回 X 的正切值。了解详情。 TAN(X)
    TODAY 日期 返回默认时区的当前日期。了解详情。 TODAY()
    UNIX_DATE 日期 返回自 1970-01-01 以来的天数。了解详情。 UNIX_DATE(date_expression)
    UPPER 文本 将 X 转换为大写。了解详情。 UPPER(X)
    YEAR 日期 返回指定日期的年份。了解详情。 YEAR(Date)

问题排查

问题 解决方法
Looker Studio 会显示以下错误消息：需要授权 授权 Looker 连接器关联所有必需的账号，如在 Looker Studio 中查看 Looker 数据并与之互动文档中所述。
Looker Studio 显示 HTTP 400 错误
Looker Studio 显示以下错误消息：无法连接到 Looker 实例
  • 确认 Looker 实例网址正确无误，且没有尾随空格。
  • Looker 连接器仅适用于 Looker 实例的特定配置和版本。
  • 启用了启用许可名单功能的 Looker（原始）实例可能需要进行特殊设置 - 请与支持团队联系。
  • 确认 Looker 实例中的 API 主机网址已正确配置。
Looker Studio 显示以下错误消息：未找到任何探索 选择其他 Looker 模型。
现有报告图表损坏
Looker 数据洞察尝试提取“探索”数据时显示错误 您可以与支持团队联系，也可以访问 Looker Studio 社区。
图表未在下载的报告中呈现 请让 Looker 管理员授予您数据源（即 Looker 探索）的基础 LookML 模型的 download_with_limit 或 download_without_limit 权限。此权限仅适用于 Looker Studio Pro 用户。
图表未在导出的文件中呈现 请让 Looker 管理员授予您数据源（即 Looker 探索）的基础 LookML 模型的 download_with_limit 或 download_without_limit 权限。此权限仅适用于 Looker Studio Pro 用户。
图表未在预定发送的报告中呈现 如果您是报告的接收者，则表示您的 Looker 权限不足，无法查看所接收报告中引用的至少一个模型。请让您的 Looker 管理员授予您数据源的基础 LookML 模型的 schedule_look_emails 权限。此权限仅适用于 Looker Studio Pro 用户。

如果您是报告收件人，并收到了此消息，请通知报告发件人。
下载报告时，Looker Studio 会显示以下错误：

由于缺少权限，部分使用 Looker 模型的图表将无法下载。请让您的 Looker 管理员授予权限。		 请让 Looker 管理员向您授予报告的底层 LookML 模型的 download_with_limit 或 download_without_limit 权限。此权限仅适用于 Looker Studio Pro 用户。
在安排报告发送时间时，Looker Studio 会显示以下错误：

由于缺少权限，定期生成的报告中将缺少部分使用 Looker 数据的图表。请让您的 Looker 管理员授予权限。 		请让您的 Looker 管理员向您授予报告的底层 LookML 模型的 schedule_look_emails 权限。此权限仅适用于 Looker Studio Pro 用户。
Looker Studio 会在报告安排列表中显示以下错误：

您发送的报告中可能缺少部分 Looker 数据。请让您的 Looker 管理员授予权限，以便在此报告中发送所有数据。		 请让您的 Looker 管理员向您授予报告的底层 LookML 模型的 schedule_look_emails 权限。此权限仅适用于 Looker Studio Pro 用户。

报告问题

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

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

如果您使用的是免费版 Looker Studio，请在 Looker Studio 社区中发布您的问题。