如果未指定此日期前修剪参数值，该工具将根据引用的时间点尽可能多地修剪归档历史。 如果指定了此日期前修剪参数值，则将移除到该时间点为止的所有行。
如果由于某个版本或副本引用了请求修剪日期之前的某个时间点，导致此日期前修剪参数值无效，则会发出警告消息。 输出日志将报告可以使用的最早时间点，并包括阻止该工具的时间点和版本。
输入数据集参数值的地理数据库连接的版本控制类型必须设置为“分支”。
必须将该数据集注册为分支版本。
该工具只能由数据所有者运行。
输入数据集参数值可以是要素类、要素数据集或表。 当输入为要素数据集时，将处理该数据集中的所有要素类以及要素数据集之外的相关数据，但不包括另一个要素数据集中的数据。
如果要素类位于要素数据集中，请使用要素数据集作为输入。
运行该工具需要独占模式的方案锁。 需要使用 ArcGIS Server Manager 停止引用输入数据的服务。
| 标注 | 说明 | 数据类型 |
输入数据集 | 将要修剪的要素类、要素数据集或表。 | Table View; Feature Dataset |
输出日志文件 | 一个日志文件，报告了已被修剪或将要被修剪的要素类和表。 输出文件还将列出阻止使用请求的修剪日期之前的日期的复本和版本。 | File |
仅报告 (可选) | 指定是否报告或修剪符合条件的归档记录。
| Boolean |
仅修剪系统表 | 指定是否仅报告或修剪符合条件的内部表。
| Boolean |
此日期前修剪 (可选) | 将修剪早于指定日期和时间的归档记录。 日期和时间必须使用 UTC。 如果未提供日期，将使用数据库中最早的引用时间点。 | Date |
| 标注 | 说明 | 数据类型 |
| 输出数据集 | 已更新的数据集。 | Table View; Feature Dataset |
arcpy.management.PruneBranchHistory(in_dataset, out_log, {report_only}, system_tables_only, {prune_before_date})| 名称 | 说明 | 数据类型 |
in_dataset | 将要修剪的要素类、要素数据集或表。 | Table View; Feature Dataset |
out_log | 一个日志文件，报告了已被修剪或将要被修剪的要素类和表。 输出文件还将列出阻止使用请求的修剪日期之前的日期的复本和版本。 | File |
report_only (可选) | 指定是否报告或修剪符合条件的归档记录。
| Boolean |
system_tables_only | 指定是否仅报告或修剪符合条件的内部表。
| Boolean |
prune_before_date (可选) | 将修剪早于指定日期和时间的归档记录。 日期和时间必须使用 UTC。 如果未提供日期，将使用数据库中最早的引用时间点。 | Date |
| 名称 | 说明 | 数据类型 |
| out_dataset | 已更新的数据集。 | Table View; Feature Dataset |
修剪早于特定日期和时间的类存档记录。
import arcpy
arcpy.management.PruneBranchHistory(
in_dataset="feature_class",
out_log=r"C:Projects\prune_data\testing",
trim_before_date="1/15/2025 10:46:25 AM",
report_only=False,
system_tables_only="SYSTEM_ONLY"
)