View source | View content page | Page history | Printable version   
Main Page
Upload file
What links here
Recent changes

PDF Books
Show collection (0 pages)
Collections help


Projects:Table Recreation Prevention/Technical Specifications



There are some tasks, such as installing/uninstalling modules and updating Openbravo or module version, that can require of changes in database model. Those changes are performed by DBSourceManager in update.dabase task.

When these changes include some modifications (like adding/removing columns) in table model, the strategy used by DBSourceManager is two recreate the whole table, this recreation process involves the following steps:

Executing this process has some disadvantages:

The aim of this project is to reduce the cases where tables require to be recreated, improving in this way performance in the update process.

Current state (in 3.0PR15Q1)

The recreation strategy depends on the action and the DB Platform. In 3.0PR15Q1, this is the state:

PostgreSQL Oracle
Append non mandatory column recreates does not recreate
Append mandatory column recreates recreates
Add any column between others recreates recreates
Add constraints, indexes, FKs... does not recreate does not recreate
Data type changes (different size...) recreates recreates
Drop column recreates does not recreate
Drop constraints, indexes, FKs... does not recreate does not recreate

Technical requirements

The main goal of this project is to prevent table recreation in, at last, the most common situations with the motivation explained in the first section of this document.

Dropping existent columns

Though it is not a very common case, dropping columns is correctly implemented in Oracle and it should also be implemented in PostgreSQL. This is a trivial case to implement where the expected improvement when it occurs is huge because dropping a column, even in tables with big volumes is matter of milliseconds.

Adding new columns

Non mandatory without default value

This is a similar case to dropping, where it is already correctly implemented in Oracle but not in PostgreSQL, and here the improvement is equivalent as described for dropping.

Mandatory and non-mandatory with default value

These cases will require to be measured after implementing to determine how non recreation strategy performs compared to recreation.

Inserting new columns before existent ones

This is a common case when an external module modifies structure of a table delivered by another module. Currently, the columns defined in the module owning the table are physically placed in first position and columns added by external modules are appended grouped by module.


In an instance with the following actions:

Table structure modification to move from CA1, CA2, EM_B_B1 to CA1, CA2, CA4, EM_B_B1 is currently not supported by PostgreSQL nor Oracle.

The approach to follow is not to try to preserve physical column position. So in this example the table would be finally CA1, CA2, EM_B_B1, CA4. In this manner old column additions are appended.

Performance requirements

This project has two goals:

Because of all of this, it is expected to have a big performance improvement when adding new non mandatory columns without default value, this is specially noticeable the bigger the table is. In other cases the requirement is to have, at least, the same performance as before the project.


Table recreation will continue in some cases:

Retrieved from ""

This page has been accessed 418 times. This page was last modified on 20 April 2015, at 07:43. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.