← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/man/mysqldbcopy.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/mysqldbcopy.rst
14
14
             (<db_name>[:<new_name>])+ [--verbose | --quiet |
15
15
             --skip=(TABLES,TRIGGERS,VIEWS,PROCEDURES,FUNCTIONS,
16
16
             EVENTS,GRANTS,DATA,CREATE_DB)* | --help | --version |
 
17
             --new-storage-engine=<engine> | --default-storage-engine=<engine> |
17
18
             --threads=<num threads>] | --exclude=<name>[|,--exclude=<name>]
18
19
 
19
20
DESCRIPTION
36
37
all databases whose name begins with trig and has a following character or
37
38
digit.
38
39
 
 
40
To change the storage engine for all tables on the destination, specify the
 
41
new engine with the :option:`--new-storage-engine` option. If the new engine
 
42
specified is available on the destination, all tables will be changed to use
 
43
the engine.
 
44
 
 
45
Similarly, you can specify a different default storage engine with the
 
46
:option:`--default-storage-engine` option. If the engine specified is
 
47
available on the destination, any table that specifies a storage engine that
 
48
is not on the destination will use the new default engine. Note that this
 
49
overrides the default storage engine mechanism on the server.
 
50
 
 
51
If the option :option:`--default-storage-engine` or
 
52
:option:`--new-storage-engine` is supplied and the storage engine specified
 
53
does not exist, a warning shall be issued and the default storage engine
 
54
setting on the server shall be used instead.
 
55
 
39
56
You must provide login information such as user, host, password, etc. for a
40
57
user that has the appropriate rights to access all objects in the operation.
41
58
See :ref:`mysqldb-notes` below for more details.
99
116
 
100
117
    use multiple threads for cross-server copy (default = 1)
101
118
 
 
119
.. option:: --new-storage-engine=NEW_ENGINE
 
120
 
 
121
   Change all tables to use this storage engine if storage engine exists on the
 
122
   destination.
 
123
 
 
124
.. option:: --default-storage-engine=DEF_ENGINE
 
125
 
 
126
   Change all tables to use this storage engine if the original storage engine
 
127
   does not exist on the destination.
 
128
 
102
129
.. _mysqldbcopy-notes:
103
130
 
104
131
NOTES
122
149
contains certain objects such as views or events and whether binary
123
150
logging is turned on (hence the need for **SUPER**).
124
151
 
 
152
The --new-storage-engine and --default-storage-engine options apply to all
 
153
tables in the operation.
 
154
 
125
155
Some combinations of the options may result in errors during the
126
156
operation.  For example, eliminating tables but not views may result
127
157
in an error when the view is copied.