修剪分支历史记录

ArcGIS Pro 中,分支历史记录的概念指的是地理数据库内注册为分支版本化的数据集所发生的更改的详细记录。 无论是插入、更新还是删除,每一次修改都会作为业务表中的一个新条目被记录下来。 这种细致的更改追踪确保了更改历史的完整保存,这样,您能够有效地管理和回顾数据的长期演变过程。 然而,随着数据的不断编辑,编辑内容会逐渐积累,存档数据可能会显著增长,从而可能对存储容量造成压力。

了解关于注册为分支版本化数据集的分支历史记录的详细信息

“修剪分支历史记录”工具

为了解决这个问题,提供了修剪分支历史记录地理处理工具,旨在帮助管理和清理分支版本化的历史记录。 修剪过程包括删除不再被任何版本或复本引用的已存档的停用记录。 该工具基于特定条件识别可以安全修剪的记录,确保只删除符合条件的条目,同时保留必要的历史数据。

“修剪分支历史记录”地理处理工具

使用“修剪分支历史记录”工具的最佳实践

修剪分支历史记录工具是管理分支版本化数据集大小的有效工具,它通过移除不必要的历史数据来实现这一点。 遵循这些最佳实践将有助于优化工具的使用,确保流畅的体验,从而维护一个高效且组织良好的地理数据库。

  • 进行定期维护 - 应定期执行协调和提交操作,将编辑合并到默认版本中,建议频率为每天或每周。 未协调的版本、未解决的冲突以及协调后未删除的版本都可能阻止行的修剪。

    “分支版本化协调和提交”示意图

    了解关于分支版本方案以及协调和提交对分支版本的编辑的详细信息。

  • 建立修剪条件 - 清晰地定义修剪条件,例如特定的日期或性能要求,将有助于创建更有效的修剪工作流程。

  • 确定要修剪的数据 - 根据工作流需求和历史数据的重要性,确定要修剪的数据的截止日期。

  • 进行测试运行 - 启用仅报表选项来使用该工具。 这种方法不会修剪任何数据;它只是在输出日志文件结果中提供一份关于可以修剪的存档记录数量的报表。

  • 日志文件审查 - 运行该工具后,审查生成的输出日志文件结果,查看有多少存档记录符合修剪条件。 监控日志文件中与修剪过程相关的任何警告或错误,并采取相应的措施。

  • 备份数据 - 在使用修剪分支历史记录工具之前,务必备份您的整个数据库。 此备份确保在必要时可以恢复您的数据。

  • 运行工具的时机 - 为了减少对系统的影响,最好在非高峰时段、周末或可以停止引用分支版本化数据集的要素服务时运行该工具。

  • 避免引用时刻 - 确保所有未完成的版本都已协调。

    注:

    在使用修剪分支历史记录工具时,您可能会遇到与引用时刻相关的错误。

    了解关于引用时刻的详细信息

  • 监控和审查 - 定期评估分支版本,识别任何可能需要修剪的历史数据。 此外,追踪分支版本化数据集的大小,并根据需要运行修剪分支历史记录工具,从而有效地管理存储空间。

使用“修剪分支历史记录”工具的先决条件

在使用修剪分支历史记录地理处理工具之前,必须满足以下先决条件。

  • 该工具只能由输入数据集的指定数据集所有者运行。
    提示:

    只有地理数据库管理员才能查看所有私有版本,因此,数据集所有者应咨询管理员确定设置此日期前修剪所需的最早引用时刻。

  • 必须将输入数据集选择注册为分支版本
  • 在指定输入数据集选择之前,所有者必须在地理数据库连接属性对话框中确认版本化类型已设置为分支

    地理数据库连接属性对话框

    了解关于如何配置分支版本化的数据库连接的详细信息

  • 输入数据集选择可以是单个表、要素类或要素数据集。 如果选择要素数据集,该工具还将处理其中的所有要素类以及与该数据集相关的外部数据,但不包括其他要素数据集中的数据。
    提示:

    如果某个要素类已从要素数据集中移除,建议将该要素数据集本身用作输入数据集

  • 需要在输入数据集数据上获得独占的方案锁,确保多用户环境中的数据一致性。 此锁可防止在其他用户访问数据集时进行任何方案更改。 仔细规划至关重要;例如,在用户离线时计划方案修改可以避免影响他们的工作。 如果数据集已发布为服务,请在进行任何方案更改之前使用 ArcGIS Server Manager 停止该服务。

    了解关于如何查看和管理数据集上的锁的详细信息

使用“修剪分支历史记录”工具

要使用修剪分支历史记录工具从分支版本化数据集中删除停用的已存档记录,请完成以下步骤:

提示:

修剪分支历史记录工具仅修剪默认版本中已存档的记录。

  1. 要打开修剪分支历史记录地理处理工具的方法是,浏览至分析选项卡,然后在地理处理组中单击工具。 或者,在数据管理工具工具集的版本工具箱中搜索该工具。
    在分析选项卡、工具、地理处理下的“修剪分支历史记录”工具

    将显示修剪分支历史记录地理处理工具对话框,其中包含默认设置。

    “修剪分支历史记录”地理处理工具对话框

  2. 输入数据集下拉菜单中,选择单个数据集,或者使用浏览按钮 浏览 选择包含要修剪的分支版本化数据的要素数据集、要素类或表。
  3. 对于输出日志文件,请使用浏览按钮 浏览 指定输出日志文件的保存路径。
  4. (可选)选中仅报表参数以仅生成符合条件的存档记录数量的报告,或取消选中继续进行修剪操作。
    • 如果选中仅报表参数,则只会将符合条件的记录总数报告到输出日志文件结果中;记录本身不会被修剪。 默认情况下,仅报表选项处于选中状态。
      当选中“仅报表”参数时生成的输出日志文件。
    • 如果取消选中仅报表参数,则符合条件的存档记录将被修剪。
      显示从分支历史中修剪的记录的输出日志文件。
  5. 或者,要想针对内部表,请选中仅修剪系统表参数。

    选中此项后,将仅列出或修剪控制器数据集中符合条件的内部系统表。

    • 如果选中仅修剪系统表参数,则只会将控制器数据集中符合条件的内部系统表修剪或报告到日志文件。
    • 默认情况下,仅修剪系统表参数处于未选中状态,这意味着所有符合条件的表都将包含在修剪范围内。
    注:
    ArcGIS Pro 3.5 中,“内部系统表”特指公共设施网络网络拓扑表,这些表存储了所有关联信息,例如连通性和包含关系。
  6. 或者,设置此日期前修剪参数的值,修剪在指定日期和时间之前的存档记录。
    提示:

    为了保持一致的参考,请确保日期采用 UTC(协调世界时)格式。

    • 如果此日期前修字段为空,该工具将基于引用时刻修剪尽可能多的符合条件的存档历史。
      “修剪分支历史记录”工具,未指定“此日期前修剪”
    • 如果此日期前修剪字段包含指定的日期,则只会移除该日期之前的存档数据。
      使用“修剪分支历史记录”工具设置“此日期前修剪”参数的可用选项
      注:
      如果由于某个版本或要素服务复本使用了在请求的修剪日期之前的引用时刻,导致此日期前修剪值无效,该工具将发出警告,并指明可以使用的最早时刻以及阻止修剪的版本详细信息。
      由于引用时刻导致“此日期前修剪”参数无效时生成的输出日志文件

      了解关于引用时刻打开版本视图管理分支版本管理要素服务复本的详细信息。

  7. 单击运行按钮,生成指定分支版本化数据集的分支历史报告或执行修剪操作。

    注:

    您还可以选择计划运行,以便稍后运行该工具,并可使用运行按钮旁边的下拉菜单设置可选的重复运行计划。

    计划运行

    了解有关计划地理处理工具的详细信息

修剪分支历史记录工具运行完成后,即可打开您的表或要素类的属性对话框。 在选项卡下,存档历史记录参数显示了上次使用该工具从此数据集中修剪停用行的最近日期。

“要素类属性”对话框中的“存档历史记录”参数

了解关于修剪分支历史记录工具的详细信息

了解更多关于分支历史记录以及使用修剪分支历史记录工具时的关键概念。

注:

记录被修剪后,即被永久删除。 由于相关数据不在可用,因此无法再进行指定时间点的历史查询。

修剪过程中的错误处理

如果修剪分支历史记录工具在处理过程中遇到错误(例如,由于内存问题或连接中断),请解决该错误并重新运行该工具。

如果修剪分支历史记录工具遇到任何阻止操作的被引用时刻,将显示警告消息。 此消息将包含关于被引用时刻以及导致阻止操作的版本等详细信息。

如果修剪分支历史记录工具返回一个错误,指示由于被引用的时刻导致此日期前修剪值无效,在版本视图中检查公共祖先和上一个公共祖先版本属性。

如果修剪操作被阻止,您可能需要将此日期前修剪调整为不与任何被引用时刻冲突的更晚时间。

了解关于修剪分支历史记录工具的工作原理以及修剪分支历史的关键概念和注意事项,请参阅分支历史记录部分。

相关主题