此页面由 Cloud Translation API 翻译。

管理表名称

本页面介绍了如何重命名表，以及如何添加、使用和删除表同义词。

表重命名和同义词的选项

您可以使用 ALTER TABLE 语句执行以下操作：

重命名表并将旧名称添加到同义词。
交换表名称。
重命名单个表。
使用单个同义词创建新表。
向表添加单个同义词而不重命名。

使用同义词重命名表格的运作方式

常见的场景是重命名表并添加包含旧表名称的同义词。重命名表后，您可以更新应用以在时间表中使用新名称。在此期间，一些应用可能使用旧名称，而其他应用可能使用新名称。

将所有应用更新为使用新名称后，我们建议您移除同义词。虽然使用同义词不会影响性能，但在删除同义词之前，您不能在其他地方使用旧名称。

同义词以 synonym 对象的形式存储在架构中。一个表中只能有一个同义词。

如需了解详情，请参阅重命名表并添加同义词。

表名称交换的工作原理

如果需要在两个表之间交换名称，您可以将 RENAME TO 语句串联起来，以在同一语句中重命名两个表。这样，您就可以将应用链接到其他表，而不会出现中断的情况。

如需了解详情，请参阅交换表名称。

表格重命名的运作方式

重命名表时，Spanner 会更改表架构中的表名称。重命名表会将所有使用新表名称的子表交错。重命名表还会更改对表的引用，以便执行以下操作：

索引
外键
变更流
精细访问权限控制 (FGAC)

Spanner 不会自动更新视图以使用新的表名称。

如需了解详情，请参阅重命名表格。

表重命名限制

重命名表存在以下限制：

如果一个表与另一个表中交错，则不能将该表重命名为该表中的列名称。
如果表具有视图，您可能需要删除视图，并在重命名表后重新创建视图。

同义词的工作原理

您可以使用同义词创建新表，也可以更改表以向其添加同义词，而无需重命名表。当您想要将数据库同时用于生产环境和测试环境时，可能需要执行此操作。

如需了解详情，请参阅向表添加同义词。

权限

如需重命名表或为表添加同义词，您需要 spanner.databases.updateDdl 权限。如需检查或修改权限，请参阅向原则授予权限。

重命名表并添加同义词

GoogleSQL

使用 ALTER TABLE RENAME TO ADD SYNONYM 重命名表并添加同义词。

  ALTER TABLE table_name RENAME TO new_table_name, ADD SYNONYM table_name;

PostgreSQL

使用 ALTER TABLE RENAME WITH ADD SYNONYM 重命名表并添加同义词。

  ALTER TABLE table_name RENAME WITH SYNONYM TO new_table_name;

以下示例展示了如何重命名表和添加同义词。例如，如果您使用以下 DDL 创建表：

GoogleSQL

  CREATE TABLE Singers (
      SingerId INT64 NOT NULL,
      SingerName STRING(1024)
  ), PRIMARY KEY (SingerId);

PostgreSQL

  CREATE TABLE singers (
      singer_id BIGINT,
      singer_name VARCHAR(1024),
      PRIMARY KEY (singer_id));

您可以发出以下 DDL 请求，以重命名表并将现有名称移至 synonym 对象。

GoogleSQL

  ALTER TABLE Singers RENAME TO SingersNew, ADD SYNONYM Singers;

PostgreSQL

  ALTER TABLE singers RENAME WITH SYNONYM TO singers_new;

交换表名称

以下 DDL 语句会以原子方式更改多个表的名称。在一对或多对表之间交换名称时，这非常有用。

GoogleSQL

使用 RENAME TABLE。

  RENAME TABLE old_name1 TO new_name1 [,old_name2 TO new_name2 ...];

PostgreSQL

使用 ALTER TABLE RENAME TO。

  ALTER TABLE [ IF EXISTS ] [ ONLY ] table_name1
        RENAME TO new_table_name1
        [, ALTER TABLE [ IF EXISTS ] [ ONLY ] table_name2
              RENAME TO new_table_name2 ...];

以下示例展示了如何交换两个表的名称。这需要将第一个表重命名为临时名称，将第二个表重命名为第一个表的名称，然后将第一个表重命名为第二个表的名称。

如果您按如下方式创建了两个表：

GoogleSQL

  CREATE TABLE Singers (
        SingerId INT64 NOT NULL,
        SingerName STRING(1024)
        ), PRIMARY KEY (SingerId);

  CREATE TABLE SingersNew (
        SingerId INT64 NOT NULL,
        FirstName STRING(1024),
        MiddleName STRING(1024),
        LastName STRING(1024)
        ), PRIMARY KEY (SingerId);

PostgreSQL

  CREATE TABLE singers (
        singer_id BIGINT,
        singer_name VARCHAR(1024),
        PRIMARY KEY (singer_id)
        );

  CREATE TABLE singers_new (
        singer_id BIGINT,
        first_name VARCHAR(1024),
        middle_name VARCHAR(1024),
        last_name VARCHAR(1024)
        PRIMARY KEY (singer_id)
        );

您可以使用以下 DDL 请求来交换表名称：

GoogleSQL

  RENAME TABLE Singers TO Temp, SingersNew TO Singers, Temp TO SingersNew;

PostgreSQL

  ALTER TABLE singers RENAME TO temp,
        ALTER TABLE singers_new RENAME TO singers,
        ALTER TABLE temp RENAME TO singers_new;

应用 DDL 语句后，表名称将交换：

GoogleSQL

  CREATE TABLE Singers (
        SingerId INT64 NOT NULL,
        FirstName STRING(1024),
        MiddleName STRING(1024),
        LastName STRING(1024)
        ), PRIMARY KEY (SingerId);

  CREATE TABLE SingersNew (
        SingerId INT64 NOT NULL,
        SingerName STRING(1024)
        ), PRIMARY KEY (SingerId);

PostgreSQL

  CREATE TABLE singers (
        singer_id BIGINT,
        first_name VARCHAR(1024),
        middle_name VARCHAR(1024),
        last_name VARCHAR(1024)
        PRIMARY KEY (singer_id)
        );

  CREATE TABLE singers_new (
        singer_id BIGINT,
        singer_name VARCHAR(1024),
        PRIMARY KEY (singer_id)
        );

重命名表

如需重命名表，请使用以下语法：

GoogleSQL

使用 ALTER NAME 或 RENAME TABLE 语句。

  ALTER TABLE table_name RENAME TO new_table_name;
  RENAME TABLE table_name TO new_table_name;

PostgreSQL

使用 ALTER TABLE RENAME TO 语句。

  ALTER TABLE [ IF EXISTS ] [ ONLY ] table_name
        RENAME TO new_table_name;

以下示例展示了重命名表的 DDL 请求：

GoogleSQL

  RENAME TABLE Singers TO SingersNew;

PostgreSQL

  ALTER TABLE singers RENAME TO singers_new;

向表添加同义词

如需向表添加同义词，请执行以下操作：

GoogleSQL

  ALTER TABLE table_name ADD SYNONYM synonym;

PostgreSQL

  ALTER TABLE [ IF EXISTS ] [ ONLY ] table_name ADD SYNONYM synonym;

以下示例展示了向表添加同义词的 DDL 请求：

GoogleSQL

  ALTER TABLE Singers ADD SYNONYM SingersTest;

PostgreSQL

  ALTER TABLE singers ADD SYNONYM singers_test;

使用同义词创建表

如需创建包含同义词的表，请执行以下操作：

GoogleSQL

使用 CREATE TABLE SYNONYM synonym_name。

  CREATE TABLE table_name (
      ...
      SYNONYM (synonym)
  ) PRIMARY KEY (primary_key);

PostgreSQL

使用 CREATE TABLE SYNONYM synonym_name。

  CREATE TABLE table_name (
      ...
      SYNONYM (synonym),
      PRIMARY KEY (primary_key));

以下示例创建了一个表并添加了一个同义词。

GoogleSQL

  # The table's name is Singers and the synonym is Artists.
  CREATE TABLE Singers (
      SingerId INT64 NOT NULL,
      SingerName STRING(1024),
      SYNONYM (Artists)
  ) PRIMARY KEY (SingerId);

PostgreSQL

  # The table's name is singers and the synonym is artists.
  CREATE TABLE singers (
      singer_id BIGINT,
      singer_name VARCHAR(1024),
      SYNONYM (artists),
      PRIMARY KEY (singer_id));

从表中移除同义词

GoogleSQL

使用 ALTER TABLE DROP SYNONYM 从表中移除同义词。

  ALTER TABLE table_name DROP SYNONYM synonym;

PostgreSQL

使用 ALTER TABLE DROP SYNONYM 从表中移除同义词。

  ALTER TABLE [ IF EXISTS ] [ ONLY ] table_name DROP SYNONYM synonym;

以下示例展示了一个从表中删除同义词的 DDL 请求：

GoogleSQL

  ALTER TABLE Singers DROP SYNONYM SingersTest;

PostgreSQL

  ALTER TABLE singers DROP SYNONYM singers_test;