Configura il motore colonnare Spanner

Questa pagina descrive come abilitare il motore colonnare di Spanner su un database, una tabella o un indice e accelerare la generazione del formato di file.

Abilitare il motore colonnare di Spanner

Il motore colonnare di Spanner viene abilitato utilizzando una clausola SET OPTIONS con l'opzione columnar_policy. Puoi applicare questa opzione quando crei o modifichi gli oggetti dello schema DATABASE, TABLE o INDEX. Gli oggetti dello schema SEARCH INDEX e VECTOR INDEX non sono mai in formato colonnare.

I livelli inferiori in una gerarchia di database e tabelle ereditano columnar_policy dal relativo elemento principale. Puoi modificare questa impostazione a livelli inferiori.

L'opzione columnar_policy ha i seguenti flag:

  • 'enabled' o 'disabled' attiva o disattiva il motore colonnare per l' oggetto dello schema specifico.
  • NULL (impostazione predefinita) utilizza il criterio del motore colonnare dell'oggetto principale, se esiste. NULL cancella le impostazioni precedenti su un oggetto tabella.

Puoi anche omettere OPTIONS per ereditare columnar_policy dall'oggetto principale.

Il seguente esempio mostra come:

  • Creare un database con il criterio colonnare abilitato.
  • Definire una tabella Singers che eredita il criterio colonnare dal database (ometti columnar_policy = NULL per l'opzione tabella).
  • Definire una tabella Concerts con il criterio colonnare disabilitato in modo esplicito.
CREATE DATABASE Music;

ALTER DATABASE Music SET OPTIONS (columnar_policy = 'enabled');

CREATE TABLE Singers(
  SingerId INT64 NOT NULL,
  FirstName STRING(1024),
  LastName STRING(1024),
  BirthDate DATE,
  Status STRING(1024),
  LastUpdated TIMESTAMP,)
  PRIMARY KEY(SingerId);

CREATE TABLE Concerts(
  VenueId INT64 NOT NULL,
  SingerId INT64 NOT NULL,
  ConcertDate DATE NOT NULL,
  BeginTime TIMESTAMP,
  EndTime TIMESTAMP,)
  PRIMARY KEY(VenueId, SingerId, ConcertDate),
  OPTIONS (columnar_policy = 'disabled');

Puoi anche utilizzare ALTER TABLE con la clausola SET OPTIONS per abilitare o disabilitare columnar_policy su una tabella. Il seguente esempio mostra come disabilitare il criterio nella tabella Singers:

ALTER TABLE Singers SET OPTIONS (columnar_policy = 'disabled');

Generazione del formato di file colonnare

Spanner genera il formato di file colonnare al momento della compattazione. La compattazione è un processo in background che in genere viene distribuito su più giorni, ma potrebbe avvenire prima se le dimensioni del database aumentano in modo sostanziale. Per ulteriori informazioni, consulta Copertura colonnare ottimale.

Se crei un nuovo database senza dati e abiliti il motore colonnare, Spanner archivia i dati in formato colonnare man mano che li inserisci e quando si verificano compattazioni in background.

Il formato dei dati colonnari non viene generato per i backup.

Quando abiliti il motore colonnare di Spanner su un database esistente che contiene dati, Spanner fornisce un meccanismo per attivare manualmente le compattazioni. Per ulteriori informazioni, consulta Attivare manualmente una compattazione dei dati.

Passaggi successivi