使用 Power BI 连接到 GitHub

本文介绍如何使用 Power BI 模板应用从 GitHub 帐户拉取数据。 模板应用生成一个带有仪表板、一组报表和语义模型的工作区,以便你可以浏览 GitHub 数据。 适用于 Power BI 的 GitHub 应用使你通过参与、问题、拉取请求和活动用户的相关数据,深入了解 GitHub 存储机制(也称为存储库)。

GitHub template app

安装模板应用后,可以更改仪表板和报表。 然后可以将其作为应用分发给组织中的同事。

连接到 GitHub 模板应用或进一步了解 Power BI 与 GitHub 集成

还可以尝试 GitHub 教程。 它为 Power BI 文档安装有关公共存储库的实际 GitHub 数据。

注意

此模板应用要求 GitHub 帐户具有存储库的访问权限。 以下是有关要求的详细信息。

此模板应用不支持 GitHub Enterprise。

安装应用

  1. 单击以下链接可转到该应用:GitHub 模板应用

  2. 在应用的 AppSource 页面,选择“立即获取”。

    GitHub template app in AppSource

  3. 选择“安装” 。

    Install the GitHub template app

    安装应用后,你将在应用页面上看到它。

    GitHub app on Apps page

连接到数据源

  1. 选择应用页面上的图标以打开应用。

    应用将打开,显示示例数据。

  2. 选择页面顶部横幅上的“连接数据”链接。

    GitHub app connect your data link

  3. 这将打开“参数”对话框,你可以在其中将数据源从示例数据更改为你自己的数据源(请参阅已知限制),然后打开“身份验证方法”对话框。 你可能必须重新定义这些对话框中的值。

    Screenshot of connect to data dialogs.

  4. 输入 GitHub 凭据并遵循 GitHub 身份验证过程(如果你已通过浏览器登录,可跳过此步骤)。

    Power BI GitHub authenticate process

填写好连接对话框并登录 GitHub 后,开始连接过程。 横幅提示你正在刷新数据,与此同时你正在查看示例数据。

Power BI GitHub app refresh in progress

除非在登录过程中禁用了此功能,否则报表数据将每天自动刷新一次。 也可以设置自己的刷新计划,根据需要使报表数据保持最新状态。

自定义和共享

若要自定义并共享你的应用,请选择页面右上角的铅笔图标。

Edit app

有关在工作区中编辑项目的信息,请参阅

在工作区中完成对项目的所有更改后,即可发布和共享应用。 请参阅创建和发布应用,了解如何执行此操作。

应用中包含的内容

在 Power BI 中 GitHub 提供以下数据:

表名 说明
参与 参与者表提供每周汇总的参与者所执行的总新增、删除和提交操作。 包括前 100 个参与者。
问题 列出所选存储库的所有问题,其中包含计算,如:解决问题的总时间和平均时间、未解决问题总数和已解决问题总数。 存储库中没有任何问题时,此表为空。
拉取请求 此表包含此存储库和拉取请求者的所有拉取请求。 它也包含相关计算,如:有多少未解决、已解决和总的拉取请求、拉取这些请求花了多少时间,以及拉取请求所耗用的平均时间。 存储库中没有任何拉取请求时,此表为空。
用户 下表提供了 GitHub 使用者或参与者的列表,他们针对所选的存储库进行参与、提出问题或解决拉取请求。
里程碑 它具有所选存储库的所有里程碑。
DateTable 此表包含从今天开始推算的和过去多年的日期,可让你按日期分析 GitHub 数据。
ContributionPunchCard 此表可用作所选存储库的参与穿孔卡。 它会按一周中各天和一天中各小时来显示提交。 此表未连接到模型中的其他表。
RepoDetails 此表提供所选存储库的详细信息。

系统要求

  • 具有存储库访问权限的 GitHub。
  • 第一次登录期间授予给适用于 GitHub 的 Power BI 应用的权限。 有关撤消访问权限的详细信息,请参阅下文。
  • 具有足够可用的 API 调用以拉取和刷新数据。

注意

此模板应用不支持 GitHub Enterprise。

取消授权 Power BI

若要取消将 Power BI 连接到 GitHub 存储库的授权,可以撤销 GitHub 中的访问权限。 有关详细信息,请参阅 GitHub 帮助主题。

查找参数

你可以通过查看 GuiHub 本身的存储库来确定所有者和存储库:

Repo name and owner

第一部分“Azure”是所有者,第二部分“azure-sdk-for-pho”是存储库本身。 将在存储库的 URL 中看到这两个相同的项目:

<https://github.com/Azure/azure-sdk-for-php> .

故障排除

如有必要,可以验证你的 GitHub 凭据。

  1. 在另一个浏览器窗口中,转到 GitHub 网站并登录到 GitHub。 将在 GitHub 网站的右上角看到你已登录。
  2. 在 GitHub 中,导航到你计划要在 Power BI 中访问的存储库的 URL。 例如: https://github.com/dotnet/corefx
  3. 返回到 Power BI,尝试连接到 GitHub。 在“配置 GitHub”对话框中,使用相同存储库的存储库名称和存储库所有者。