使用模板应用将 GitHub 帐户连接到 Power BI,以浏览存储库见解和数据。 模板应用使用仪表板、报表和语义模型生成工作区,用于分析 GitHub 存储库中的贡献、问题、拉取请求和活动用户。
安装模板应用后,可以更改仪表板和报表。 然后,你可以将其作为应用分发给组织中的同事。
连接到 GitHub 模板应用 ,或详细了解 GitHub 与 Power BI 的集成 。
还可以尝试 GitHub 教程。 它安装了关于 Power BI 文档公共存储库的实际 GitHub 数据。
注释
此模板应用要求 GitHub 帐户有权访问存储库。
此模板应用不支持 GitHub Enterprise。
安装应用
单击以下链接可访问该应用: GitHub 模板应用
在应用的 AppSource 页上,选择立即获取。
选择“安装”。
安装应用后,可在“应用”页上看到它。
连接到数据源
选择“应用”页上的图标以打开该应用。
此时会打开应用,其中显示了示例数据。
选择页面顶部横幅上的 “连接数据 ”链接。
这将打开参数对话框,在其中将数据源从示例数据更改为自己的数据源(请参阅 已知限制),然后是身份验证方法对话框。 可能需要重新定义这些对话框中的值。
输入 GitHub 凭据并遵循 GitHub 身份验证过程(如果已使用浏览器登录,可能会跳过此步骤)。
填写完连接对话框并登录到 GitHub 后,连接过程将启动。 横幅通知你数据正在刷新,与此同时,你正在查看示例数据。
报表数据将每天自动刷新一次,除非你在登录过程中禁用了此功能。 还可以 设置自己的刷新计划 ,以便根据需要使报表数据保持最新状态。
自定义和共享
若要自定义和共享应用,请选择页面右上角的铅笔图标。
编辑工作区项的相关信息,请参阅
完成对工作区中项所做的任何更改后,即可发布和共享应用。 请参阅 “创建并发布应用 ”,了解如何执行此作。
应用中包含的内容
Power BI 中的 GitHub 提供以下数据:
| 表名称 | Description |
|---|---|
| 贡献 | 贡献表提供贡献者在每周创作的总添加、删除和提交的汇总。 纳入了前100位贡献者。 |
| 问题 | 列出所选存储库的所有问题,其中包含关闭问题的总时间和平均时间等计算、打开问题总数、已关闭问题总数。 如果存储库中没有问题,则此表为空。 |
| 拉取请求 | 此表包含存储库的所有拉取请求以及拉取请求的人员。 它还包含关于打开的、关闭的和总拉取请求数量的计算,以及拉取请求完成所需的时间和平均每个拉取请求所需的时间的计算。 如果存储库中没有拉取请求,则此表为空。 |
| 用户 | 此表提供已为所选存储库做出贡献、提交问题或解决拉取请求的 GitHub 用户或参与者的列表。 |
| 里程碑 | 它具有所选存储库的所有里程碑。 |
| 日期表 | 此表包含从今天开始的日期和过去多年的日期,可用于按日期分析 GitHub 数据。 |
| 贡献打卡图 | 此表可用作所选代码库的贡献记录。 它按一周中的某一天和一天中的小时显示提交。 此表未连接到模型中的其他表。 |
| RepoDetails | 此表提供了所选存储库的详细信息。 |
系统要求
- 有权访问存储库的 GitHub 帐户。
- 首次登录期间授予 Power BI for GitHub 应用的权限。 请参阅有关在此页上撤消访问权限的详细信息。
- 有足够的 API 调用可用于拉取和刷新数据。
注释
此模板应用不支持 GitHub Enterprise。
取消授权 Power BI
若要取消 Power BI 连接到 GitHub 存储库的授权,可以在 GitHub 中撤销访问权限。 有关详细信息,请参阅此 GitHub 帮助 主题。
查找参数
可以通过查看 GitHub 本身中的存储库来确定所有者和存储库:
第一部分“Azure”是所有者,第二部分“azure-sdk-for-php”是存储库本身。 在存储库的 URL 中可以看到这两个项:
<https://github.com/Azure/azure-sdk-for-php> .
Troubleshooting
GitHub 应用未显示在“应用”列表中
如果在 Power BI 应用列表中找不到 GitHub 应用,请考虑以下事项:
- 必须先安装该应用:安装后,GitHub 应用才会显示在应用列表中。 使用“ 安装应用 ”部分中提供的安装链接从 AppSource 访问和安装应用。
- 检查模板应用权限:组织的 Power BI 管理员可能限制安装模板应用的能力。 请与管理员联系,验证是否已为租户启用模板应用安装。 有关详细信息,请参阅 模板应用设置 。
- AppSource 可用性:如果无法通过 AppSource 访问应用,请尝试使用直接安装链接: GitHub 模板应用
- 查看正确的位置:在 Power BI 服务中,从导航窗格中选择 “应用 ”以查看已安装的应用。 如果尚未安装 GitHub 模板应用,则它未在此列表中。
验证 GitHub 凭据
如有必要,可以验证 GitHub 凭据。
- 在另一个浏览器窗口中,转到 GitHub 网站并登录到 GitHub。 你可以在 GitHub 站点的右上角看到自己已登录。
- 在 GitHub 中,导航到计划在 Power BI 中访问的存储库的 URL。 例如: https://github.com/dotnet/corefx。
- 回到 Power BI,尝试连接到 GitHub。 在“配置 GitHub”对话框中,对同一存储库使用存储库和存储库所有者的名称。