跳至主要内容

Power BI connector (REST API)

使用 Power BI REST API 连接器，以通过 Cognite 的 OData 服务或使用 GET、POST 的其他 Cognite API 以及针对 Cognite 数据模型的 GraphQL 查询来获取数据。

公开测试

本部分中所述的功能目前在 Beta 测试中面向所选客户提供，可能会更改。

设置到 Cognite Data Fusion (CDF) 的连接​

要连接 Cognite Data Fusion (CDF) 项目作为 Power BI 中的数据源，请按照以下步骤操作：

  1. 在 Power BI Desktop 中，使用组织帐户登录。

  2. 在主页选项卡上，选择获取数据，然后选择更多。在获取数据对话框中，搜索 Cognite 并选择 Cognite Data Fusion (REST API) 连接器。

    在 Power BI 中查找 CDF REST API 连接器

  3. 在对话框中，输入详细信息以配置到 CDF 的连接：

    • CDF project：输入要连接的 CDF 项目的名称。

    • CDF organization：输入用于登录 CDF 的组织。

    在 Power BI 中配置 CDF REST API 连接器

  4. 系统提示时，使用你的帐户凭据登录。

  5. 选择 Connect，以打开 Navigator 窗口。

  6. 选择要使用的函数，然后选择转换数据以打开 Power Query Editor 并从 CDF 获取数据。

    在 Power BI 中使用 REST API 连接器选择函数

如果你发出支持分页的请求（通过 GET/POST 请求中的 limit 参数或 GraphQL 查询中的 first 参数），请使用支持的最大页面大小。较小的页面大小会增加 API 调用次数，并显著影响加载时间。有关每个端点支持的最大页面大小，请参阅 Cognite API 文档。对于 GraphQL 查询，每页的最大限制为 1000 个实例。

筛选数据​

使用 REST API 函数时，可以应用服务器端筛选器来减少加载到 Power BI 中的初始数据。

如果你使用的是 OData，Power BI 可以在使用 Power Query 编辑器时将一些筛选器下推到 OData 服务。

对于 GraphQL 查询，可以直接在查询中应用筛选器以减少加载到 Power BI 中的数据量。还可以使用 GraphQL 查询变量来参数化查询，使其更易于重复使用。

已安排刷新​

在将报告发布到 Power BI 服务后，可以安排数据刷新以使数据保持最新。

处理时出错​

编写自定义 GET 和 POST 请求时，如果你提供的 URL 或正文无效，可能会收到错误。如果收到 CogniteAPIError 错误消息，请参阅 Cognite API 参考文档并调整请求。

上次更新