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.3.mez 文件，并将其保存在自己电脑上的特定目录中。
4. 为自定义连接器设置 Power BI Desktop：每位 Power BI 用户都必须配置其 Power BI Desktop 安全设置，才能使用未经认证的自定义连接器。

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

完成将 Looker 与 Power BI Desktop 相关联的步骤后，您可以从 Power BI 连接到 Looker 数据，并在 Power BI 中发布报告。您还可以选择使用 Power BI 服务（Power BI Online）在网络浏览器中与 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.3.mez
2. 下载完成后，将 looker_1.4.3.mez 文件移到 [文档]\Microsoft Power BI Desktop\自定义连接器 目录。（如果这些文件夹尚不存在，请在计算机上创建它们。）

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

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

如说明中所述，在数据扩展下，您将选择（不推荐）允许加载任何扩展程序，而不进行验证或发出警告选项。选择确定，然后重启 Power BI Desktop。

从 Power BI Desktop 连接到 Looker 数据

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

1. 在 Power BI Desktop 工具栏中，依次选择获取数据 > 更多...
2. 在获取数据对话框中，在搜索字段中输入 Looker。
3. 在搜索结果中，点击 Looker 条目，然后点击关联。
4. 在连接到第三方服务对话框中，点击继续。
5. Power BI Desktop 将显示 Looker 登录对话框。在主机字段中，输入实例的网址。例如：example.cloud.looker.com。

6. （可选）点击高级选项以展开该部分，然后配置以下其他选项：

   • 使用显示隐藏的探索和字段下拉菜单可包含在 LookML 中配置为隐藏的探索和字段（如需了解详情，请参阅有关隐藏（针对探索）和隐藏（针对字段）的文档）：
     • FALSE（默认值）：隐藏字段会被抑制。
     • TRUE：显示隐藏的字段。
   • 使用启用日志记录下拉菜单在连接器内启用诊断日志，以便进行问题排查：
     • FALSE（默认）：诊断日志处于停用状态。
     • TRUE：已启用诊断日志。

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

8. 点击确定。

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

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

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

12. Power BI Desktop 将显示您有权访问的 Looker 模型列表，每个模型都以文件夹的形式表示。点击要访问的 Looker 模型，然后选中要在 Power BI Desktop 中加载的 Looker 探索旁边的复选框。如需查看模型，您必须拥有 Looker 用户访问权限或群组访问权限，才能访问包含该模型的模型集。如需访问探索，您必须拥有 Looker explore 权限。

13. 点击加载。

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

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

在 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 元素。例如，如果 Looker 探索将 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 探索中的字段。
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 探索中的字段。

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 管理员可以使用系统活动历史记录探索中的查询 API 客户端属性字段组查看 Looker-Power BI 连接器使用情况。每次运行新查询时，系统都会在“历史记录”探索中创建一个条目。

在查询 API 客户端属性字段组中，API 客户端名称会显示 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 Online）在 Web 浏览器中与 Looker 报告互动。

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

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

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

借助 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. 在数据集的列表中，点击三点状的更多选项菜单，然后选择安全性。

Power BI 将显示行级安全性窗口。在此处，您可以选择在 Power BI Desktop 中创建的角色，添加属于该角色的人员或群组，并在 Power BI 服务中验证您的角色。

现在，您可以与任何所需人员共享报告，而他们只会看到您根据所创建的角色允许他们查看的数据。

注意事项

查询行数限制

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

探索过滤条件

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

支持的维度组时间范围

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

Looker-Power BI 连接器不会显示系统活动探索

Looker-Power BI 连接器中不会显示系统活动探索。Looker 管理员可以直接在 Looker 界面中查看“系统活动”Explore。

已知限制

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 的 first/last 聚合器按字母顺序查询第一个或最后一个字符串。
  • 在 Power BI 中，中位数查询是通过提取数据集中的所有值，然后在本地计算中位数来执行的。对于较大的数据集，此过程可能会非常缓慢，甚至可能会超时。
• 由于 Power Query 和 Looker 过滤条件表达式存在不一致之处，请注意以下高级过滤条件限制：
  • 支持所有文本过滤条件。
  • 不支持多个文本过滤条件。
  • 支持所有数字过滤条件。
  • 仅在以下情况下支持多个数字过滤条件：
    • 不等式和不等式（例如，小于和大于）。
    • 不等式或不等式（例如，小于或大于）。
    • 是或不是。
  • 仅支持以下日期/日期时间过滤条件：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.3
• 版本 1.4.2
• 版本 1.4.0
• 版本 1.3.1
• 版本 1.3.0
• 版本 1.2.0

版本 1.4.3

Looker-Power BI 连接器 1.4.3 版包含以下更新：

• 连接器标签现在包含连接器版本号。
• 添加了新的启用日志记录选项，以便在连接器内动态启用诊断日志，从而进行问题排查。
• 添加了新的显示隐藏的探索和字段选项。启用后，系统会显示隐藏的探索和字段。此选项取代了之前的显示隐藏字段选项。

Looker-Power BI 连接器 1.4.3 版包含以下 bug 修复：

• 修复了字符串串联 DAX 运算符 (&) 失败的问题。
• 修复了以下问题：将 Power BI 度量应用到 Looker 度量时会导致错误。
• “凭据配置”菜单现在会再次显示 Looker 图标。

版本 1.4.2

版本 1.4.0

版本 1.3.1

1.3.0 版

版本 1.2.0