← Back to branch summary

~chuck-bell/mysql-utilities/mysql-utilities

« back to all changes in this revision

Viewing changes to doc/man/mysqldbimport.rst

  • Committer: chuck.bell at oracle
  • Date: 2011-07-05 22:09:50 UTC
  • Revision ID: chuck.bell@oracle.com-20110705220950-ehp8m1ukj6uqi1y7
BUG#12632010 : Add feature to allow conversion of storage engines on copy or import

This patch adds the ability to specify a different storage engine for
all tables during a copy or import operation in mysqldbcopy and 
mysqldbimport using a new option named --new-storage-engine.

The patch also adds the ability to specify a default storage engine to
use if the storage engine specified in the import or from the source
during a copy is not available on the destination. This option is
--default-storage-engine. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/mysqldbimport.rst
15
15
             EVENTS,GRANTS,DATA,CREATE_DB)* | --skip-blobs | --verbose |
16
16
             --version | --bulk-insert | --drop-first ]
17
17
             --import=[DEFINITIIONS|DATA|BOTH] |
18
 
             --format=[SQL|S|GRID|G|TAB|T|CSV|C|VERTICAL|V]
 
18
             --format=[SQL|S|GRID|G|TAB|T|CSV|C|VERTICAL|V] |
 
19
             --new-storage-engine=<engine> | --default-storage-engine=<engine>
19
20
             <file> [|,<file>]
20
21
 
21
22
DESCRIPTION
62
63
You can turn off all feedback information by specifying the
63
64
:option:`--quiet` option.
64
65
 
 
66
To change the storage engine for all tables on the destination, specify the
 
67
new engine with the :option:`--new-storage-engine` option. If the new engine
 
68
specified is available on the destination, all tables will be changed to use
 
69
the engine.
 
70
 
 
71
Similarly, you can specify a different default storage engine with the
 
72
:option:`--default-storage-engine` option. If the engine specified is
 
73
available on the destination, any table that specifies a storage engine that
 
74
is not on the destination will use the new default engine. Note that this
 
75
overrides the default storage engine mechanism on the server.
 
76
 
 
77
If the option :option:`--default-storage-engine` or
 
78
:option:`--new-storage-engine` is supplied and the storage engine specified
 
79
does not exist, a warning shall be issued and the default storage engine
 
80
setting on the server shall be used instead.
 
81
 
65
82
You must provide login information such as user, host, password, etc. for a
66
83
user that has the appropriate rights to access all objects in the operation.
67
84
See :ref:`mysqldbimport-notes` below for more details.
127
144
.. option:: --skip-blobs
128
145
 
129
146
   Do not import blob data.
 
147
   
 
148
.. option:: --new-storage-engine=NEW_ENGINE
 
149
 
 
150
   Change all tables to use this storage engine if storage engine exists on the
 
151
   destination.
 
152
 
 
153
.. option:: --default-storage-engine=DEF_ENGINE
 
154
 
 
155
   Change all tables to use this storage engine if the original storage engine
 
156
   does not exist on the destination.
130
157
 
131
158
.. _`mysqldbimport-notes`:
132
159
 
146
173
operation.  For example, eliminating tables but not views may result
147
174
in an error when the view is imported on another server.
148
175
 
 
176
The --new-storage-engine and --default-storage-engine options apply to all
 
177
tables in the operation.
 
178
 
149
179
EXAMPLES
150
180
--------
151
181