E-Maj 2.3.1

This Release
E-Maj 2.3.1
Date
Status
Stable
Other Releases
Abstract
E-Maj is a PostgreSQL extension which enables fine-grained write logging and time travel on subsets of the DB.
Description
Using triggers, E-Maj logs INSERT/UPDATE/DELETE executions in order to be able to look at the tables updates and cancel them through 'rollback operations'. It includes advanced features like statistics about updates, parallel rollbacks or 'logged rollback' allowing to ... cancel a rollback. A web GUI tool also helps in performing all E-Maj tasks.
Released By
beaud76
License
The GNU General Public License, Version 3, June 2007
Resources
Special Files
Tags

Extensions

emaj 2.3.1
Tables updates log and rollback

Documentation

AUTHORS
Here are the contributors of the E-Maj extension.
CHANGES
E-Maj - Change log

README

E-Maj

E-Maj: logs and rollbacks table updates

Version: 2.3.1

License

This software is distributed under the GNU General Public License.

Objectives

The main goals of E-Maj are:

  • log updates performed on one or several sets of tables.
  • cancel these updates if needed, and reset a tables set to a predefined stable state.

In development environments, it brings a good help in testing application, providing an easy way to rollback all updates generated by programs execution, and replay these processings as many times as needed.

In production environments, it brings a good solution to:

  • keep an history of updates performed on tables to examine them in case of problem
  • set inter-batch savepoints on group of tables,
  • easily "restore" this group of tables at a stable state, without being obliged to stop the cluster,
  • handle several savepoints during batch windows, each of them been usable at any time as "restore point".

It brings a good alternative to the management of several database disk images.

In both environments, being able to examine the history of updates performed on tables can be very helpful in debugging work or for any other purposes.

Distribution

E-Maj is available via the PGXN platform (https://pgxn.org/dist/e-maj/). It is also available on github (https://github.com/beaud76/emaj).

Documentation

A detailed documentation can be found here, in English and in French.

How to install and use E-Maj

E-Maj can be installed using the usual method for postgres extensions (ie. CREATE EXTENSION emaj;).

The documentation contains all the detailled information needed to install and use E-Maj.

E-Maj web GUI

Two web GUI tools are available to bring a user friendly E-Maj administration:

  • a stand alone php application, named Emaj_web,
  • a plug-in for phpPgAdmin that takes benefit from the plugin architecture brought by phpPgAdmin 5.1+.

Both tools share the same functionalities regarding the E-Maj usage.

The Emaj_web client is available on github.

The phpPgAdmin plugin is available on github.

Their installation and usage are also described in the documentation.

Contributing

Any contribution on the project is welcome. A part of the documentation deals with how to contribute.

Support

For additional support or bug report, please contact Philippe BEAUDOIN (phb

Any feedback is welcome, even to just notice you use and appreciate E-Maj ;-)