Configurare le estensioni del database

Questa pagina descrive come attivare e disattivare le estensioni PostgreSQL in AlloyDB.

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

Prima di iniziare

  • Il progetto Google Cloud che utilizzi deve essere stato abilitato per accedere ad AlloyDB.
  • Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che utilizzi:
    • roles/alloydb.admin (il ruolo IAM predefinito AlloyDB Admin)
    • roles/owner (il ruolo IAM di base Proprietario)
    • roles/editor (il ruolo IAM di base Editor)

    Se non disponi di nessuno di questi ruoli, contatta l'Amministratore organizzazione per richiedere l'accesso.

Attivare un'estensione

In genere, per attivare 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 del database prima di poter utilizzare il comando LOAD o CREATE EXTENSION per attivare l'estensione. Imposti questi flag sull'istanza AlloyDB in cui vuoi utilizzare l'estensione, che si tratti dell'istanza principale o dell'istanza del pool di lettura.

Procedura

  1. Se necessario, imposta i flag del 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 quali flag del database 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: 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. Se vuoi, ripeti il passaggio precedente per connetterti ad altri database e creare l'estensione in ciascuno di essi.

Disattivare un'estensione

Per disattivare un'estensione, esegui la procedura inversa a quella 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 è attivata l'estensione e rimuovila: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Ripeti il passaggio precedente per connetterti ad altri database in cui è attivata l'estensione e inserisci l'estensione in ciascuno di essi.

  4. Se l'estensione richiedeva l'impostazione di flag di database sulle istanze in cui è stata utilizzata, rimuovi i flag da ciascuna istanza in cui è stata 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.