Configurare le estensioni del database

Per aggiungere funzionalità extra ai tuoi database AlloyDB per PostgreSQL, come la ricerca vettoriale, l'indicizzazione geospaziale o l'audit delle query, puoi abilitare, aggiornare e disabilitare le estensioni PostgreSQL supportate.

Consulta Estensioni di database supportate per l'elenco delle estensioni supportate da AlloyDB.

Attiva un'estensione

In genere, un'estensione viene attivata connettendosi a un database nell'istanza principale di un cluster AlloyDB e inserendo un comando LOAD o CREATE EXTENSION.

Tuttavia, alcune estensioni richiedono l'impostazione di uno o più flag di database prima di poter utilizzare il comando LOAD o CREATE EXTENSION per abilitare l'estensione. Puoi impostare questi flag nell'istanza AlloyDB in cui vuoi utilizzare l'estensione, indipendentemente dal fatto che si tratti dell'istanza principale o di un'istanza del pool di lettura.

Procedura

  1. Se necessario, imposta i flag di database appropriati nell'istanza in cui vuoi utilizzare l'estensione, ovvero l'istanza principale o un'istanza del pool di lettura.

    L'elenco delle estensioni supportate mostra quali estensioni richiedono questo passaggio e indica i flag di database che devi impostare.

  2. Connetti un client psql all'istanza principale del cluster, come descritto in Connetti un client psql a un'istanza.

  3. Al prompt dei comandi psql, connettiti al database e crea l'estensione: 
    \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
  4. Se vuoi, ripeti il passaggio precedente per connetterti ad altri database e creare l'estensione in ciascuno di essi.

Aggiorna un'estensione

Sebbene gli aggiornamenti di manutenzione di AlloyDB installino automaticamente i file binari dell'estensione più recenti sul software sottostante dell'istanza, non aggiornano automaticamente il catalogo del database dell'estensione. È tua responsabilità aggiornare manualmente le estensioni per assicurarti che utilizzino le ultime versioni supportate.

Per determinare quali estensioni richiedono un aggiornamento, confronta la versione installata con l'ultima versione supportata elencata nella tabella di riferimento delle estensioni supportate.

Connettiti al database ed esegui questo comando per visualizzare le versioni installate:

SELECT * FROM pg_extension;

Per aggiornare un'estensione all'ultima versione disponibile sulla tua istanza, utilizza il comando ALTER EXTENSION.

Connettiti all'istanza principale del cluster utilizzando un client di tua scelta, ad esempio AlloyDB Studio o un client psql, ed esegui questo comando per ogni estensione che vuoi aggiornare:

ALTER EXTENSION EXTENSION_NAME UPDATE;

Se devi eseguire l'aggiornamento a una versione specifica, utilizza la seguente sintassi:

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

Disattiva un'estensione

Per disattivare un'estensione, inverti la procedura utilizzata per attivarla.

  1. Connetti un client psql all'istanza principale del cluster, come descritto in Connetti un client psql a un'istanza.

  2. Al prompt dei comandi psql, connettiti al database in cui è abilitata l'estensione ed eliminala: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Ripeti il passaggio precedente per connetterti a tutti gli altri database in cui l'estensione è abilitata ed eliminala in ciascuno di essi.

  4. Se l'estensione richiedeva l'impostazione di flag di database sulle istanze in cui veniva utilizzata, rimuovi i flag da ciascuna istanza in cui veniva utilizzata seguendo le istruzioni riportate in Configura i flag di database di un'istanza.

    L'elenco delle estensioni supportate mostra quali estensioni richiedono l'impostazione dei flag di database e identifica i flag.