翻译：MariaDB RENAME TABLE语句

*/

.hljs {
display: block;
overflow-x: auto;
padding: 0.5em;
color: #333;
background: #f8f8f8;
}

.hljs-comment,
.hljs-template_comment,
.diff .hljs-header,
.hljs-javadoc {
color: #998;
font-style: italic;
}

.hljs-keyword,
.css .rule .hljs-keyword,
.hljs-winutils,
.javascript .hljs-title,
.nginx .hljs-title,
.hljs-subst,
.hljs-request,
.hljs-status {
color: #333;
font-weight: bold;
}

.hljs-number,
.hljs-hexcolor,
.ruby .hljs-constant {
color: #099;
}

.hljs-string,
.hljs-tag .hljs-value,
.hljs-phpdoc,
.tex .hljs-formula {
color: #d14;
}

.hljs-title,
.hljs-id,
.coffeescript .hljs-params,
.scss .hljs-preprocessor {
color: #900;
font-weight: bold;
}

.javascript .hljs-title,
.lisp .hljs-title,
.clojure .hljs-title,
.hljs-subst {
font-weight: normal;
}

.hljs-class .hljs-title,
.haskell .hljs-type,
.vhdl .hljs-literal,
.tex .hljs-command {
color: #458;
font-weight: bold;
}

.hljs-tag,
.hljs-tag .hljs-title,
.hljs-rules .hljs-property,
.django .hljs-tag .hljs-keyword {
color: #000080;
font-weight: normal;
}

.hljs-attribute,
.hljs-variable,
.lisp .hljs-body {
color: #008080;
}

.hljs-regexp {
color: #009926;
}

.hljs-symbol,
.ruby .hljs-symbol .hljs-string,
.lisp .hljs-keyword,
.tex .hljs-special,
.hljs-prompt {
color: #990073;
}

.hljs-built_in,
.lisp .hljs-title,
.clojure .hljs-built_in {
color: #0086b3;
}

.hljs-preprocessor,
.hljs-pragma,
.hljs-pi,
.hljs-doctype,
.hljs-shebang,
.hljs-cdata {
color: #999;
font-weight: bold;
}

.hljs-deletion {
background: #fdd;
}

.hljs-addition {
background: #dfd;
}

.diff .hljs-change {
background: #0086b3;
}

.hljs-chunk {
color: #aaa;
}

#container {
padding: 15px;
}
pre {
border: 1px solid #ccc;
border-radius: 4px;
display: block;
background-color: #f8f8f8;
}
pre code {
white-space: pre-wrap;
}
.hljs,
code {
font-family: Monaco, Menlo, Consolas, 'Courier New', monospace;
}
:not(pre) > code {
padding: 2px 4px;
font-size: 90%;
color: #c7254e;
background-color: #f9f2f4;
white-space: nowrap;
border-radius: 4px;
}
-->

本文为mariadb官方手册：rename table的译文。

原文：https://mariadb.com/kb/en/library/rename-table/

我提交到MariaDB官方手册的译文：https://mariadb.com/kb/zh-cn/rename-table/

Syntax

RENAME TABLE tbl_name
  [WAIT n | NOWAIT]
  TO new_tbl_name
    [, tbl_name2 TO new_tbl_name2] ...

Description

该语句可以重命名一个或多个表或视图，但不会改变与它们相关的权限。

rename操作是原子性的，这意味着其他会话无法访问正在执行的rename语句所涉及的表。无法命名为已存在的表或视图，但可以通过小技巧来实现。例如，如果已存在一个表old_table，可以创建另一个具有相同结构的空表new_table，然后使用该空表替换已存在的表(假定不存在backup_table表)：

CREATE TABLE new_table (...);
RENAME TABLE old_table TO backup_table, new_table TO old_table;

tab_name可以指定为db_name.tbl_name。见Identifier Qualifiers。这使得RENAME可以将表从一个数据库移动到另一个数据库下(只要两个数据库在同一文件系统下):

RENAME TABLE db1.t TO db2.t;

注意，如果已经存在涉及表的触发器，则无法跨数据库移动，将产生类似如下的错误信息：

ERROR 1435 (HY000): Trigger in wrong schema

视图同样无法跨数据库移动：

ERROR 1450 (HY000): Changing schema from 'old_db' to 'new_db' is not allowed.

RENAME TABLE无法操作临时表，可以使用ALTER TABLE来实现：

CREATE TEMPORARY TABLE t1 (c INT);
ALTER TABLE t1 RENAME TO t2;

如果RENAME TABLE重命名了多于一个表且其中一个命名失败时，所有的包括已经执行命名操作的表都会回滚，因为rename操作是原子性的。

rename操作按照语句中指定的顺序对表进行重命名。鉴于此，可以交换两表之间的数据：

RENAME TABLE t1 TO tmp_table,
    t2 TO t1,
    tmp_table TO t2;

从MariaDB 10.3.0开始，引入WAIT/NOWAIT选项，可以设置锁等待超时时间。见我的另一篇翻译：WAIT and NOWAIT。