Отсечь историю ветви (Управление данными)

Краткая информация

Удаляет устаревшие архивные записи из наборов данных с сервис-ориентированными версиями.

Более подробно об отсечке сервис-ориентированной истории

Использование

  • Если значение параметра Отсечь до даты не указано, инструмент отсечет как можно большую часть истории архива на основе указанных моментов. Если значение параметра Отсечь до даты задано, все строки до этого момента будут удалены.

  • Если значение параметра Отсечь до даты неверно из-за версии или реплики, которые ссылаются на момент, предшествующий запрошенной дате отсечения, появится предупреждение. В журнале выходных данных будет указан самый ранний момент, который можно использовать, и будет указан момент и версия, блокирующие инструмент.

    Более подробно о заданных моментах

  • Тип управления версиями для подключения базы геоданных в значении параметра Входной набор данных должен быть задан как сервис-ориентированная версия.

  • Набор данных должен быть зарегистрирован как сервис-ориентированная версия.

  • Инструмент может быть выполнен только владельцем данных.

  • Значением параметра Входной набор данных может быть класс объектов, набор классов объектов или таблица. Если входными данными является набор классов объектов, будут обработаны все классы пространственных объектов в этом наборе и связанные с ними данные за пределами набора классов объектов, за исключением данных из другого набора классов объектов.

  • Если класс пространственных объектов находится в наборе классов объектов, используйте этот набор классов в качестве входных данных.

  • Для запуска инструмента требуется эксклюзивная блокировка схемы. Необходимо будет прекратить использование сервисов, ссылающихся на входные данные, используя 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
(Дополнительный)

Задает, будут ли отображаться соответствующие архивные записи или они будут отсечены.

  • REPORT_ONLYПодходящие архивные записи будут указаны в файле журнала, они не будут отсечены. Это значение по умолчанию
  • PRUNEПодходящие архивные записи будут отсечены.
Boolean
system_tables_only

Указывает, будут ли только соответствующие внутренние таблицы отсечены или внесены в журнал.

  • SYSTEM_ONLYТолько подходящие внутренние таблицы расширенных наборов данных будут отсечены или внесены в файл журнала.
  • ALL_TABLESВсе подходящие таблицы будут отсечены или внесены в файл журнала. Это значение по умолчанию
Boolean
prune_before_date
(Дополнительный)

Архивные записи, которые старше указанной даты и времени, будут отсечены. Дата и время должны быть в UTC. Если данные не предоставлены, будет использоваться самый старый указанный момент в базе данных.

Date

Производные выходные данные

ИмяОписаниеТип данных
out_dataset

Обновленный набор данных.

Table View; Feature Dataset

Пример кода

PruneBranchHistory, пример (окно Python)

Отсекает архивные записи в классе до определенной даты и времени.

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"
)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Связанные разделы