管理表名称

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

用于表重命名和同义词的选项

您可以使用 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;