~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/rename.rst

  • Committer: Marisa Plumb
  • Date: 2011-03-30 03:12:02 UTC
  • mto: This revision was merged to the branch mainline in revision 2283.
  • Revision ID: marisa.plumb@gmail.com-20110330031202-z1q0xlnzdrqobvjv
doc fixes

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
 
4
4
Rename a table, or group of tables.
5
5
 
 
6
If you have an existing table old_name, you can create another table new_name; it will be empty but reptant he same structure, and then replace the existing table with the empty one as follows (assuming backup_table does not already exist):
 
7
 
 
8
.. code-block:: mysql
 
9
 
 
10
        CREATE TABLE new_name (...);
 
11
        RENAME TABLE old_name TO backup_table, new_name TO old_name;
 
12
 
 
13
When using a statement to rename more than one table, the order of operations are done from left to right. To swap two table names, use the following (assuming tmp_table does not already exist):
 
14
 
 
15
.. code-block:: mysql
 
16
 
 
17
        RENAME TABLE old_name TO tmp_table,
 
18
        new_name TO old_name,
 
19
        tmp_table TO new_name;
 
20
 
 
21
While RENAME is running, no other session can access any of the involved tables. 
 
22
 
6
23
.. seealso::
7
24
   :doc:`/alter_table`