Reducir historial en rama (Administración de datos)

Resumen

Elimina los registros de archivo retirados de los datasets versionados en rama.

Más información sobre la reducción del historial en rama

Uso

• Si no se especifica ningún valor para el parámetro Eliminar antes de fecha, la herramienta eliminará la mayor parte posible del historial del archivo en función de los momentos de referencia. Si se especifica un valor para el parámetro Eliminar antes de fecha, se eliminarán todas las filas hasta ese momento.

• Si el valor del parámetro Eliminar antes de fecha no es válido debido a una versión o réplica que hace referencia a un momento anterior a la fecha de eliminación solicitada, se emitirá un mensaje de advertencia. El registro de salida informará del momento más temprano en que se puede utilizar e incluirá el momento y la versión que bloquearon la herramienta.

  Más información sobre los momentos referenciados

• El tipo de versionado de la conexión de la geodatabase del valor del parámetro Dataset de entrada debe establecerse en rama.

• El dataset debe estar registrado como versionado en rama.

• La herramienta solo la puede ejecutar el propietario de los datos.

• El valor del parámetro Dataset de entrada puede ser una clase de entidad, un dataset de entidades o una tabla. Cuando la entrada es un dataset de entidades, se procesarán todas las clases de entidad de ese dataset y los datos relacionados fuera del dataset de entidades, exceptuando los datos de otro dataset de entidades.

• Si una clase de entidad se encuentra en un dataset de entidades, utilice el dataset de entidades como entrada.

• Para ejecutar la herramienta se necesita un bloqueo del esquema exclusivo. Los servicios que hagan referencia a los datos de entrada deberán detenerse mediante ArcGIS Server Manager.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Dataset de entrada	Clase de entidad, dataset de entidades o tabla que se eliminarán.	Table View; Feature Dataset
Archivo de registro de salida	Archivo de registro que informa de las clases y tablas de entidades que se han eliminado o se van a eliminar. El archivo de salida también enumerará las réplicas y versiones que impidieron utilizar el valor del campo Eliminar antes de fecha.	File
Solo informar (Opcional)	Especifica si los registros de archivos elegibles se notificarán o eliminarán. Activado: se notificará al archivo de registro el número de registros de archivos elegibles; no se eliminarán. Esta es la opción predeterminada. Desactivado: se eliminarán los registros de archivos elegibles.	Boolean
Eliminar solo tablas del sistema	Especifica si solo se notificarán o eliminarán las tablas internas elegibles. Activado: solo se eliminarán o notificarán al archivo de registro las tablas internas elegibles de los datasets de extensiones. Desactivado: se eliminarán o notificarán al archivo de registro todas las tablas elegibles. Esta es la opción predeterminada.	Boolean
Eliminar antes de fecha (Opcional)	Se eliminarán los registros de archivos cuya fecha sea anterior a la fecha y hora especificadas. La fecha y hora deben estar en UTC. Si no se proporciona ninguna fecha, se utilizará el momento más antiguo referenciado de la base de datos.	Date

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dataset de salida	El dataset actualizado.	Table View; Feature Dataset

Python

arcpy.management.PruneBranchHistory(in_dataset, out_log, {report_only}, system_tables_only, {prune_before_date})

Nombre	Explicación	Tipo de datos
in_dataset	Clase de entidad, dataset de entidades o tabla que se eliminarán.	Table View; Feature Dataset
out_log	Archivo de registro que informa de las clases y tablas de entidades que se han eliminado o se van a eliminar. El archivo de salida también enumerará las réplicas y versiones que impidieron utilizar el valor del campo Eliminar antes de fecha.	File
report_only (Opcional)	Especifica si los registros de archivos elegibles se notificarán o eliminarán. REPORT_ONLY—Se notificarán al archivo de registro los registros de archivos elegibles; no se eliminarán. Esta es la opción predeterminada. PRUNE—Se eliminarán los registros de archivos elegibles.	Boolean
system_tables_only	Especifica si solo se notificarán o eliminarán las tablas internas elegibles. SYSTEM_ONLY—Solo se eliminarán o notificarán al archivo de registro las tablas internas elegibles de los datasets de extensiones. ALL—Se eliminarán o notificarán al archivo de registro todas las tablas elegibles. Esta es la opción predeterminada.	Boolean
prune_before_date (Opcional)	Se eliminarán los registros de archivos cuya fecha sea anterior a la fecha y hora especificadas. La fecha y hora deben estar en UTC. Si no se proporciona ninguna fecha, se utilizará el momento más antiguo referenciado de la base de datos.	Date

Salida derivada

Nombre	Explicación	Tipo de datos
out_dataset	El dataset actualizado.	Table View; Feature Dataset

Muestra de código

Ejemplo de PruneBranchHistory (ventana de Python)

Eliminar los archivos de registro de una clase anterior a la fecha y hora especificadas.

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí