My Oracle Support Banner

Remove Rows from Item History in One Step on Agile Product Lifecycle Management (PLM) System (Doc ID 2863833.1)

Last updated on OCTOBER 30, 2023

Applies to:

Oracle Agile PLM Framework - Version and later
Information in this document applies to any platform.


Remove unneeded or outdated change history records/rows from ITEM_HISTORY table. 


This document applies to the following products and versions:

Oracle Agile PLM version 9.3.6
Oracle Agile PLM version 9.3.3, 9.3.4, and 9.3.5 with limited support

Note: Agile PLM version 9.3.3, 9.3.4, and 9.3.5 are in Sustaining Support. Any issue rising from the execution of the scripts attached to this KM article cannot involve Oracle Development on these versions of the product. Sustaining Support policy details can be obtained at


Agile PLM maintains a product record for all Items, Changes, Events, and Actions in the form of history records in the database. Systems that have been in use for many years will have large number of records in the various history tables. These tables tend to be large in size and utilize the most storage on the database. If the retention period limit for the older records has been reached, they can be purged from the system to reduce the size of these tables. Reducing the size of these tables will reclaim space, improve performance and manageability. The purpose of this Knowledge Management (KM) article is to provide a set of scripts to list and remove rows from the ITEM_HISTORY table on an Agile PLM system.

Note: After running these scripts, the product records older than the retention period will not appear under the History Tab in the Web or the Java Client.


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.