Configurare il motore colonnare in AlloyDB Omni

Seleziona una versione della documentazione:

Questa pagina descrive come attivare o disattivare il motore colonnare su un cluster di database AlloyDB Omni. Viene inoltre illustrato come configurare una dimensione iniziale appropriata per l'archivio colonne.

Per una panoramica concettuale del motore colonnare AlloyDB, consulta Panoramica del motore colonnare AlloyDB Omni.

Attivare il motore colonnare

Per utilizzare il motore colonnare su un'istanza, imposta il flag dell'istanza google_columnar_engine.enabled su on.

Server singolo

Per impostare google_columnar_engine.enabled su on:

  1. Esegui il ALTER SYSTEM comando PostgreSQL:

    ALTER SYSTEM SET google_columnar_engine.enabled = 'on'

  2. Se vuoi modificare la configurazione del motore colonnare, segui le istruzioni nella sezione successiva prima di riavviare il server di database. In caso contrario, completa il passaggio seguente per riavviare subito il server di database.

  3. Affinché la modifica dei parametri di configurazione diventi effettiva, riavvia il server di database:

     sudo systemctl restart alloydbomni18

Configurare le dimensioni dell'archivio colonne

Quando il motore colonnare è abilitato su un'istanza, AlloyDB Omni alloca una parte della memoria dell'istanza per archiviare i dati colonnari. L'assegnazione di RAM ad alta velocità all'archivio colonne garantisce che AlloyDB Omni possa accedere ai dati colonnari il più rapidamente possibile.

La memoria e la cache di archiviazione rappresentano insieme la capacità complessiva del motore colonnare.

Configurare la memoria

Puoi impostare l'allocazione su una dimensione fissa utilizzando il google_columnar_engine.memory_size_in_mb flag.

Server singolo

Per impostare il flag google_columnar_engine.memory_size_in_mb su un'istanza:

  1. Configura la memoria eseguendo il comando PostgreSQL ALTER SYSTEM:

    ALTER SYSTEM SET google_columnar_engine.memory_size_in_mb = COLUMN_MEMORY_SIZE;

    Sostituisci COLUMN_MEMORY_SIZE con la nuova dimensione dell'archivio colonne, in megabyte, ad esempio 256.

  2. Affinché la modifica dei parametri di configurazione diventi effettiva, riavvia il server di database:

    sudo systemctl restart alloydbomni18

Configurare la cache di archiviazione

Server singolo

Dispositivi condivisi o dedicati

Puoi configurare la cache di archiviazione del motore colonnare su dispositivi dedicati o condivisi.

Eseguire il provisioning e montare la directory della cache

Sui dispositivi dedicati, devi eseguire il provisioning dei dischi, creare un file system, montare la directory della cache su un percorso host (ad esempio, /var/lib/postgresql/18/data/columnar_cache) e assicurarti che disponga delle autorizzazioni di scrittura per l'utente postgres.

Attivare la cache di archiviazione colonnare

  1. Esegui ALTER SYSTEM per configurare il percorso e le dimensioni della directory della cache:

    ALTER SYSTEM SET google_columnar_engine.omni_storage_cache_directory = 'CACHE_DIR_PATH';
ALTER SYSTEM SET google_columnar_engine.storage_cache_size = STORAGE_CACHE_SIZE;

    Sostituisci quanto segue:

    • CACHE_DIR_PATH: il percorso della directory della cache (ad esempio /var/lib/postgresql/18/data/columnar_cache).
    • STORAGE_CACHE_SIZE: le dimensioni della cache di archiviazione del motore colonnare, in megabyte.

  2. Riavvia il server di database:

    sudo systemctl restart alloydbomni18

Attivare il join vettorializzato

Il motore colonnare ha una funzionalità di join vettorializzato che può migliorare le prestazioni dei join applicando l'elaborazione vettorializzata alle query idonee.

Dopo aver attivato il join vettorializzato, il pianificatore di query AlloyDB ha la possibilità di applicare l'operatore di join vettorializzato anziché l'operatore di hash join PostgreSQL standard. Il pianificatore prende questa decisione confrontando il costo di esecuzione della query utilizzando ciascun metodo.

Per attivare il join vettorializzato su un'istanza, imposta il flag dell'istanza google_columnar_engine.enable_vectorized_join su on.

Per impostare questo flag su un'istanza, esegui il ALTER SYSTEM comando PostgreSQL:

ALTER SYSTEM SET google_columnar_engine.enable_vectorized_join = 'on';

Per impostazione predefinita, AlloyDB Omni alloca un thread alla funzionalità di join vettorializzato. Puoi aumentare il numero di thread disponibili per questa funzionalità impostando il google_columnar_engine.vectorized_join_threads flag su un valore maggiore. Il valore massimo è cpu_count * 2.

Aggiornare manualmente il motore colonnare

Per impostazione predefinita, quando il motore colonnare è attivato, aggiorna l'archivio colonne in background.

Per aggiornare manualmente il motore colonnare, esegui la seguente query SQL:

SELECT google_columnar_engine_refresh(relation =>'TABLE_NAME');

Sostituisci TABLE_NAME con il nome della tabella o della vista materializzata che vuoi aggiornare manualmente.

Disattivare il motore colonnare

Per disattivare il motore colonnare su un'istanza, imposta il flag google_columnar_engine.enabled su off.

Server singolo

Per impostare google_columnar_engine.enabled su off:

  1. Esegui il ALTER SYSTEM comando PostgreSQL:
ALTER SYSTEM SET google_columnar_engine.enabled = 'off'

  1. Affinché la modifica dei parametri di configurazione diventi effettiva, riavvia il server di database:

    sudo systemctl restart alloydbomni18

Passaggi successivi