MySQL - 重命名表

MySQL：重命名表

重命名数据库表是一项常见的管理任务，通常是为反映应用程序逻辑的更改、提高清晰度或遵守新的命名约定所必需的。MySQL 为此提供了两个主要语句：RENAME TABLE 和 ALTER TABLE ... RENAME TO。

重要警告：重命名表的影响

这是一个破坏性操作，可能会导致您的应用程序崩溃。 在重命名表之前，您必须考虑其依赖项。重命名表将不会自动更新以下引用：

• 外键约束
• 视图
• 触发器
• 存储过程和函数
• 应用程序代码（例如，您的后端 API、数据访问层）

在重命名生产表之前，请务必识别并计划更新所有依赖对象和应用程序代码。

方法 1：RENAME TABLE 语句

RENAME TABLE 语句是用于重命名一个或多个表的专用命令。它通常因其清晰的语法和处理多个表的原子性能力而受到青睐。

单个表的语法

RENAME TABLE old_table_name TO new_table_name;

示例：重命名单个表

首先，我们创建一个临时表。

CREATE TABLE TmpUsers (id INT, username VARCHAR(50));

现在，我们将 TmpUsers 重命名为 LegacyUsers。

RENAME TABLE TmpUsers TO LegacyUsers;

验证

现在尝试访问旧表名将导致错误。

DESCRIBE TmpUsers;
-- 错误 1146 (42S02)：表 'your_database.TmpUsers' 不存在

查询新名称将成功：

DESCRIBE LegacyUsers;
-- 显示已重命名表的结构。

多个表的语法

RENAME TABLE 的一个主要优点是它能够在一个原子操作中重命名多个表。这意味着要么所有重命名都成功，要么它们都不成功。

RENAME TABLE old_table1 TO new_table1,
             old_table2 TO new_table2,
             old_table3 TO new_table3;

示例：重命名多个表

-- 创建一些表
CREATE TABLE products_temp (id INT);
CREATE TABLE orders_temp (id INT);

-- 一次性重命名它们
RENAME TABLE products_temp TO products_archive,
             orders_temp TO orders_archive;

方法 2：ALTER TABLE 语句

您还可以使用 ALTER TABLE 语句重命名表。这是用于修改表结构的标准 SQL 语法的一部分，并受许多其他数据库系统支持。

语法

ALTER TABLE old_table_name RENAME TO new_table_name;

示例：使用 ALTER TABLE 重命名

让我们创建另一个表。

CREATE TABLE Invoices (invoice_id INT, amount DECIMAL(10, 2));

现在，使用 ALTER TABLE 重命名它。

ALTER TABLE Invoices RENAME TO AccountInvoices;

结果与使用 RENAME TABLE 相同：旧名称不再有效，新名称已激活。

RENAME TABLE vs. ALTER TABLE

虽然两者对于单个表都实现相同的目标，但 RENAME TABLE 更强大，因为它可以一次操作多个表，甚至可以将表移动到不同的数据库（需要必要的权限），例如 RENAME TABLE db1.mytable TO db2.mytable;。ALTER TABLE 只能在同一个数据库中一次重命名一个表。

通过客户端程序重命名表

从应用程序执行重命名操作非常简单。以下是现代、健壮的示例。

Python 示例 (使用 mysql-connector-python)

import mysql.connector

config = {'user': 'root', 'password': 'your_password', 'host': '127.0.0.1', 'database': 'TUTORIALS'}

old_name = 'my_temp_table'
new_name = 'my_final_table'

try:
    with mysql.connector.connect(**config) as conn:
        with conn.cursor() as cursor:
            print(f"Attempting to rename '{old_name}' to '{new_name}'...")
            # 对表名使用参数化查询需要特殊处理或仔细格式化。
            # 对于标识符，直接格式化很常见，但如果名称来自用户输入，请警惕 SQL 注入。
            cursor.execute(f"RENAME TABLE `{old_name}` TO `{new_name}`")
            print("表重命名成功。")
except mysql.connector.Error as err:
    print(f"Error: {err}")

# 注意：要运行此代码，您必须首先创建 'my_temp_table'。

Node.js 示例 (使用 mysql2/promise 和 async/await)

const mysql = require('mysql2/promise');

const dbConfig = {
    host: 'localhost',
    user: 'root',
    password: 'your_password',
    database: 'TUTORIALS'
};

async function renameTable(oldName, newName) {
    let connection;
    try {
        connection = await mysql.createConnection(dbConfig);
        // 标识符（表/列名）不能用 '?' 进行参数化。
        // 您必须手动转义它们或确保它们是安全的。
        const sql = `ALTER TABLE ${mysql.escapeId(oldName)} RENAME TO ${mysql.escapeId(newName)}`;
        console.log(`Executing: ${sql}`);
        await connection.execute(sql);
        console.log(`Table '${oldName}' renamed to '${newName}' successfully.`);
    } catch (error) {
        console.error(`Failed to rename table: ${error.message}`);
    } finally {
        if (connection) await connection.end();
    }
}

// 要运行此代码，请首先创建一个名为 'old_table' 的表
// CREATE TABLE old_table (id int);
renameTable('old_table', 'new_table');

Java 示例 (使用 JDBC 和 try-with-resources)

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;
import java.sql.SQLException;

public class RenameTableExample {
    private static final String DB_URL = "jdbc:mysql://localhost:3306/TUTORIALS";
    private static final String USER = "root";
    private static final String PASS = "your_password";

    public static void main(String[] args) {
        // 要运行此代码，请首先创建一个名为 'table_to_rename' 的表。
        String sql = "RENAME TABLE table_to_rename TO renamed_table";

        try (Connection conn = DriverManager.getConnection(DB_URL, USER, PASS);
             Statement stmt = conn.createStatement()) {

            stmt.executeUpdate(sql);
            System.out.println("表重命名成功！");

        } catch (SQLException e) {
            System.err.println("SQL operation failed: " + e.getMessage());
            // 示例：如果 'table_to_rename' 不存在，则会失败。
        }
    }
}

PHP 示例 (使用 PDO)

<?php
$dsn = 'mysql:host=localhost;dbname=TUTORIALS;charset=utf8mb4';
$user = 'root';
$pass = 'your_password';
$options = [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION];

$oldName = 'php_test_table';
$newName = 'php_final_table';

try {
    $pdo = new PDO($dsn, $user, $pass, $options);

    // 对于标识符，您必须手动构建查询字符串。
    // 确保名称不是来自不受信任的用户输入，以防止注入。
    $sql = "RENAME TABLE `$oldName` TO `$newName`";

    $pdo->exec($sql);

    echo "Table '$oldName' renamed to '$newName' successfully.";

} catch (PDOException $e) {
    // 这将捕获错误，例如，如果原始表不存在。
    die("ERROR: Could not execute query. " . $e->getMessage());
}

// 要运行此代码，请首先：CREATE TABLE php_test_table (id INT);