One of the routine tasks for a DBA is MySQL renaming database schemas, and as such MySQL added a command to carry out that purpose called “RENAME DATABASE <database_name>”. However, this command just made it through a few minor releases before being discontinued (from MySQL 5.1.7 to 5.1.23). Here’s a link to the reference manual regarding the command http://dev.mysql.com/doc/refman/5.1/en/rename-database.html. Vadim wrote a MySQL Performance Blog post about this a few years ago where he mentions the dangerous nature of this command – that post was appropriately headlined, “Dangerous Command.” Today we will see what are the ways in which a database schema can be renamed and which of them is the quickest.

How to Rename MySQL Databases

Method 1: A well-known method for renaming database schema is by dumping the schema using Mysqldump and restoring it in another schema, and then dropping the old schema (if needed).

[root@percona ~]# mysqldump emp > emp.out [root@percona ~]# mysql -e "CREATE DATABASE employees;" [root@percona ~]# mysql employees < emp.out [root@percona ~]# mysql -e "DROP DATABASE emp;" 1 2 3 4 [ root @ percona ~ ] # mysqldump emp > emp.out [ root @ percona ~ ] # mysql -e "CREATE DATABASE employees;" [ root @ percona ~ ] # mysql employees < emp.out [ root @ percona ~ ] # mysql -e "DROP DATABASE emp;"

Although the above method is easy, it is time and space consuming. What if the schema is more than a 100GB? There are methods where you can pipe the above commands together to save on space, however, it will not save time.

To remedy such situations, there is another quick method to rename schemas, however, some care must be taken while doing it.

Method 2: MySQL has a very good feature for renaming tables that even works across different schemas. This rename operation is atomic and no one else can access the table while it is being renamed. This takes a short time to complete since changing a table’s name or its schema is only a metadata change. Here is the procedural approach at doing the rename:

a) Create the new database schema with the desired name.

b) Rename the tables from old schema to the new schema, using MySQL’s “RENAME TABLE” command.

c) Drop the old database schema.

If there are views, triggers, functions, stored procedures in the schema, those will need to be recreated too. MySQL’s “RENAME TABLE” fails if there are triggers exists on the tables. To remedy this we can do the following things :

1) Dump the triggers, events and stored routines in a separate file. This is done using -E, -R flags (in addition to -t -d which dumps the triggers) to the mysqldump command. Once triggers are dumped, we will need to drop them from the schema, for RENAME TABLE command to work.

$ mysqldump <old_schema_name> -d -t -R -E > stored_routines_triggers_events.out 1 $ mysqldump < old_schema_name > - d - t - R - E > stored_routines_triggers_events .out

2) Generate a list of only “BASE” tables. These can be found using a query on information_schema.TABLES table.

mysql> select TABLE_NAME from information_schema.tables where table_schema='<old_schema_name>' and TABLE_TYPE='BASE TABLE'; 1 mysql > select TABLE_NAME from information_schema .tables where table_schema = '<old_schema_name>' and TABLE_TYPE = 'BASE TABLE' ;

3) Dump the views in an out file. Views can be found using a query on the same information_schema.TABLES table.

mysql> select TABLE_NAME from information_schema.tables where table_schema='<old_schema_name>' and TABLE_TYPE='VIEW'; $ mysqldump <database> <view1> <view2> … > views.out 1 2 mysql > select TABLE_NAME from information_schema .tables where table_schema = '<old_schema_name>' and TABLE_TYPE = 'VIEW' ; $ mysqldump < database > < view1 > < view2 > … > views .out

4) Drop the triggers on the current tables in the old_schema.

mysql> DROP TRIGGER <trigger_name>; ... 1 2 mysql > DROP TRIGGER < trigger_name > ; . . .

5) Restore the above dump files once all the “Base” tables found in step #2 are renamed.

mysql> RENAME TABLE <old_schema>.table_name TO <new_schema>.table_name; ... $ mysql <new_schema> < views.out $ mysql <new_schema> < stored_routines_triggers_events.out 1 2 3 4 mysql > RENAME TABLE < old_schema > .table_name TO < new_schema > .table_name ; . . . $ mysql < new_schema > < views .out $ mysql < new_schema > < stored_routines_triggers_events .out

Intricacies with above methods :

We may need to update the GRANTS for users such that they match the correct schema_name. These could be fixed with a simple UPDATE on mysql.columns_priv, mysql.procs_priv, mysql.tables_priv, mysql.db tables updating the old_schema name to new_schema and calling “Flush privileges;”.

Although “method 2” seems a bit more complicated than the “method 1”, this is totally scriptable. A simple bash script to carry out the above steps in proper sequence can help you save space and time while renaming database schemas next time.

We on the Percona Remote DBA team have written a script called “rename_db” that works in the following way :

[root@percona ~]# /tmp/rename_db rename_db <server> <database> <new_database> 1 2 [ root @ percona ~ ] # /tmp/rename_db rename_db < server > < database > < new_database >

To demonstrate the use of this script, we used a sample schema “emp”, created test triggers, stored routines on that schema. We will try to rename the database schema using the script, which takes some seconds to complete as opposed to time-consuming dump/restore method.

mysql> show databases; +--------------------+ | Database | +--------------------+ | information_schema | | emp | | mysql | | performance_schema | | test | +--------------------+ 1 2 3 4 5 6 7 8 9 10 mysql > show databases ; + -- -- -- -- -- -- -- -- -- -- + | Database | + -- -- -- -- -- -- -- -- -- -- + | information_schema | | emp | | mysql | | performance_schema | | test | + -- -- -- -- -- -- -- -- -- -- +

[root@percona ~]# time /tmp/rename_db localhost emp emp_test create database emp_test DEFAULT CHARACTER SET latin1 drop trigger salary_trigger rename table emp.__emp_new to emp_test.__emp_new rename table emp._emp_new to emp_test._emp_new rename table emp.departments to emp_test.departments rename table emp.dept to emp_test.dept rename table emp.dept_emp to emp_test.dept_emp rename table emp.dept_manager to emp_test.dept_manager rename table emp.emp to emp_test.emp rename table emp.employees to emp_test.employees rename table emp.salaries_temp to emp_test.salaries_temp rename table emp.titles to emp_test.titles loading views loading triggers, routines and events Dropping database emp real 0m0.643s user 0m0.053s sys 0m0.131s 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 [ root @ percona ~ ] # time /tmp/rename_db localhost emp emp_test create database emp_test DEFAULT CHARACTER SET latin1 drop trigger salary_trigger rename table emp .__emp_new to emp_test .__emp_new rename table emp ._emp_new to emp_test ._emp_new rename table emp .departments to emp_test .departments rename table emp .dept to emp_test .dept rename table emp .dept_emp to emp_test .dept_emp rename table emp .dept_manager to emp_test .dept_manager rename table emp .emp to emp_test .emp rename table emp .employees to emp_test .employees rename table emp .salaries_temp to emp_test .salaries_temp rename table emp .titles to emp_test .titles loading views loading triggers , routines and events Dropping database emp real 0m0.643s user 0m0.053s sys 0m0.131s

mysql> show databases; +--------------------+ | Database | +--------------------+ | information_schema | | emp_test | | mysql | | performance_schema | | test | +--------------------+ 1 2 3 4 5 6 7 8 9 10 mysql > show databases ; + -- -- -- -- -- -- -- -- -- -- + | Database | + -- -- -- -- -- -- -- -- -- -- + | information_schema | | emp_test | | mysql | | performance_schema | | test | + -- -- -- -- -- -- -- -- -- -- +

As you can see in the above output the database schema “emp” was renamed to “emp_test” in less than a second.

Lastly, we are happy to share the script we used above for “method 2”.

rename_db #!/bin/bash # Copyright 2013 Percona LLC and/or its affiliates set -e if [ -z "$3" ]; then echo "rename_db <server> <database> <new_database>" exit 1 fi db_exists=`mysql -h $1 -e "show databases like '$3'" -sss` if [ -n "$db_exists" ]; then echo "ERROR: New database already exists $3" exit 1 fi TIMESTAMP=`date +%s` character_set=`mysql -h $1 -e "show create database $2G" -sss | grep ^Create | awk -F'CHARACTER SET ' '{print $2}' | awk '{print $1}'` TABLES=`mysql -h $1 -e "select TABLE_NAME from information_schema.tables where table_schema='$2' and TABLE_TYPE='BASE TABLE'" -sss` STATUS=$? if [ "$STATUS" != 0 ] || [ -z "$TABLES" ]; then echo "Error retrieving tables from $2" exit 1 fi echo "create database $3 DEFAULT CHARACTER SET $character_set" mysql -h $1 -e "create database $3 DEFAULT CHARACTER SET $character_set" TRIGGERS=`mysql -h $1 $2 -e "show triggersG" | grep Trigger: | awk '{print $2}'` VIEWS=`mysql -h $1 -e "select TABLE_NAME from information_schema.tables where table_schema='$2' and TABLE_TYPE='VIEW'" -sss` if [ -n "$VIEWS" ]; then mysqldump -h $1 $2 $VIEWS > /tmp/${2}_views${TIMESTAMP}.dump fi mysqldump -h $1 $2 -d -t -R -E > /tmp/${2}_triggers${TIMESTAMP}.dump for TRIGGER in $TRIGGERS; do echo "drop trigger $TRIGGER" mysql -h $1 $2 -e "drop trigger $TRIGGER" done for TABLE in $TABLES; do echo "rename table $2.$TABLE to $3.$TABLE" mysql -h $1 $2 -e "SET FOREIGN_KEY_CHECKS=0; rename table $2.$TABLE to $3.$TABLE" done if [ -n "$VIEWS" ]; then echo "loading views" mysql -h $1 $3 < /tmp/${2}_views${TIMESTAMP}.dump fi echo "loading triggers, routines and events" mysql -h $1 $3 < /tmp/${2}_triggers${TIMESTAMP}.dump TABLES=`mysql -h $1 -e "select TABLE_NAME from information_schema.tables where table_schema='$2' and TABLE_TYPE='BASE TABLE'" -sss` if [ -z "$TABLES" ]; then echo "Dropping database $2" mysql -h $1 $2 -e "drop database $2" fi if [ `mysql -h $1 -e "select count(*) from mysql.columns_priv where db='$2'" -sss` -gt 0 ]; then COLUMNS_PRIV=" UPDATE mysql.columns_priv set db='$3' WHERE db='$2';" fi if [ `mysql -h $1 -e "select count(*) from mysql.procs_priv where db='$2'" -sss` -gt 0 ]; then PROCS_PRIV=" UPDATE mysql.procs_priv set db='$3' WHERE db='$2';" fi if [ `mysql -h $1 -e "select count(*) from mysql.tables_priv where db='$2'" -sss` -gt 0 ]; then TABLES_PRIV=" UPDATE mysql.tables_priv set db='$3' WHERE db='$2';" fi if [ `mysql -h $1 -e "select count(*) from mysql.db where db='$2'" -sss` -gt 0 ]; then DB_PRIV=" UPDATE mysql.db set db='$3' WHERE db='$2';" fi if [ -n "$COLUMNS_PRIV" ] || [ -n "$PROCS_PRIV" ] || [ -n "$TABLES_PRIV" ] || [ -n "$DB_PRIV" ]; then echo "IF YOU WANT TO RENAME the GRANTS YOU NEED TO RUN ALL OUTPUT BELOW:" if [ -n "$COLUMNS_PRIV" ]; then echo "$COLUMNS_PRIV"; fi if [ -n "$PROCS_PRIV" ]; then echo "$PROCS_PRIV"; fi if [ -n "$TABLES_PRIV" ]; then echo "$TABLES_PRIV"; fi if [ -n "$DB_PRIV" ]; then echo "$DB_PRIV"; fi echo " flush privileges;" fi 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 #!/bin/bash # Copyright 2013 Percona LLC and/or its affiliates set - e if [ - z "$3" ] ; then echo "rename_db <server> <database> <new_database>" exit 1 fi db_exists = ` mysql - h $ 1 - e "show databases like '$3'" - sss ` if [ - n "$db_exists" ] ; then echo "ERROR: New database already exists $3" exit 1 fi TIMESTAMP = ` date + % s ` character_set = ` mysql - h $ 1 - e "show create database $2G" - sss | grep ^ Create | awk - F 'CHARACTER SET ' '{print $2}' | awk '{print $1}' ` TABLES = ` mysql - h $ 1 - e "select TABLE_NAME from information_schema.tables where table_schema='$2' and TABLE_TYPE='BASE TABLE'" - sss ` STATUS = $ ? if [ "$STATUS" != 0 ] || [ - z "$TABLES" ] ; then echo "Error retrieving tables from $2" exit 1 fi echo "create database $3 DEFAULT CHARACTER SET $character_set" mysql - h $ 1 - e "create database $3 DEFAULT CHARACTER SET $character_set" TRIGGERS = ` mysql - h $ 1 $ 2 - e "show triggersG" | grep Trigger : | awk '{print $2}' ` VIEWS = ` mysql - h $ 1 - e "select TABLE_NAME from information_schema.tables where table_schema='$2' and TABLE_TYPE='VIEW'" - sss ` if [ - n "$VIEWS" ] ; then mysqldump - h $ 1 $ 2 $VIEWS > / tmp / $ { 2 } _views $ { TIMESTAMP } .dump fi mysqldump - h $ 1 $ 2 - d - t - R - E > / tmp / $ { 2 } _triggers $ { TIMESTAMP } .dump for TRIGGER in $TRIGGERS ; do echo "drop trigger $TRIGGER" mysql - h $ 1 $ 2 - e "drop trigger $TRIGGER" done for TABLE in $TABLES ; do echo "rename table $2.$TABLE to $3.$TABLE" mysql - h $ 1 $ 2 - e "SET FOREIGN_KEY_CHECKS=0; rename table $2.$TABLE to $3.$TABLE" done if [ - n "$VIEWS" ] ; then echo "loading views" mysql - h $ 1 $ 3 < / tmp / $ { 2 } _views $ { TIMESTAMP } .dump fi echo "loading triggers, routines and events" mysql - h $ 1 $ 3 < / tmp / $ { 2 } _triggers $ { TIMESTAMP } .dump TABLES = ` mysql - h $ 1 - e "select TABLE_NAME from information_schema.tables where table_schema='$2' and TABLE_TYPE='BASE TABLE'" - sss ` if [ - z "$TABLES" ] ; then echo "Dropping database $2" mysql - h $ 1 $ 2 - e "drop database $2" fi if [ ` mysql - h $ 1 - e "select count(*) from mysql.columns_priv where db='$2'" - sss ` - gt 0 ] ; then COLUMNS_PRIV = " UPDATE mysql.columns_priv set db='$3' WHERE db='$2';" fi if [ ` mysql - h $ 1 - e "select count(*) from mysql.procs_priv where db='$2'" - sss ` - gt 0 ] ; then PROCS_PRIV = " UPDATE mysql.procs_priv set db='$3' WHERE db='$2';" fi if [ ` mysql - h $ 1 - e "select count(*) from mysql.tables_priv where db='$2'" - sss ` - gt 0 ] ; then TABLES_PRIV = " UPDATE mysql.tables_priv set db='$3' WHERE db='$2';" fi if [ ` mysql - h $ 1 - e "select count(*) from mysql.db where db='$2'" - sss ` - gt 0 ] ; then DB_PRIV = " UPDATE mysql.db set db='$3' WHERE db='$2';" fi if [ - n "$COLUMNS_PRIV" ] || [ - n "$PROCS_PRIV" ] || [ - n "$TABLES_PRIV" ] || [ - n "$DB_PRIV" ] ; then echo "IF YOU WANT TO RENAME the GRANTS YOU NEED TO RUN ALL OUTPUT BELOW:" if [ - n "$COLUMNS_PRIV" ] ; then echo "$COLUMNS_PRIV" ; fi if [ - n "$PROCS_PRIV" ] ; then echo "$PROCS_PRIV" ; fi if [ - n "$TABLES_PRIV" ] ; then echo "$TABLES_PRIV" ; fi if [ - n "$DB_PRIV" ] ; then echo "$DB_PRIV" ; fi echo " flush privileges;" fi