使用语义模型版本历史记录(预览版)

Power BI 自动为在 Web 上编辑的 Premium 语义模型配置语义模型版本历史记录。 有了版本历史记录,自助服务用户在 Web 上编辑语义模型时,可以从最严重的错误中恢复。 有关完整源代码管理和更多版本的支持,请使用 git 集成,该集成可与同一语义模型的版本历史记录结合使用。

打开“版本历史记录”窗格

可以使用类似 Office 的“版本历史记录”窗格查看语义模型的早期版本。 可以从多个位置以多种方式打开“版本历史记录”窗格,每种方式的结果都相同:

  • 在工作区内容列表中,为语义模型选择“更多选项(...)”,然后选择“版本历史记录”

    显示如何从语义模型菜单中选择版本历史记录的屏幕截图。

  • 在 OneLake 目录内容列表中,为语义模型选择“更多选项(...)”,然后选择“版本历史记录”

    显示如何从 OneLake 目录内容列表中选择版本历史记录的屏幕截图。

  • 在语义模型详细信息页中,选择“文件”,然后选择“版本历史记录”

    显示如何从“文件”菜单中选择版本历史记录的屏幕截图。

  • 在 Web 上编辑语义模型时,选择“文件”,然后选择“版本历史记录”

    显示在 Web 上编辑语义模型时如何选择版本历史记录的屏幕截图。

  • 在 Web 上编辑语义模型时,选择语义模型的标题栏,然后选择“版本历史记录”

    显示在 Web 上编辑语义模型时如何从标题栏中选择版本历史记录的屏幕截图。

查看版本历史记录窗格

在“版本历史记录”窗格中,可看到每个语义模型最多五个版本。 “版本历史记录”窗格中的每个版本存储语义模型的元数据和数据。 窗格中列出的每个版本都会显示有关该版本的以下信息:

  • 对版本中捕获的语义模型进行的最后一次修改的时间戳。
  • 对版本中捕获的语义模型进行最后更改的人员的姓名。
  • 版本说明(若用户先前在手动保存版本时提供)。

显示版本历史记录窗格的屏幕截图。

将版本保存到版本历史记录

在 Web 上以编辑模式打开语义模型后,或者在 Power BI Desktop 中打开 Direct Lake 模型进行实时编辑时,开始捕获语义模型的版本。

支持版本历史记录的每个语义模型最多可以保存五个版本。 每当发生下列操作之一时,版本将保存到版本历史记录:

  • 手动将版本保存到版本历史记录时。 在 Web 上编辑语义模型时,选择“文件”,然后选择“保存到版本历史记录”

    显示如何从“文件”菜单中手动保存版本历史记录的屏幕截图。

    手动保存版本时,可以选择提供文本说明,以帮助以后在版本历史记录窗格中识别此版本。

    显示如何手动向版本添加说明的屏幕截图。

    说明在版本历史记录窗格中与其相应版本一起显示。

    显示随版本提供的说明的屏幕截图。

  • 在从 Power BI Desktop 发布 .pbix 文件或在 Web 上上传 .pbix 文件时,会捕获发布/上传之前的语义模型版本。 自动捕获版本可确保在发布/上传时无意中覆盖在 Web 中所做的更改时,可在发生无意的发布/上传之前将模型还原到其状态或版本。

  • 当您在 web 上以编辑模式打开语义模型时,会捕获语义模型的某个版本,以确保如果您在 Web 编辑会话中进行了一些不想要的更改,您可以将模型还原到这些更改前的状态或版本。

  • 从版本历史记录中将语义模型还原到以前的版本时,会保存还原前的模型版本,这样,如果选择了不想要的版本,可以还原到还原前的状态。

还原到以前的版本

若要将语义模型还原到以前的版本,请在版本历史记录窗格中,选择要还原的版本的上下文菜单中的“还原”

显示如何从版本历史记录窗格中还原以前版本的语义模型的屏幕截图。

版本历史记录窗格还显示模型当前版本的条目。 无法还原到当前版本,因此当前版本的上下文菜单提供了在 Web 上打开语义模型的选项。

显示版本历史记录窗格中当前语义模型版本的上下文菜单的屏幕截图。

查看审核日志和活动事件

Power BI 管理员可以使用 Microsoft 365 管理中心 来审核与在语义模型版本历史记录中还原和保存版本相关的操作。 下表显示了语义模型版本历史记录支持哪些审核操作:

友好名称 操作名称 注意
将模型还原到以前的版本 恢复 Power BI 模型的以前版本 用户将 Power BI 语义模型还原到版本历史记录中保存的以前版本。
在 Power BI 中为模型保存新版本的版本历史记录 SaveNewVersionForPowerBIModel 为 Power BI 语义模型的版本历史保存一个新版本。

有关访问审核日志的详细信息,请参阅访问审核日志一文。

容量利用率和报告

可使用 Premium 指标应用监视还原到具有版本历史记录的先前版本对 Power BI Premium 容量的影响。 可使用以下操作监视容量影响。

操作 说明 工作负载 类型
Web 建模写入 语义模型 Web 建模用户体验中的数据模型写入操作 语义模型 交互

用于捕获模型的语义模型版本历史记录中的版本的存储不收取额外的费用。

要求和权限

  • 用户必须对语义模型具有写入和生成权限才能查看和使用版本历史记录。 有关详细信息,请参阅权限一文。
  • 具有免费许可证的用户无法使用版本历史记录功能。

注意事项和限制

语义模型版本历史记录目前为预览版。 请记住以下几点:

  • 每个模型最多保存五个版本。 达到五个版本的限制后,保存版本将会覆盖版本历史中最早的版本。
  • 语义模型必须位于 Premium 工作区中。
  • “我的工作区”中存储的语义模型不支持版本历史记录
  • 必须先在 Web 上打开语义模型,或者在 Power BI Desktop 中打开语义模型进行 Direct Lake 实时编辑,然后才能开始为模型捕获版本。
  • 当模型还原到以前的版本时,无法对语义模型进行更改。
  • 不能删除语义模型版本历史记录中的版本。
  • 语义模型版本历史记录遵循与在 Power BI 服务中编辑数据模型相同的限制。
  • 对于尚未升级到增强元数据格式的语义模型,不会捕获版本历史记录。 此外,如果具有旧元数据格式的模型以增强的元数据格式在模型上发布,将删除以前为该模型捕获的所有语义模型版本。
  • 在不同的容量之间移动模型将会删除其版本历史记录。
  • 无法在 Web 上的版本历史记录窗格之外访问语义模型版本历史记录中的版本。 若要提高源代码管理的灵活性和支持更多版本,请使用 git 集成,该集成可与同一语义模型的版本历史记录结合使用。
  • 在还原到以前的版本后,语义模型中的数据可能会过时。 若要确保拥有最新数据,请在执行还原后完成刷新。 刷新行为可能因存储模式而异。 例如,配置了 自动更新 的 Direct Lake 模型在还原后将自动更新为最新数据,无需手动发起刷新。
  • 语义模型必须启用大型语义模型存储格式。 当语义模型首次在Web上以编辑模式打开,或在桌面中打开Direct Lake模型进行实时编辑时,它们会被自动转换为大型语义模型储存格式。 如果一个包含版本历史记录的语义模型在模型设置中禁用了大型语义模型存储格式,该模型的所有版本历史记录将被删除。 语义模型设置中的警告会在进行更改之前通知你此影响:显示有关删除版本历史记录的警告的屏幕截图。

本文提供了有关语义模型版本预览的信息。 有关 Power BI 中数据建模的详细信息,请参阅以下资源: