Flag del motore colonnare

Questa pagina descrive i flag del database utilizzati da AlloyDB Omni per attivare e gestire le funzionalità specifiche del motore columnare. Per un elenco di tutti i flag di database supportati da AlloyDB Omni, consulta Flag di database supportati.

I flag contrassegnati con Riavvii dell'istanza indicano che devi riavviare un'istanza AlloyDB Omni ogni volta che imposti, rimuovi o modifichi questo flag sull'istanza. Il valore del flag persiste per l'istanza finché non lo modifichi di nuovo.

Per istruzioni su come impostare un flag di database, vedi Configurare i flag di database AlloyDB Omni.

Attivazione

google_columnar_engine.enabled

Se on, attiva il motore colonnare di AlloyDB Omni.

Colonnarizzazione automatica

google_columnar_engine.enable_auto_columnarization

Se on, abilita le funzionalità di colonnarizzazione automatica del motore colonnare.

google_columnar_engine.relations

Specifica un elenco di colonne che AlloyDB Omni deve aggiungere all'archivio colonne del cluster, a parte il processo di columnarizzazione automatica. Queste colonne possono provenire da qualsiasi tabella all'interno del cluster.

Il valore del flag è formattato come un elenco di elementi separati da virgole. Ogni elemento specifica una o più colonne di una singola tabella, espresse in questo formato:

'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'

Per saperne di più, consulta Gestire manualmente i contenuti del column store.

google_columnar_engine.auto_columnarization_schedule

Specifica la frequenza con cui AlloyDB Omni esegue il processo di auto-columnarization sull'istanza.

Il valore è una stringa nel seguente formato:

'EVERY NUMBER TIME_UNITS'

Sostituisci quanto segue:

• NUMBER: un numero intero positivo.

• TIME_UNITS: DAYS o HOURS.

Se non definito, AlloyDB Omni esegue il processo di auto-columnarizzazione una volta ogni ora.

Dimensionamento ed elaborazione delle query

google_columnar_engine.memory_size_in_mb

La quantità di memoria dell'istanza, espressa in mebibyte (MiB), che AlloyDB Omni alloca allo spazio di archiviazione a colonne.

Se questo flag non è impostato, AlloyDB Omni alloca 1 GB di memoria dell'istanza allo spazio di archiviazione a colonne.

google_columnar_engine.enable_columnar_scan

Se on, consente ad AlloyDB Omni di accedere ai dati nello spazio di archiviazione a colonne durante la gestione delle query.

Se questo flag è off mentre google_columnar_engine.enabled è on, il motore colonnare rimane abilitato e mantiene il relativo column store, ma AlloyDB Omni non utilizza i dati colonnari quando gestisce le query.

google_columnar_engine.omni_storage_cache_directory

Questo flag ti consente di specificare un percorso di directory dedicato separato per i file della cache su disco per il motore colonnare.

google_columnar_engine.storage_cache_size

Se google_columnar_engine.omni_storage_cache_directory non è specificato, devi attivare la cache su disco.

Se on, AlloyDB Omni consente di configurare le dimensioni della cache di archiviazione per il motore colonnare.

Quando google_columnar_engine.omni_storage_cache_directory non è specificato, il valore massimo consentito per questo flag è il 50% della cache del disco totale. Si applica anche il limite di 1000 * google_columnar_engine.memory_size_in_mb.

Attività di manutenzione

google_job_scheduler.maintenance_cpu_percentage

La percentuale massima di capacità della CPU di un'istanza che il motore colonnare può applicare all'elaborazione in background.

google_job_scheduler.max_parallel_workers_per_job

Il numero massimo di worker paralleli che il motore colonnare può creare per gestire qualsiasi singola operazione di elaborazione in background.

Aggiornamento automatico basato su eventi

google_columnar_engine.refresh_threshold_percentage

Specifica la soglia di aggiornamento dei dati dello spazio di archiviazione a colonne, espressa in percentuale.

AlloyDB Omni aggiorna i dati all'interno di un'unità colonnare, un insieme di blocchi di dati all'interno di una tabella colonnare, quando vengono soddisfatte le seguenti condizioni:

• La tabella dell'unità colonnare ha superato la soglia di scansione definita dal flag separato refresh_threshold_scan_count.

• La percentuale di blocchi di dati sottostanti dell'unità colonnare che sono diventati non validi supera il valore del flag refresh_threshold_percentage. I blocchi di dati colonnari diventano non validi a causa delle modifiche ai dati basati sulle righe da cui viene estratta la tabella colonnare.

google_columnar_engine.refresh_threshold_scan_count

AlloyDB Omni tiene un conteggio aggiornato del numero di scansioni eseguite su ogni tabella colonnare a partire dalla query DML più recente della tabella. Il valore del flag refresh_threshold_scan_count specifica il valore minimo di questo contatore in qualsiasi tabella colonnare prima che AlloyDB Omni possa aggiornare i dati. Da qui, AlloyDB Omni utilizza la soglia di blocchi non validi definita da refresh_threshold_percentage per determinare quando aggiornare i dati della tabella.

Se il valore di questo flag è impostato su 0, AlloyDB Omni non tiene conto delle scansioni delle tabelle per determinare quando aggiornare i dati delle colonne, utilizzando solo refresh_threshold_percentage.

Aggiornamento automatico: periodico e adattivo

google_columnar_engine.adaptive_auto_refresh_schedule

Specifica la frequenza con cui AlloyDB Omni esegue il processo di aggiornamento automatico adattivo sull'istanza.

Il valore è una stringa nel seguente formato:

'EVERY NUMBER TIME_UNITS'

Sostituisci quanto segue:

• NUMBER: un numero intero positivo.

• TIME_UNITS: DAYS o HOURS.

Se non è definito, AlloyDB Omni esegue il processo di aggiornamento automatico adattivo una volta ogni ora.

google_columnar_engine. min_adaptive_auto_refresh_blocks

Il numero di blocchi di dati sottostanti dell'unità colonnare che sono diventati non validi supera il valore del flag min_adaptive_auto_refresh_blocks. I blocchi di dati colonnari diventano non validi a causa delle modifiche ai dati basati sulle righe da cui viene estratta la tabella colonnare.

Unione vettorizzata

google_columnar_engine.enable_vectorized_join

Se on, AlloyDB Omni utilizza automaticamente operazioni vettoriali multithread per migliorare le prestazioni delle query che uniscono più tabelle.

Per saperne di più, vedi Attivare i join vettoriali.

google_columnar_engine.vectorized_join_threads

Definisce il numero massimo di thread paralleli disponibili per l'operatore di join vettorializzato, abilitato dal flag enable_vectorized_join.

Puoi definire un valore pari alla metà delle vCPU dell'istanza. Ad esempio, su un'istanza con 16 vCPU, il valore massimo di questo flag è 8.

Funzionalità in anteprima

google_columnar_engine.enable_json_support

Se sia questo flag sia enable_raw_format sono impostati su on, allora AlloyDB Omni consente i tipi di dati JSON e JSONB di PostgreSQL nello spazio di archiviazione a colonne.

google_columnar_engine.enable_raw_format

Se sia questo flag che enable_json_support sono impostati su on, AlloyDB Omni consente i tipi di dati JSON e JSONB di PostgreSQL nello spazio di archiviazione a colonne.