~drizzle-trunk/drizzle/development

:program:`drizzledump` [:ref:`OPTIONS <drizzledump-options-label>`] *database* [*tables*]

 

:program:`drizzledump` [:ref:`OPTIONS <drizzledump-options-label>`] :option:`--databases` *DB1* [*DB2* *DB3*...]

 

:program:`drizzledump` [:ref:`OPTIONS <drizzledump-options-label>`] :option:`--all-databases`

.. _drizzledump-options-label:

 

.. option:: --all-databases, -A

 

Dumps all databases found on the server apart from ``information_schema`` and

``data_dictionary`` in Drizzle and ``information_schema``,

``performance_schema`` and ``mysql`` in MySQL.

 

.. option:: --force, -f

.. option:: --help, -?

.. option:: --lock-all-tables, -x

consistency:

 

.. code-block:: mysql

.. option:: --verbose, -v

Dump every row on an individual line.  For example:

 

.. code-block:: mysql

Add ``DROP DATABASE`` statements before ``CREATE DATABASE``.

.. option:: --databases, -B

.. option:: --skip-disable-keys, -K

Do not dump the statements ``ALTER TABLE ... DISABLE KEYS`` and

``ALTER TABLE ... ENABLE KEYS``

Do not dump specified table, needs to be in the format ``database.table``.

Add the ``IGNORE`` keyword into every ``INSERT`` statement.

Make the dump of each table a single transaction by wrapping it in ``COMMIT``

.. option:: --no-create-db, -n

Do not dump the ``CREATE DATABASE`` statements when using

.. option:: --skip-create, -t

 

Do not dump the ``CREATE TABLE`` statements.

 

.. option:: --no-data, -d

Use ``REPLACE INTO`` statements instead of ``INSERT INTO``

.. option:: --my-data-is-mangled

 

If your data is UTF8 but has been stored in a latin1 table using a latin1

connection then corruption is likely and drizzledump by default will retrieve

mangled data.  This is because MySQL will convert the data to UTF8 on the way

out to drizzledump and you effectively get a double-conversion to UTF8.

 

This typically happens with PHP apps that do not use ``SET NAMES``.

 

In these cases setting this option will retrieve the data as you see it in your

application.

 

.. versionadded:: 2011-01-31

 

.. option:: --host, -h hostname (=localhost)

.. option:: --user, -u username

.. option:: --password, -P password

.. option:: --port, -p port (=4427)

The port number of the database server.

Backups of a database can be made very simply by running the following:

 

.. code-block:: bash

 

  $ drizzledump --all-databases > dumpfile.sql

 

This can then be re-imported into drizzle at a later date using:

 

.. code-block:: bash

 

  $ drizzle < dumpfile.sql

.. warning::

 

   :program:`drizzledump` will by default try to connect via. port 4427 so to

   connect to a MySQL server a port (such as 3306) must be specified.

 

will give you a Drizzle compatible output:

 

.. code-block:: bash

 

  $ drizzledump --all-databases --host=mysql-host --port=3306 --user=mysql-user --password > dumpfile.sql

into a Drizzle server as follows:

 

.. code-block:: bash

 

  $ drizzledump --all-databases --host=mysql-host --port=3306 --user=mysql-user --password --destination-type=database --desination-host=drizzle-host

 

.. note::

 

   Please take special note of :ref:`old-passwords-label` if you have connection

   issues from :program:`drizzledump` to your MySQL server.

 

.. note::

   If you find your VARCHAR and TEXT data does not look correct in a drizzledump

   output, it is likely that you have UTF8 data stored in a non-UTF8 table.  In

   which case please check the :option:`--my-data-is-mangled` option.

 * MyISAM -> InnoDB

 * FullText -> drop it (with stderr warning)

 * int unsigned -> bigint

 * tinyint -> int

 * smallint -> int

 * mediumint -> int

 * tinytext -> text

 * mediumtext -> text

 * longtext -> text

 * tinyblob -> blob

 * mediumblob -> blob

 * longblob -> blob

 * year -> int

 * set -> text [1]_

 * date/datetime default 0000-00-00 -> default NULL [2]_

 * date/datetime NOT NULL columns -> NULL [2]_

 * any date data containing 0000-00-00 -> NULL [2]_

 * time -> int of the number of seconds [3]_

 * enum-> DEFAULT NULL [4]_

 

.. rubric:: Footnotes

 

.. [1] There is currently no good alternative to SET, this is simply to preserve

       the data in the column.  There is a new alternative to SET to be included

       at a later date.

 

.. [2] Currently, ALL date columns have their DEFAULT set to NULL on migration.

       This is so that any rows with 0000-00-00 dates can convert to NULL.

 

.. [3] This prevents data loss since MySQL's TIME data type has a range of

       -838:59:59 - 838:59:59, and Drizzle's TIME type has a range of

       00:00:00 - 23:59:59.

 

.. [4] This is so that empty entries such as '' will convert to NULL.