Tabellennamen verwalten

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

Optionen für die Umbenennung von Tabellen und Synonyme

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

• Tabelle umbenennen und den alten Namen einem Synonym hinzufügen
• Tabellennamen tauschen
• Einzelne Tabelle umbenennen
• Erstellen Sie eine neue Tabelle mit einem einzelnen Synonym.
• Ein einzelnes Synonym zu einer Tabelle hinzufügen, ohne sie umzubenennen

So funktioniert die Umbenennung von Tabellen mit Synonymen

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

Nachdem Sie alle Anwendungen mit dem neuen Namen aktualisiert haben, empfehlen wir, das Synonym zu entfernen. Ein Synonym hat zwar keinen Einfluss auf die Leistung, Sie können den alten Namen aber erst dann an anderer Stelle verwenden, wenn das Synonym entfernt wird.

Synonyme werden im Schema als synonym-Objekt gespeichert. Sie können nur ein Synonym auf einer Tabelle haben.

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

So tauschen Sie Tabellennamen aus

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 Unterbrechung mit einer anderen Tabelle verknüpfen.

Weitere Informationen finden Sie unter Tabellennamen tauschen.

Tabellen umbenennen

Beim Umbenennen einer Tabelle ä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 werden auch die Verweise auf die Tabelle für Folgendes geändert:

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

Spanner aktualisiert Ansichten nicht automatisch so, dass sie den neuen Tabellennamen verwenden.

Warnung: Gehen Sie beim Umbenennen einer Tabelle vorsichtig vor, da es zu einem Ausfall kommen kann, wenn Prozesse vorhanden sind, die auf die Tabelle verweisen. Sie können eine Tabelle beispielsweise umbenennen, wenn der Tabellenname beim Erstellen falsch geschrieben wurde.

Weitere Informationen finden Sie unter Tabellen umbenennen.

Einschränkungen beim 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, empfiehlt es sich, die Ansicht zu löschen und nach dem Umbenennen der Tabelle neu zu 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 Szenario, in dem Sie dies tun können, besteht darin, eine Datenbank sowohl für eine Produktions- als auch für eine Testumgebung zu verwenden.

Weitere Informationen finden Sie unter Einer Tabelle ein Synonym 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 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 Objekt synonym 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, die einen Verweis von einem Prozess enthält, kann zu einem Ausfall führen, es sei denn, der Tabellenname wird einer anderen Tabelle in derselben Anweisung zugewiesen.

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

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. Dies erfordert, dass die erste Tabelle in einen temporären Namen umbenannt wird, die zweite Tabelle in den Namen der ersten Tabelle und dann die erste Tabelle in den Namen der zweiten Tabelle.

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 einen Verweis aus einem Prozess enthält, 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;

Synonym zu einer Tabelle 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, mit der das Synonym aus der Tabelle gelöscht wird:

GoogleSQL

  ALTER TABLE Singers DROP SYNONYM SingersTest;

PostgreSQL

  ALTER TABLE singers DROP SYNONYM singers_test;