Configurare le estensioni del database

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

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

Prima di iniziare

• Il Google Cloud progetto che utilizzi deve essere stato abilitato per accedere ad AlloyDB.
• Devi disporre di uno di questi ruoli IAM nel progetto che stai utilizzando:
  Google Cloud
  • 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 generale, 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 attivare l'estensione. Imposta questi flag sull'istanza AlloyDB in cui vuoi utilizzare l'estensione, indipendentemente dal fatto che l'istanza sia l'istanza principale o l'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 del database devi impostare.

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

   Nota:devi connetterti all'istanza principale anche se stai attivando l'estensione su un'istanza del pool di lettura.
3. Al prompt dei comandi psql, connettiti al database e crea l'estensione:

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   Nota: per creare l'estensione auto_explain, utilizza il comando `LOAD`.
4. Se vuoi, ripeti il passaggio precedente per connetterti ad altri database e crea l'estensione in ciascuno di essi.

Disattivare un'estensione

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

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

   Nota:devi connetterti all'istanza principale anche se stai disattivando un'estensione utilizzata solo nelle istanze del pool di lettura.
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 l'estensione è abilitata ed elimina l'estensione in ciascuno di essi.

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