Looker-Power BI 连接器

借助 Looker 与 Power BI 的连接器，您可以使用 Microsoft Power BI Desktop 连接到 Looker 探索中的数据。

设置 Power BI Desktop 以连接到 Looker

使用 Looker 与 Power BI 连接器的一般步骤如下：

  1. 检查要求。
  2. 在 Looker 实例上启用连接器。
  3. 下载并保存连接器文件：每个想要访问 Looker-Power BI 连接器的用户都必须下载 looker_1.4.0.mez 文件，并将其保存在计算机上的特定目录中。
  4. 为自定义连接器设置 Power BI Desktop：每个 Power BI 用户都必须配置其 Power BI Desktop 安全设置，才能使用未经认证的自定义连接器。

本页中的各部分将详细介绍这些步骤。

完成将 Looker 与 Power BI Desktop 连接的步骤后，您可以从 Power BI 连接到 Looker 数据，并在 Power BI 中发布报告。您可以选择使用 Power BI 服务（Power BI 在线版）在网络浏览器中与 Looker 报告互动。您还可以使用行级安全性通过 Power BI 服务发布报告。

要求

如需设置 Looker 与 Power BI 的连接器，您需要满足以下要求：

  • 计算机上安装了 Microsoft Power BI Desktop。
  • 满足以下要求的 Looker 实例：
    • 该实例必须由 Looker 托管。（Looker [Google Cloud Core] 实例由 Looker 托管，并支持 Looker 与 Power BI 之间的连接器。）
    • 实例必须运行 Looker 23.10 或更高版本。
  • Looker 实例中具有 explore 权限的 Looker 用户账号，此权限是访问 Looker 中的探索所必需的。如果您要处理行数超过 5,000 的查询，还需要拥有 download_without_limit 权限（如需了解下载限制，请参阅查询行数限制）。

在 Looker 实例上启用连接器

您要与 Looker-Power BI 连接器搭配使用的 Looker 实例必须启用 Microsoft Power BI 连接器：

  • 对于 Looker (Google Cloud Core) 实例，BI 连接器默认处于启用状态。
  • 对于 Looker（原始版本）实例，BI 连接器默认处于停用状态。

Looker 管理员可以在 Looker 管理菜单的平台部分中的 BI 连接器面板中启用 BI 连接器。

下载并保存连接器文件

如需下载连接器文件，请在安装了 Microsoft Power BI Desktop 的计算机上按以下步骤操作：

  1. 如需下载连接器文件，请点击以下链接：looker_1.4.0.mez
  2. 下载完成后，将 looker_1.4.0.mez 文件移至 [Documents]\Microsoft Power BI Desktop\Custom Connectors 目录。（如果这些文件夹尚不存在，请在计算机上创建这些文件夹。）

为自定义连接器设置 Power BI Desktop

如需在 Power BI Desktop 端设置 Looker-Power BI 连接器，请按照 Microsoft Power BI 网站上的自定义连接器说明操作。

如说明所述，在数据扩展下，您将选择（不推荐）允许任何扩展程序在未经验证或警告的情况下加载选项。选择 OK（确定），然后重启 Power BI Desktop。

从 Power BI Desktop 连接到 Looker 数据

下载 looker_1.4.0.mez 连接器文件并为 自定义连接器设置 Power BI Desktop 应用后，您就可以使用 Power BI Desktop 连接到 Looker 实例中的数据：

  1. 在 Power BI Desktop 工具栏中，依次选择获取数据 > 更多...
  2. 在获取数据对话框中，在搜索字段中输入 Looker。
  3. 在搜索结果中，点击 Looker 条目，然后点击 Connect（连接）。
  4. 在连接到第三方服务对话框中，点击继续。
  5. Power BI Desktop 会显示 Looker 登录对话框。在 Host 字段中，输入实例的网址。例如：example.cloud.looker.com。
  6. （可选）使用停用预览优化下拉菜单停用预览优化功能。

  7. （可选）使用显示隐藏字段下拉菜单，添加在 LookML 中配置为隐藏的字段：

    • FALSE（默认）：隐藏的字段会被忽略。
    • TRUE：系统会显示隐藏的字段。

  8. 选择 DirectQuery 选项，以在 Looker 上创建与数据的实时连接。

  9. 点击确定。

  10. 在 Looker 对话框中，点击登录。

  11. 在 Looker 登录界面中，登录您的 Looker 实例。

  12. Power BI Desktop 将返回 Looker 登录对话框，并显示一条消息，告知您已登录。点击连接。

  13. Power BI Desktop 会显示您有权访问的 Looker 模型的列表，每个模型都表示为一个文件夹。点击要访问的 Looker 模型，然后选中要加载到 Power BI Desktop 中的 Looker 探索旁边的复选框。如需查看某个模型，您必须拥有对包含该模型的模型集的 Looker 用户访问权限或群组访问权限。如需访问探索，您必须拥有 Looker explore 权限。

  14. 点击加载。

Power BI Desktop 会在其数据窗格中填充所选探索中的字段。然后，您可以使用探索中的 Looker 数据在 Power BI Desktop 中创建报告。如需了解 Looker 与 Power BI 连接器如何显示 Looker 元素，请参阅在 Power BI Desktop 中查看 Looker 元素。

字段名称将以 ViewName.FieldName 的格式显示在单个列表中。

预览优化

Power BI Desktop 通常会运行一个预览查询，该查询会返回数据的前 200 行（预览基本上是 SELECT * LIMIT 200 查询）。对于 Looker 探索，这可能是一个非常大的查询，因为 Looker 探索可能涉及许多联接和数百个字段。虽然 LIMIT 200 参数会将预览查询的结果限制为 200 行，但预览查询会对数据库发起全表扫描。

Looker 与 Power BI 的连接器使用预览优化功能，以防止 Power BI Desktop 在连接到 Looker Explore 时运行预览查询。启用预览优化功能（默认）后，Looker-Power BI 连接器会停用 Power BI Desktop 的预览查询，因此 Power BI Desktop 会针对预览查询返回一个空表。如果您希望 Power BI Desktop 对 Looker Explore 运行预览查询，可以停用预览优化功能。

如需启用 Power BI Desktop 的预览查询，请在从 Power BI Desktop 连接到 Looker 数据时将停用预览优化值设置为 TRUE。

在 Power BI Desktop 中查看 Looker 元素

从 Power BI Desktop 连接到 Looker 数据后，Power BI Desktop 会在其数据窗格中填充所选探索中的字段。

Looker 与 Power BI 的连接器使用以下格式在 Power BI Desktop 中显示 Looker 字段：

ViewName.FieldType.FieldName

  • ViewName 值是定义该字段的 LookML 视图。

  • FieldType 值可以是 Looker-Power BI 连接器支持的以下类型之一：

    • dim：维度，表示属性、事实或值（例如日期、名称和 ID）的字段。维度通常对应于底层数据表中的列。在 LookML 中，维度是使用 dimension 参数定义的。
    • mea：测量，一个字段，用于表示与数据相关的可衡量信息，例如总和、计数、平均值、最小值和最大值。在 LookML 中，测量值是使用 measure 参数定义的。
    • fil：过滤条件，仅用于在探索查询中创建过滤条件的过滤条件字段；过滤条件字段不会包含在查询的结果集中。在 LookML 中，过滤条件是使用 filter 参数定义的。
    • par：参数，此字段仅用于在探索查询中创建过滤条件；参数字段不包含在查询的结果集中。使用 {% parameter parameter_name %} 和 parameter_name._parameter_value Liquid 变量定义参数后，该参数可以创建交互式查询结果、标签、网址等。在 LookML 中，参数是使用 parameter 参数定义的。

  • FieldName 值是 Looker 探索中显示的字段名称。

Power BI Desktop 中显示的 Looker 元素与 Looker Explore 中显示的元素完全相同，大写和单词间距也相同。例如，如果 Looker Explore 显示的某个 LookML 维度为 Created Date，而该维度来自显示为 Order Items 的视图，则 Power BI Desktop 会将此字段显示为 Order Items.dim.Created Date。

使用 Looker 维度和测量创建查询

借助 Looker 与 Power BI 的连接器，您可以使用 Looker 维度和测量在 Power BI Desktop 中创建查询。

如需在 Power BI Desktop 中使用 Looker 维度和测量值创建查询，请按以下步骤操作：

  1. 从 Power BI Desktop 连接到 Looker 数据，然后等待 Power BI 在其数据窗格中填充所选 Looker Explore 中的字段。
  2. 在 Power BI 的数据窗格中，选中您要添加到查询中的每个 Looker 维度或指标对应的复选框。

当您选择每个维度或测量值时，Power BI 会更新报告画布中显示的查询。

使用 Looker 过滤条件和参数过滤查询

借助 Looker 与 Power BI 的连接器，您可以使用 Looker 探索中的 LookML 参数和仅限过滤条件的字段，向 Power BI 报告添加过滤条件。

如需在 Power BI Desktop 中使用 Looker 参数和仅限过滤条件的字段过滤报告，请按以下步骤操作：

  1. 如果您尚未从 Power BI Desktop 关联到 Looker 数据，请等待 Power BI 使用您所选 Looker Explore 中的字段填充其数据窗格。

  2. 在 Power BI 的数据窗格中，将参数或仅限过滤条件的字段的名称拖动到过滤条件窗格中的在此页面上应用的过滤条件或在所有页面上应用的过滤条件的在此处添加数据字段框中。如需详细了解如何在 Power BI 中向报告添加过滤条件，请参阅 Power BI 文档。

请注意以下有关在 Power BI 中使用 Looker 参数和仅限过滤条件的字段的信息：

  • 对于在 LookML 中使用 suggestions 参数或 suggest_dimension 参数配置的仅限过滤条件的字段，Power BI 会提取建议值，并将其显示在过滤条件窗格中的基本过滤选项中。

  • 对于在 LookML 中使用 allowed_value 属性配置的参数，Power BI 会提取为该参数在 LookML 中配置的所有允许值，并将其显示在过滤器窗格中的基本过滤选项中。

监控 Looker-Power BI 连接器

Looker 管理员可以使用系统活动历史记录探索中的 Query API Client Properties 字段组查看 Looker 与 Power BI 连接器的使用情况。每次运行新查询时，系统都会在历史记录“探索”中创建一条条目。

在 Query API Client Properties 字段组中，API Client Name 会显示 Power BI 值，以标识 Looker-Power BI 连接器条目。

以下是显示 Power BI 使用情况的系统活动网址示例。将 <instance_name.looker.com> 替换为您的实例网址。

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.name]=Power+BI&sorts=history.created_time_of_day+desc&limit=5000

Power BI 服务

从 Power BI 连接到 Looker 数据并在 Power BI 中发布报告后，您可以选择使用 Power BI 服务（Power BI 在线版）在网络浏览器中与 Looker 报告互动。

您还可以使用行级安全性通过 Power BI 服务发布报告。

使用行级安全性通过 Power BI 服务发布报告

使用 Looker-Power BI 连接器在 Power BI Desktop 中发布报告后，您可以选择使用 Power BI 服务通过网络浏览器与报告互动。

借助 Power BI Desktop，您可以使用行级安全性 (RLS) 限制特定用户对数据的访问权限。如需了解在 Power BI Desktop 中定义角色和规则以及验证角色的流程，请参阅 Power BI 文档。

在 Power BI Desktop 中定义角色后，您就可以在线使用 Power BI 服务中的角色和规则。

如需使用行级安全功能通过 Power BI 服务发布报告，请按以下步骤操作：

  1. 在 Power BI Desktop 中，打开您的报告，然后选择窗口顶部的首页菜单。
  2. 从首页菜单中选择发布选项。
  3. 从下拉菜单中选择一个工作区，然后点击选择。Power BI Desktop 会显示一条成功消息，其中包含用于在 Power BI 中打开报告的链接。
  4. 点击链接以打开 Power BI。
  5. 在 Power BI 服务中，前往工作区，然后选择您发布报告的工作区。
  6. 找到报告数据集（而非报告本身）的详情。
  7. 在数据集的列表中，点击三点状图标 More options（更多选项），然后选择 Security（安全）。

Power BI 将显示行级安全性窗口。在这里，您可以选择在 Power BI Desktop 中创建的角色，添加属于该角色的用户或群组，以及在 Power BI 服务中验证您的角色。

现在，您可以与任何人共享报告，并且对方只能看到他们有权查看的数据（具体取决于您创建的角色）。

需要考虑的事项

查询行数限制

除非 Looker 用户账号具有 download_without_limit 权限，否则 Looker 与 Power BI 连接器的查询将自动包含 LIMIT 5000 语句。如果 Looker 用户账号具有 download_without_limit，则 Looker-Power BI 连接器中的查询不会受到查询行数限制。

浏览过滤条件

如果使用 always_filter 或 conditionally_filter LookML 参数定义了 Looker Explore，则过滤条件将应用于 Looker-Power BI 连接器中的查询，即使过滤条件不会显示在 Power BI 中也是如此。

支持的维度组时间范围

对于 type: time 的 dimension_group，Looker 与 Power BI 连接器仅支持 date 和 time 时间范围。其他时间范围将被隐藏。

已知限制

以下是 Looker-Power BI 连接器的已知限制：

  • 数字维度和测量结果都会呈现为测量结果（如需了解维度和测量结果，请参阅“维度和测量结果”字段）。如需将数值维度用作维度，您必须先在 Power BI Desktop 中将其更改为未汇总。
  • 为确保获得最佳性能和功能，请尽可能使用 DirectQuery 模式。将 Power BI 导入模式与 Looker-Power BI 连接器搭配使用时，请注意以下限制：
    • 尝试访问较大模型的导入模式报告可能会出现性能下降。
    • 如果“获取数据”流程未解析或超时，请改用 DirectQuery 模式以提高性能和可靠性。
    • 如果您使用的是“导入”模式，请勿使用仅限过滤条件的字段和参数字段，因为这些字段在“导入”模式下处于停用状态。
    • 在“导入”模式下，Looker 无法在“探索”中正确评估指标。此限制可能会影响报告的准确性和功能。
  • Power BI 会尝试对 Looker 测量值应用自己的汇总，这有时会导致结果不一致（尤其是在您使用矩阵可视化图表时），或者导致汇总因缺少等效映射而无法正常运行。
    • 在 Power BI 报告中，请仅使用以下受支持的测量类型：average、count、count-distinct、max、min、sum。
    • 不支持查询标准差和方差。
    • 不支持使用 Power BI 第一个/最后一个汇总函数按字母顺序查询第一个或最后一个字符串。
    • 在 Power BI 中，执行中位数查询的方法是提取数据集中的所有值，然后在本地计算中位数。在较大的数据集上，此操作可能会非常缓慢，并且可能会超时。
  • 由于高级过滤条件与 Power Query 和 Looker 过滤条件表达式存在不一致之处，因此请注意以下限制：
    • 支持所有文本过滤条件。
    • 不支持使用多个文本过滤条件。
    • 支持所有数字过滤条件。
    • 只有在以下情况下支持使用多个数字过滤条件：
      • 不等式 AND 不等式（例如，小于 AND 大于）。
      • 不等式或不等式（例如，小于或大于）。
      • 是或是。
    • 仅支持以下日期/日期时间过滤条件：is、is not、is on or after、is before。
    • 仅在以下情况下支持多个日期和日期时间过滤条件：
      • is on or after AND is before
      • is or is
    • 以下表格函数不可折叠：
      • Table.Distinct
      • Table.Join
      • Table.NestedJoin
      • Table.Skip

Looker-Power BI 连接器更新日志

以下部分显示了每个版本的 Looker-Power BI 连接器中的更新：

版本 1.4.0

Looker 与 Power BI 连接器的 1.4.0 版进行了以下更新：

  • 添加了对“导入模式”的支持
  • 启用了数据预览
  • 改进了执行 SELECT * 查询时的行为
  • 提高了 Looker 缓存命中率
  • 改进了过滤条件建议检索的性能

Looker-Power BI 连接器 1.4.0 版修复了以下 bug：

  • 修复了以下 bug：Looker 无法检测到已为过滤条件和参数字段传递值
  • 修复了切片器中有时会缺少参数建议值的 bug
  • 修复了 LookML 语句会忽略 Liquid 变量的 bug
  • 修复了 Power BI 矩阵视图中不重复计数测量值不一致的 bug

版本 1.3.1

点击即可展开部分

Looker 与 Power BI 连接器的 1.3.1 版进行了以下更新：

  • 添加了用于显示隐藏字段的选项

Looker-Power BI 连接器 1.3.1 版修复了以下 bug：

  • 修复了以下 bug：如果视觉元素和报告中都存在过滤条件，则视觉元素会失败

1.3.0 版

点击即可展开部分

Looker 与 Power BI 连接器的 1.3.0 版进行了以下更新：

  • 简化了日期时间格式设置
  • 改进了对不受支持的文本表达式的检测
  • 改进了错误消息报告

Looker-Power BI 连接器 1.3.0 版进行了以下 bug 修复：

  • 改进了对过滤条件值中转义字符的支持

版本 1.2.0

点击即可展开部分

Looker 与 Power BI 连接器 1.2.0 版进行了以下更新：

  • 现在支持参数和仅限过滤条件的字段
  • 高级过滤条件支持类型为文本、数字、日期和日期时间的仅限过滤条件的字段
  • 针对利用 Looker 建议值的仅限过滤条件字段提供基本过滤条件支持