Gestisci nomi tabelle

Questa pagina descrive come rinominare le tabelle e come aggiungere, utilizzare e rilasciare i sinonimi delle tabelle.

Opzioni per la ridenominazione delle tabelle e i sinonimi

Puoi utilizzare l'istruzione ALTER TABLE per:

• Rinomina una tabella e aggiungi il vecchio nome a un sinonimo.
• Scambia i nomi delle tabelle.
• Rinomina una singola tabella.
• Crea una nuova tabella con un singolo sinonimo.
• Aggiungere un singolo sinonimo a una tabella senza rinominarla.

Come funziona la ridenominazione delle tabelle con sinonimi

Uno scenario comune è rinominare una tabella e aggiungere un sinonimo contenente il nome della tabella precedente. Dopo aver rinominato la tabella, puoi aggiornare le applicazioni in modo che utilizzino il nuovo nome in base alla pianificazione. Durante questo periodo, è possibile che alcune applicazioni utilizzino il nome precedente e altre utilizzano il nuovo.

Dopo aver aggiornato tutte le applicazioni in modo che utilizzino il nuovo nome, ti consigliamo di rimuovere il sinonimo. Anche se avere un sinonimo non influisce sul rendimento, non puoi utilizzare altrove il sinonimo.

I sinonimi vengono archiviati nello schema come oggetto synonym. Può esserci un solo sinonimo su una tabella.

Per maggiori informazioni, consulta Rinominare una tabella e aggiungere un sinonimo.

Come funziona lo scambio dei nomi delle tabelle

Quando devi scambiare i nomi tra due tabelle, puoi concatenare le istruzioni RENAME TO per rinominare due tabelle nella stessa istruzione. Questo consente di collegare le applicazioni a una tabella diversa senza interruzioni.

Per ulteriori informazioni, vedi Scambiare nomi delle tabelle.

Come funziona la ridenominazione delle tabelle

Quando rinomini una tabella, Spanner ne modifica il nome nello schema. Se rinomini una tabella, tutte le tabelle figlio vengono interfogliate con il nuovo nome. La ridenominazione della tabella modifica anche i riferimenti alla tabella per:

• Indici
• Chiavi esterne
• Flussi di modifiche
• Controllo dell'accesso granulare (FGAC)

Spanner non aggiorna automaticamente le viste in modo da utilizzare il nuovo nome della tabella.

Per ulteriori informazioni, vedi Rinominare una tabella.

Limitazioni per la ridenominazione delle tabelle

La ridenominazione delle tabelle presenta le seguenti limitazioni:

• Non puoi rinominare una tabella con il nome di una colonna al suo interno se la tabella ha interleaving in un'altra.
• Se la tabella ha una visualizzazione, può essere opportuno eliminarla e ricrearla dopo aver rinominato la tabella.

Come funzionano i sinonimi

Puoi creare una nuova tabella con un sinonimo o modificare una tabella per aggiungervi un sinonimo senza rinominare la tabella. Uno scenario ideale per farlo è se vuoi utilizzare un database sia per un ambiente di produzione che di test.

Per ulteriori informazioni, consulta la sezione Aggiungere un sinonimo a una tabella.

Autorizzazioni

Per rinominare una tabella o aggiungere un sinonimo a una tabella, devi disporre dell'autorizzazione spanner.databases.updateDdl. Per controllare o modificare le tue autorizzazioni, vedi Concedere le autorizzazioni ai principi.

Rinominare una tabella e aggiungere un sinonimo

  ALTER TABLE table_name RENAME TO new_table_name, ADD SYNONYM table_name;

  ALTER TABLE table_name RENAME WITH SYNONYM TO new_table_name;

L'esempio seguente mostra come rinominare una tabella e aggiungere un sinonimo. Ad esempio, se crei una tabella con il seguente DDL:

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

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

Puoi effettuare la seguente richiesta DDL per rinominare la tabella e spostare il nome esistente nell'oggetto synonym.

  ALTER TABLE Singers RENAME TO SingersNew, ADD SYNONYM Singers;

  ALTER TABLE singers RENAME WITH SYNONYM TO singers_new;

Inverti nomi tabella

La seguente istruzione DDL modifica a livello atomico i nomi di più tabelle. Questo è utile quando si scambia i nomi tra una o più coppie di tabelle.

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

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

L'esempio seguente mostra come scambiare i nomi di due tabelle. Ciò richiede che la prima tabella venga rinominata con un nome temporaneo, che la seconda venga rinominata con il nome della prima e che poi la prima tabella venga rinominata con il nome della seconda.

Se hai creato due tabelle come segue:

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

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

Per scambiare i nomi delle tabelle, puoi utilizzare la seguente richiesta DDL:

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

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

Dopo l'applicazione dell'istruzione DDL, i nomi delle tabelle vengono scambiati:

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

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

Rinominare una tabella

Per rinominare una tabella, utilizza la seguente sintassi:

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

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

Nell'esempio seguente viene mostrata una richiesta DDL che rinomina la tabella:

  RENAME TABLE Singers TO SingersNew;

  ALTER TABLE singers RENAME TO singers_new;

Aggiungere un sinonimo a una tabella

Per aggiungere un sinonimo a una tabella:

  ALTER TABLE table_name ADD SYNONYM synonym;

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

Nell'esempio seguente viene mostrata una richiesta DDL in cui viene aggiunto un sinonimo alla tabella:

  ALTER TABLE Singers ADD SYNONYM SingersTest;

  ALTER TABLE singers ADD SYNONYM singers_test;

Creare una tabella con un sinonimo

Per creare una tabella con un sinonimo:

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

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

Nell'esempio seguente viene creata una tabella e viene aggiunto un sinonimo.

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

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

Rimuovere un sinonimo da una tabella

  ALTER TABLE table_name DROP SYNONYM synonym;

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

Nell'esempio seguente viene mostrata una richiesta DDL che elimina il sinonimo dalla tabella:

  ALTER TABLE Singers DROP SYNONYM SingersTest;

  ALTER TABLE singers DROP SYNONYM singers_test;