Le colonne virtuali per le espressioni velocizzano le query del motore colonnare che valutano ripetutamente le stesse espressioni, come i filtri sugli attributi JSON. Questa funzionalità è disponibile per PostgreSQL 16 e versioni successive.
Il motore colonnare può materializzare e memorizzare nella cache i risultati delle espressioni utilizzate di frequente. Pre-calcolando e archiviando questi risultati, AlloyDB evita l'analisi e la valutazione ripetute delle stesse espressioni in più query. Questo processo migliora le prestazioni delle query e riduce il consumo della CPU, in particolare per i workload analitici su set di dati di grandi dimensioni.
Di seguito sono riportati alcuni casi d'uso delle colonne virtuali per le espressioni:
- Filtro degli attributi JSON: quando filtri spesso le query in base a coppie chiave-valore specifiche all'interno di una colonna JSON.
- Valutazione di espressioni complesse: per query che coinvolgono espressioni complesse o ad alta intensità di calcolo.
Quando attivi l'analisi delle colonne virtuali per le espressioni, le query che utilizzano il motore colonnare e contengono espressioni utilizzate di frequente vengono ottimizzate automaticamente. Il motore colonnare aggiorna automaticamente queste colonne virtuali quando aggiorna le colonne di base.
Espressioni supportate nelle colonne virtuali
AlloyDB supporta gli operatori -> e ->> sulle colonne JSON e JSONB nella versione (anteprima).
Prima di iniziare
Abilita il motore colonnare per il cluster AlloyDB. Per saperne di più, consulta Configura il motore colonnare.
Identifica le espressioni utilizzate di frequente nelle query AlloyDB utilizzando Query Insights.
Aggiungi le colonne di base delle espressioni al motore colonnare. Per saperne di più, consulta Gestisci manualmente i contenuti dell'archivio di colonne.
Attiva le colonne virtuali per le espressioni
Il supporto delle colonne virtuali per le espressioni è abilitato per impostazione predefinita (google_columnar_engine.enable_virtual_columns_scan=on). Se questo flag è stato disabilitato in precedenza, puoi abilitarlo per un'istanza utilizzando il comando gcloud alloydb instances update.
Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.
gcloud alloydb instances update INSTANCE_ID \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--database-flags="google_columnar_engine.enable_virtual_columns_scan=on"Sostituisci quanto segue:
INSTANCE_ID: l'ID istanza AlloyDB.REGION_ID: la regione dell'istanza AlloyDB.CLUSTER_ID: l'ID cluster dell'istanza AlloyDB.PROJECT_ID: il tuo ID progetto Google Cloud .
Per impostare questo flag a livello di sessione, esegui questo comando:
SET google_columnar_engine.enable_virtual_columns_scan=on;
Aggiungi colonne virtuali per le espressioni
Per aggiungere espressioni di uso comune al motore colonnare, utilizza il client psql per chiamare la funzione google_columnar_engine_add. Queste espressioni vengono inserite nel motore colonnare come colonne, oltre a quelle già esistenti nel database.
Puoi specificare più espressioni come valori separati da virgole.
SELECT google_columnar_engine_add(
relation => 'DB.SCHEMA.TABLE_NAME',
columns => 'COLUMN_NAME, COLUMN_NAME',
expressions => 'EXP1, EXP2, EXP3'
);
Sostituisci quanto segue:
DB.SCHEMA: lo schema del database in cui è archiviata la tabella.TABLE_NAME: il nome della tabella in cui è archiviata la colonna.COLUMN_NAME: il nome delle colonne che includono le espressioni.EXP1, EXP2, EXP3: un elenco di espressioni separate da virgole. Le espressioni di estrazione JSON supportate sono->e->>.Ad esempio, per aggiungere espressioni
user ->> 'email'euser ->> 'name'per la tabellaemployeenello schemapublic, utilizza la seguente query:SELECT google_columnar_engine_add( relation => 'postgres.public.employee', expressions => '"user ->> ''email''", "user ->> ''name''"' );Sintassi delle espressioni:
- Racchiudi l'intero valore dell'espressione tra virgolette singole, ad esempio
expressions => 'EXP1,EXP2,EXP3'. - Separa più espressioni con le virgole.
- Racchiudi ogni singola espressione tra virgolette doppie.
- Esegui l'escape di ogni virgoletta singola in un'espressione utilizzando un'altra virgoletta singola.
Ad esempio, per aggiungere l'espressione
col -> 'level1'ecol -> 'level1' ->> 'level2', utilizza il seguente formato:expressions => '"col -> ''level1''", "col -> ''level1'' ->> ''level2''"'- Racchiudi l'intero valore dell'espressione tra virgolette singole, ad esempio
Esempio di colonne virtuali per le espressioni
Questo esempio mostra come utilizzare la funzionalità delle colonne virtuali per le espressioni. Crea una tabella users con una colonna JSONB profile e compilala con dati di esempio. Poi, in base all'analisi delle query, aggiungi l'espressione profile ->> 'email' utilizzata di frequente al motore colonnare con la funzione google_columnar_engine_add. Il motore colonnare utilizza quindi questa espressione frequente per ottimizzare le query successive.
Per aggiungere questo esempio di espressione frequente al motore colonnare, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Cluster.
Fai clic sul nome del cluster nella colonna Nome risorsa.
Nel riquadro di navigazione, fai clic su AlloyDB Studio.
Per creare la tabella
userscon una colonna JSONBprofile, esegui questo comando:CREATE TABLE users ( id int, username TEXT, profile JSONB );Per compilare la tabella
userscon dati campionati, esegui questo comando:INSERT INTO users (id, username, profile) SELECT i, 'user' || i, jsonb_build_object( 'name', 'User ' || i, 'email', 'user' || i || '@example.com', 'active', (i % 2 = 0) ) FROM generate_series(1, 100000) AS i;Per migliorare le prestazioni della query che include l'espressione utilizzata di frequente, aggiungi l'espressione
profile ->> 'email'al motore colonnare:SELECT google_columnar_engine_add( relation => 'users', columns => 'username, profile', expressions => '"profile ->> ''email''"' );Disattiva la funzionalità delle colonne virtuali per le espressioni per stabilire una base di riferimento per le prestazioni, quindi esegui una query che utilizza l'espressione frequente e osserva il tempo necessario per il completamento della query.
SET google_columnar_engine.enable_virtual_columns_scan=off; SELECT username FROM users WHERE profile->>'email' = 'user50000@example.com';Attiva la funzionalità delle colonne virtuali per le espressioni.
SET google_columnar_engine.enable_virtual_columns_scan=on;Esegui nuovamente la query che utilizza l'espressione frequente e osserva il tempo necessario per il completamento della query.
SELECT username FROM users WHERE profile->>'email' = 'user50000@example.com';
Il runtime delle query è più veloce dopo l'attivazione delle colonne virtuali per le espressioni.
Visualizza le colonne virtuali per le espressioni
Per trovare tutte le espressioni aggiunte per una tabella specifica, esegui una query sulla vista g_columnar_virtual_columns:
SELECT * FROM g_columnar_virtual_columns;
L'output è simile al seguente, dove il campo description mostra tutte le espressioni aggiunte per una tabella (relazione):
category | expression
database_name | testdb
schemas | {public}
relations | {users}
description | profile->>'email'
column_data_type | text
status | Usable
last_accessed_time | 2026-02-04 06:25:32.499601+00
num_times_accessed | 1
Rimuovi le colonne virtuali per le espressioni
Per rimuovere un'espressione, chiama la funzione google_columnar_engine_drop():
SELECT google_columnar_engine_drop(
relation => 'DB.SCHEMA.TABLE_NAME',
expressions => 'EXP1, EXP2, EXP3'
);
Sostituisci EXP1, EXP2, EXP3 con un elenco separato da virgole di espressioni nella tabella nello stesso formato utilizzato per l'aggiunta di espressioni.