Questa pagina descrive i flag di database utilizzati da AlloyDB Omni per attivare e gestire le funzionalità specifiche del suo motore colonnare. Per un elenco di tutti i flag di database supportati da AlloyDB Omni, consulta Flag di database supportati.
I flag contrassegnati con Riavvio dell'istanza indicano che devi riavviare un'istanza AlloyDB Omni ogni volta che imposti, rimuovi o modifichi questo flag nell'istanza. Il valore del flag persiste per l'istanza finché non lo modifichi di nuovo.
Per istruzioni su come impostare un flag di database, consulta Configura i flag di database AlloyDB Omni.
Abilitazione
google_columnar_engine.enabled
| Tipo | Boolean |
| Predefinito | off |
| Riavvii dell'istanza | Sì |
Se on, attiva il motore colonnare di AlloyDB Omni.
Auto-colonnarizzazione
google_columnar_engine.enable_auto_columnarization
| Tipo | Boolean |
| Predefinito | on |
| Riavvia l'istanza | No |
Se on, abilita le funzionalità di auto-colonnarizzazione del motore colonnare.
google_columnar_engine.relations
| Tipo | String |
| Predefinito | Una stringa vuota |
| Riavvii dell'istanza | No |
Specifica un elenco di colonne che AlloyDB Omni deve aggiungere all'archivio di colonne del cluster, oltre al processo di auto-colonnarizzazione. Queste colonne possono provenire da qualsiasi tabella all'interno del cluster.
Il valore del flag è formattato come 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 Gestisci manualmente i contenuti dell'archivio di colonne.
google_columnar_engine.auto_columnarization_schedule
| Tipo | String |
| Predefinito | Una stringa vuota |
| Riavvii dell'istanza | No |
| Valore massimo consentito | 2147483647 |
Specifica la frequenza con cui AlloyDB Omni esegue il processo di auto-colonnarizzazione sull'istanza.
Il valore è una stringa nel seguente formato:
'EVERY NUMBER TIME_UNITS'
Sostituisci quanto segue:
NUMBER: un numero intero positivo.
TIME_UNITS:
DAYSoHOURS.
Se non viene definito, AlloyDB Omni esegue il processo di auto-colonnarizzazione una volta all'ora.
Dimensionamento ed elaborazione delle query
google_columnar_engine.memory_size_in_mb
| Tipo | Integer |
| Valori validi | Tra 128 e il valore che rappresenta il 70% della memoria dell'istanza |
| Predefinito | 1 GB di memoria dell'istanza |
| Riavvii dell'istanza | Sì |
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 della memoria dell'istanza allo spazio di archiviazione a colonne.
google_columnar_engine.enable_columnar_scan
| Tipo | Boolean |
| Predefinito | on |
| Riavvia l'istanza | No |
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 proprio archivio di colonne, ma
AlloyDB Omni non utilizza i dati colonnari quando gestisce le query.
google_columnar_engine.omni_storage_cache_directory
Questo flag consente di specificare un percorso di directory dedicato separato per i file della cache del disco per il motore colonnare.
| Tipo | String |
| Valori validi | Un singolo percorso di directory in cui sono archiviati i file della cache del disco. |
| Predefinito | Le dimensioni totali della Persistent Volume Claim (PVC) dedicata vengono allocate per la cache del disco di overflow colonnare. |
| Riavvii dell'istanza | Sì |
google_columnar_engine.storage_cache_size
Se google_columnar_engine.omni_storage_cache_directory non è specificato, per attivare la dimensione della cache di archiviazione, devi attivare la cache del disco.
| Tipo | Integer |
| Valori validi | 1024 … 2147483647 |
| Predefinito | Il 5% della cache del disco viene allocato al motore colonnare quando google_columnar_engine.omni_storage_cache_directory non è specificato. |
| Riavvia l'istanza | Sì |
Se on, consente ad AlloyDB Omni di configurare le dimensioni della cache di archiviazione per il motore colonnare.
Se google_columnar_engine.omni_storage_cache_directory non è specificato, il valore massimo consentito per questo flag è il 50% della cache del disco totale. È applicabile anche il limite di 1000 * google_columnar_engine.memory_size_in_mb.
Attività di manutenzione
google_job_scheduler.maintenance_cpu_percentage
| Tipo | Integer |
| Valori validi | 0 … 100 |
| Predefinito | 20 |
| Riavvia l'istanza | No |
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
| Tipo | Integer |
| Valori validi | 0 … 262143 |
| Predefinito | 2 |
| Riavvia l'istanza | No |
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
| Tipo | Integer |
| Valori validi | 1 … 100 |
| Predefinito | 50 |
| Riavvia l'istanza | No |
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
refresh_threshold_scan_countseparato.La percentuale di data block 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 di modifiche ai dati basati su righe da cui attinge la tabella colonnare.
google_columnar_engine.refresh_threshold_scan_count
| Tipo | Integer |
| Valori validi | 0 … 2147483647 |
| Predefinito | 5 |
| Riavvia l'istanza | No |
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 lì, 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 ignora le scansioni delle tabelle per determinare quando aggiornare i dati colonnari, utilizzando solo refresh_threshold_percentage.
Aggiornamento automatico: periodico e adattivo
google_columnar_engine.adaptive_auto_refresh_schedule
| Tipo | String |
| Predefinito | Una stringa vuota |
| Riavvii dell'istanza | No |
| Valore massimo consentito | 2147483647 |
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:
DAYSoHOURS.
Se non definito, AlloyDB Omni esegue il processo di aggiornamento automatico adattivo una volta ogni ora.
google_columnar_engine.min_adaptive_auto_refresh_blocks
| Tipo | Integer |
| Valori validi | 0 … 2147483647 |
| Predefinito | 50 |
| Riavvia l'istanza | No |
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.
Join vettorizzato
google_columnar_engine.enable_vectorized_join
| Tipo | Boolean |
| Predefinito | off |
| Riavvia l'istanza | No |
Se on, AlloyDB Omni utilizza automaticamente operazioni vettorizzate multithread per migliorare le prestazioni delle query che uniscono più tabelle.
Per saperne di più, consulta Abilita i join vettorizzati.
google_columnar_engine.vectorized_join_threads
| Tipo | Integer |
| Valori validi | Fino a metà del numero di vCPU dell'istanza |
| Predefinito | 1 |
| Riavvia l'istanza | No |
Definisce il numero massimo di thread paralleli disponibili per l'operatore di join vettorizzato, 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
| Tipo | Boolean |
| Predefinito | off |
| Riavvia l'istanza | No |
Se sia questo flag sia enable_raw_format sono impostati su on, AlloyDB Omni consente i tipi di dati JSON e JSONB di PostgreSQL nello spazio di archiviazione a colonne.
google_columnar_engine.enable_raw_format
| Tipo | Boolean |
| Predefinito | off |
| Riavvia l'istanza | No |
Se sia questo flag sia 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.