Tabellennamen verwalten

Auf dieser Seite wird beschrieben, wie Sie Tabellen umbenennen und Synonyme für Tabellen hinzufügen, verwenden und löschen.

Optionen zum Umbenennen von Tabellen und Synonymen

Mit der Anweisung ALTER TABLE können Sie Folgendes tun:

• Benennen Sie die Tabelle um und fügen Sie den alten Namen einem Synonym hinzu.
• Tabellennamen tauschen:
• Einzelne Tabelle umbenennen
• Erstellen Sie eine neue Tabelle mit einem einzelnen Synonym.
• Fügen Sie einer Tabelle ein einzelnes Synonym hinzu, ohne sie umzubenennen.

So funktioniert das Umbenennen von Tabellen mit Synonymen

Ein gängiges Szenario besteht darin, eine Tabelle umzubenennen und ein Synonym hinzuzufügen, das den alten Tabellennamen enthält. Nachdem Sie die Tabelle umbenannt haben, können Sie Anwendungen so aktualisieren, dass sie in Ihrem Zeitplan den neuen Namen verwenden. In dieser Zeit kann es vorkommen, dass einige Anwendungen den alten Namen und andere den neuen Namen verwenden.

Nachdem Sie alle Anwendungen auf den neuen Namen umgestellt haben, empfehlen wir, das Synonym zu entfernen. Ein Synonym wirkt sich zwar nicht auf die Leistung aus, Sie können den alten Namen aber erst wieder verwenden, wenn das Synonym entfernt wurde.

Synonyme werden im Schema als synonym-Objekt gespeichert. Pro Tabelle kann nur ein Synonym verwendet werden.

Weitere Informationen finden Sie unter Tabelle umbenennen und ein Synonym hinzufügen.

So funktioniert der Austausch von Tabellennamen

Wenn Sie Namen zwischen zwei Tabellen austauschen müssen, können Sie RENAME TO-Anweisungen verketten, um zwei Tabellen in derselben Anweisung umzubenennen. Auf diese Weise können Sie Anwendungen ohne Unterbrechungen mit einer anderen Tabelle verknüpfen.

Weitere Informationen finden Sie unter Tabellennamen tauschen.

Funktionsweise der Tabellenumbenennung

Wenn Sie eine Tabelle umbenennen, ändert Spanner den Tabellennamen im Schema der Tabelle. Beim Umbenennen einer Tabelle werden alle untergeordneten Tabellen mit dem neuen Tabellennamen verschränkt. Durch das Umbenennen von Tabellen ändern sich auch die Verweise auf die Tabelle in folgenden Fällen:

• Indexe
• Fremdschlüssel
• Streams ändern
• Detaillierte Zugriffssteuerung (Detaillierte Zugriffssteuerung, FGAC)

Spanner aktualisiert Ansichten nicht automatisch, um den neuen Tabellennamen zu verwenden.

Warnung: Gehen Sie beim Umbenennen einer Tabelle vorsichtig vor, da es zu einem Ausfall führen kann, wenn Prozesse vorhanden sind, die auf die Tabelle verweisen. Ein Szenario, in dem Sie eine Tabelle umbenennen können, ist, wenn der Tabellenname beim Erstellen falsch geschrieben wurde.

Weitere Informationen finden Sie unter Tabelle umbenennen.

Einschränkungen für das Umbenennen von Tabellen

Für das Umbenennen von Tabellen gelten folgende Einschränkungen:

• Sie können eine Tabelle nicht in den Namen einer Spalte in dieser Tabelle umbenennen, wenn die Tabelle mit einer anderen Tabelle verschränkt ist.
• Wenn die Tabelle eine Ansicht hat, müssen Sie sie löschen und nach dem Umbenennen der Tabelle neu erstellen.

Funktionsweise von Synonymen

Sie können eine neue Tabelle mit einem Synonym erstellen oder eine Tabelle so ändern, dass ein Synonym hinzugefügt wird, ohne die Tabelle umbenennen zu müssen. Ein Anwendungsszenario ist, wenn Sie eine Datenbank sowohl für eine Produktions- als auch für eine Testumgebung verwenden möchten.

Weitere Informationen finden Sie unter Synonym zu einer Tabelle hinzufügen.

Berechtigungen

Sie benötigen die Berechtigung spanner.databases.updateDdl, um eine Tabelle umzubenennen oder ihr ein Synonym hinzuzufügen. Informationen zum Überprüfen oder Bearbeiten Ihrer Berechtigungen finden Sie unter Berechtigungen für Prinzipien erteilen.

Tabelle umbenennen und ein Synonym hinzufügen

GoogleSQL

Verwenden Sie ALTER TABLE RENAME TO ADD SYNONYM, um eine Tabelle umzubenennen und ein Synonym hinzuzufügen.

  ALTER TABLE table_name RENAME TO new_table_name, ADD SYNONYM table_name;

PostgreSQL

Verwenden Sie ALTER TABLE RENAME WITH ADD SYNONYM, um eine Tabelle umzubenennen und ein Synonym hinzuzufügen.

  ALTER TABLE table_name RENAME WITH SYNONYM TO new_table_name;

Das folgende Beispiel zeigt, wie Sie eine Tabelle umbenennen und ein Synonym hinzufügen. Wenn Sie beispielsweise eine Tabelle mit der folgenden DDL erstellen:

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));

Mit der folgenden DDL-Anfrage können Sie die Tabelle umbenennen und den vorhandenen Namen in das synonym-Objekt verschieben.

GoogleSQL

  ALTER TABLE Singers RENAME TO SingersNew, ADD SYNONYM Singers;

PostgreSQL

  ALTER TABLE singers RENAME WITH SYNONYM TO singers_new;

Tabellennamen tauschen

Warnung: Das Umbenennen einer Tabelle mit einem Verweis aus einem Prozess kann zu einem Ausfall führen, sofern der Tabellenname nicht einer anderen Tabelle in derselben Anweisung zugewiesen ist.

Mit der folgenden DDL-Anweisung werden die Namen mehrerer Tabellen in kleinstmöglichen Schritten geändert. Dies ist hilfreich, wenn die Namen zwischen einem oder mehreren Tabellenpaaren ausgetauscht werden sollen.

GoogleSQL

Verwenden Sie RENAME TABLE.

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

PostgreSQL

Verwenden Sie 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 ...];

Das folgende Beispiel zeigt, wie die Namen von zwei Tabellen vertauscht werden. Dafür muss die erste Tabelle in einen temporären Namen umbenannt werden. Die zweite Tabelle muss in den Namen der ersten Tabelle und dann die erste Tabelle in den Namen der zweiten Tabelle umbenannt werden.

Wenn Sie so zwei Tabellen erstellt haben:

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)
        );

Mit der folgenden DDL-Anfrage können Sie die Tabellennamen austauschen:

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;

Nach dem Anwenden der DDL-Anweisung werden die Tabellennamen vertauscht:

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)
        );

Tabelle umbenennen

Warnung: Das Umbenennen einer Tabelle, die auf einen Prozess verweist, kann zu einem Ausfall führen.

Verwenden Sie die folgende Syntax, um eine Tabelle umzubenennen:

GoogleSQL

Verwenden Sie entweder die Anweisung ALTER NAME oder RENAME TABLE.

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

PostgreSQL

Verwenden Sie die Anweisung ALTER TABLE RENAME TO.

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

Das folgende Beispiel zeigt eine DDL-Anfrage, die die Tabelle umbenennt:

GoogleSQL

  RENAME TABLE Singers TO SingersNew;

PostgreSQL

  ALTER TABLE singers RENAME TO singers_new;

Einer Tabelle ein Synonym hinzufügen

So fügen Sie einer Tabelle ein Synonym hinzu:

GoogleSQL

  ALTER TABLE table_name ADD SYNONYM synonym;

PostgreSQL

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

Das folgende Beispiel zeigt eine DDL-Anfrage, mit der der Tabelle ein Synonym hinzugefügt wird:

GoogleSQL

  ALTER TABLE Singers ADD SYNONYM SingersTest;

PostgreSQL

  ALTER TABLE singers ADD SYNONYM singers_test;

Tabelle mit einem Synonym erstellen

So erstellen Sie eine Tabelle mit einem Synonym:

GoogleSQL

Verwenden Sie CREATE TABLE SYNONYM synonym_name.

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

PostgreSQL

Verwenden Sie CREATE TABLE SYNONYM synonym_name.

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

Im folgenden Beispiel wird eine Tabelle erstellt und ein Synonym hinzugefügt.

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));

Synonym aus einer Tabelle entfernen

GoogleSQL

Verwenden Sie ALTER TABLE DROP SYNONYM, um das Synonym aus der Tabelle zu entfernen.

  ALTER TABLE table_name DROP SYNONYM synonym;

PostgreSQL

Verwenden Sie ALTER TABLE DROP SYNONYM, um das Synonym aus der Tabelle zu entfernen.

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

Das folgende Beispiel zeigt eine DDL-Anfrage, bei der das Synonym aus der Tabelle gelöscht wird:

GoogleSQL

  ALTER TABLE Singers DROP SYNONYM SingersTest;

PostgreSQL

  ALTER TABLE singers DROP SYNONYM singers_test;