public function DatabaseSchema_mysql::renameTable

Rename a table.

Parameters

string $table: The table to be renamed.

string $new_name: The new name for the table.

Throws

DatabaseSchemaObjectDoesNotExistException If the specified table doesn't exist.

DatabaseSchemaObjectExistsException If a table with the specified new name already exists.

Overrides DatabaseSchema::renameTable

File

core/includes/database/mysql/schema.inc, line 318

Database schema code for MySQL database servers.

Class

DatabaseSchema_mysql

Class to create and manipulate MySQL tables.

Code

public function renameTable($table, $new_name) {
  if (!$this->tableExists($table)) {
    throw new DatabaseSchemaObjectDoesNotExistException(t("Cannot rename @table to @table_new: table @table doesn't exist.", array(
      '@table' => $table,
      '@table_new' => $new_name,
    )));
  }
  if ($this->tableExists($new_name)) {
    throw new DatabaseSchemaObjectExistsException(t("Cannot rename @table to @table_new: table @table_new already exists.", array(
      '@table' => $table,
      '@table_new' => $new_name,
    )));
  }

  $info = $this->getPrefixInfo($new_name);
  return $this->connection->query('ALTER TABLE {' . $table . '} RENAME TO `' . $info['table'] . '`');
}