# Dumperor: Multi-Database Dumping Toolkit   2010-09-23

Dumperor is a multi-database dumping toolkit. It dumps table structures and data from databases, and generates CREATE-TABLE SQL statements for table structures or INSERT SQL statements for data.

Part of the original intention for developing Dumperor is to check whether a migration of SQL scripts from one database to another is successful, you know, by comparing the differences between two files, one dumped before executing scripts and the other after. The second part is to ensure that upgrades to table structures or data not miss anything, similarly. The last part is to take samples of databases and put up development or testing environments with them, or even replace sensitive information with fake data.

Dumperor is written in PHP 5 and hosted on GitHub with the New BSD License:

https://github.com/xbot/Dumperor

For the shortage of time, there must be some limitations and bugs in Dumperor. So reports from users are welcome, emails prefered. I will be very grateful if someone send their suggestions on Dumpeor to me.

## Features

1. Currently support Microsoft SQL Server, Oracle and MySQL.

2. Dump table structures and generate CREATE-TABLE SQL statements.

3. Dump data and generate INSERT SQL statements.

4. Dump table structures or data and output them in a human readable format.

5. Save dumped information to user-specified files.

6. Display table structures with web page tables in the web browser.

7. Options controlling which information should be displayed in the web browser.

8. Options controlling which information should be and should not be dumped from the database.

9. A limit number can be set to take sample of a huge database.

10. Needless tables or columns can be prevented from appearing in dumped results.

11. Only the needed tables are to be exported if you like.

12. Sensitive columns can be dumped with fake data.

13. Conditions can be added to data querying statements.

14. With PDO support by default but extensive to many kinds of database toolkits.

15. More in the future …

## Requirements

1. A web server configured with PHP5 support.

2. PDO feature of PHP.

3. PHP 5.x, notice that some versions in 5.3.x series have a bug in function parse_ini_file(), which may cause trouble.

## Limitations (Known Issues)

1. Conditions for data querying only support numeric columns and equation relation.

2. Support for auto increment columns has not been implemented.

3. Sensitive columns must be prefixed with table names.

4. Needless columns must be specified only with column names, nothing more.

5. Data types which have not been tested may fail dumping.

## Installation Instructions

1. Download a stable release from GitHub or clone a git repo:

• git clone git://github.com/xbot/Dumperor.git

2. Copy files to a folder which can be visited by the web server, e.g. www/dumperor.

3. Rename dumperor.ini.sample to dumperor.ini and change the settings to meet your needs.

4. Visit Dumperor from the web browser to start dumping.

## News

1. 2011-03-14 v1.0.0 released. changelog

2. 2010-09-22 v0.1a released. changelog