Referencia de comando > Referencia de comando pmrep > PurgeVersion
  

PurgeVersion

Purga versiones de objeto de la base de datos del repositorio. Puede purgar versiones de objetos eliminados y de objetos activos. Se considera que un objeto es un objeto eliminado si su última versión está protegida y el estado de la versión es Deleted. Todos los demás se consideran objetos activos.
Al purgar versiones de objetos eliminados, purgará todas las versiones. Los objetos eliminados deben estar protegidos. Puede purgar versiones de todos los objetos eliminados o de los objetos eliminados antes de un período de finalización específico. Puede especificar el tiempo de finalización como fecha y hora, fecha solamente o un número de días antes de la fecha actual.
Al purgar versiones de objetos activos, puede especificar criterios de purga. Puede especificar el número de versiones que desea conservar y purgar las versiones anteriores, y puede purgar versiones anteriores a un momento de corte especificado. No puede purgar una versión desprotegida ni la última versión protegida.
Al purgar versiones de un objeto compuesto, tenga en cuenta qué versiones de los objetos dependientes se purgarán.
Puede utilizar la opción -k para mostrar los objetos no purgados y la razón por la que no se purgaron. Por ejemplo, puede ocurrir que no tenga permiso para purgar una versión del objeto. No se pueden purgar versiones de objetos que formen parte de un grupo de implementación.
El comando PurgeVersion emplea la siguiente sintaxis:
purgeversion
{-d <all | time_date | num_day> | 
{-n <last_n_versions_to_keep> |
 -t <time_date | num_day>}}
[-f <folder_name>]
[-q <query_name>]
[-o <output_file_name>]
[-p (preview purged objects only)]
[-b (verbose)]
[-c (check deployment group reference)]
[-s dbd_separator]
[-k (log objects not purged)]
La tabla siguiente describe las opciones y los argumentos de pmrep PurgeVersion:
Opción
Argumento
Descripción
-d
all
time_date
num_day
Obligatorio si no usa las opciones -n o -t. Purga todas las versiones de los objetos eliminados protegidos. Puede especificar el valor all para todos los objetos eliminados o especificar una hora de finalización para purgar todas las versiones de los objetos que se han eliminado antes de ese momento. Especifique la fecha y la hora de finalización con el formato MM/DD/YYYY HH24:MI:SS, el formato MM/DD/YYYY o como el número de días anteriores a la fecha actual. Si especifica un número de días, el valor debe ser un entero mayor que 0.
-n
last_n_versions_to_keep
Obligatorio si no usa las opciones -d o -t. Cantidad de las últimas versiones de objeto protegidos que deben conservarse para un objeto activo. El valor debe ser un entero mayor que 0. Por ejemplo, especifique 6 para purgar todas las versiones, salvo las últimas seis versiones protegidas. Si el objeto está desprotegido, también conservará la versión desprotegida.
-t
purge_cutoff_time
Obligatorio si no usa las opciones -d o -n. Momento de corte de la purga de las versiones de objetos activos. Purga las versiones que estaban protegidas antes del momento de corte. Puede especificar el momento de corte con el formato MM/DD/YYYY HH24:MI:SS, el formato MM/DD/YYYY o como el número de días anteriores a la fecha actual. Si especifica un número de días, el valor debe ser un entero mayor que 0. Al utilizar la opción -t, se conservará la última versión protegida aunque se haya protegido después del momento de corte de purga.
-f
folder_name
Opcional. Carpeta desde la que se purgan las versiones de objeto. Si no especifica ninguna carpeta, se purgarán las versiones de objetos de todas las carpetas del repositorio.
-q
query_name
Opcional. Consulta utilizada para purgar las versiones de objeto de un conjunto de resultados de consulta específico.
-o
outputfile_name
Opcional. Archivo de salida en el que se guardará la información acerca de las versiones de objetos purgados.
-p
-
Opcional. Ofrece una vista previa del comando PurgeVersion. El comando pmrep muestra los resultados de purga sin necesidad de purgar las versiones de objeto.
-b
-
Opcional. Muestra o guarda la información de purga en modo detallado. El modo detallado proporciona información específica sobre las versiones de objeto, incluidos el nombre de repositorio, el nombre de carpeta, el número de versión y el estado. Puede usar la opción -b con las opciones -o y -p.
-c
-
Opcional. Busca referencias a las versiones de objeto que ha devuelto la vista previa de purga en los grupos de implementación del repositorio. Si una vista previa de purga contiene una versión de objeto en un grupo de implementación, pmrep muestra una advertencia.
Si utiliza la opción -c con la opción -p, el comando mostrará los objetos purgados y a continuación las versiones de objetos contenidas en grupos de implementación. Si utiliza la opción -c sin la opción -p, el comando no purgará versiones de objetos que formen parte de grupos de implementación.
-s
dbd_separator
Opcional. Si un origen ODBC incluye un punto (.) en el nombre, establezca un carácter separador diferente al definir el objeto de origen. Por ejemplo, en lugar de definir el objeto de origen como database_name.source_name, defínalo como database_name\source_name y defina dbd_separator como una barra invertida (\).
-k
-
Opcional. Enumera todos los nombres y las versiones de objeto que no se purgan aunque coincidan con los criterios de purga. La opción -k también muestra el motivo por el cual no se han purgado las versiones de objetos. Por ejemplo, una versión de objeto no se purga si no tiene privilegios suficientes para purgar el objeto.

Ejemplos

El ejemplo siguiente purga todas las versiones de todos los objetos eliminados en el repositorio:
pmrep purgeversion -d all
El ejemplo siguiente purga todas excepto la última versión protegida de los objetos de la carpeta folder1:
pmrep purgeversion -n 1 -f folder1
El ejemplo siguiente muestra una vista previa de una purga de todas las versiones de objetos que se protegieron antes del mediodía del 5 de enero de 2005, y envía los resultados al archivo llamado purge_output.txt:
pmrep purgeversion -t '01/05/2005 12:00:00' -o purge_output.txt -p