Configurare le estensioni del database

Questa pagina descrive come abilitare e disabilitare le estensioni PostgreSQL in AlloyDB.

Per l'elenco delle estensioni supportate da AlloyDB, vedi Estensioni del database supportate per l' elenco delle estensioni supportate da AlloyDB.

Abilitare un'estensione

In genere, per abilitare un'estensione, devi connetterti a un database nell'istanza principale di un cluster AlloyDB e inserire un comando LOAD o CREATE EXTENSION.

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

Procedura

  1. Se necessario, imposta i flag di database appropriati sull'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 quali flag di database devi impostare.

  2. Connetti un client psql all'istanza principale del cluster, come descritto in Connettere 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 ognuno di essi.

Aggiornare 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 versioni supportate più recenti.

Per determinare quali estensioni richiedono un aggiornamento, confronta la versione installata con la versione supportata più recente elencata nella tabella di riferimento Estensioni supportate.

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

SELECT * FROM pg_extension;

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

Connettiti all'istanza principale del cluster utilizzando un client a tua scelta, come AlloyDB Studio o un client psql, ed esegui il comando seguente 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';

Disabilitare un'estensione

Per disabilitare un'estensione, devi invertire la procedura utilizzata per abilitarla.

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

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

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

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