Configure extensões de base de dados

Esta página descreve como ativar e desativar extensões do PostgreSQL no AlloyDB.

Consulte o artigo Extensões de base de dados suportadas para ver a lista das extensões suportadas pelo AlloyDB.

Antes de começar

  • O Google Cloud projeto que está a usar tem de ter sido ativado para aceder ao AlloyDB.
  • Tem de ter uma destas funções de IAM no Google Cloud projeto que está a usar:
    • roles/alloydb.admin (a função IAM predefinida de administrador do AlloyDB)
    • roles/owner (a função de IAM básica de proprietário)
    • roles/editor (a função de IAM básica de editor)

    Se não tiver nenhuma destas funções, contacte o administrador organizacional para pedir acesso.

Ative uma extensão

Em geral, ativa uma extensão estabelecendo ligação a uma base de dados na instância principal de um cluster do AlloyDB e introduzindo um comando LOAD ou CREATE EXTENSION.

No entanto, algumas extensões requerem que defina uma ou mais flags da base de dados antes de poder usar o comando LOAD ou CREATE EXTENSION para ativar a extensão. Defina estas flags na instância do AlloyDB onde quer usar a extensão, quer essa instância seja a instância principal ou a instância do conjunto de leitura.

Procedimento

  1. Se necessário, defina as flags da base de dados adequadas na instância onde quer usar a extensão, quer seja a instância principal ou uma instância de conjunto de leitura.

    A lista de extensões suportadas mostra que extensões requerem este passo e indica que flags da base de dados tem de definir.

  2. Associe um cliente psql à instância principal do cluster, conforme descrito em Associe um cliente psql a uma instância.

  3. Na linha de comandos psql, ligue-se à base de dados e crie a extensão: 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. Se quiser, repita o passo anterior para estabelecer ligação a outras bases de dados e criar a extensão em cada uma delas.

Desative uma extensão

Desative uma extensão invertendo o procedimento usado para a ativar.

  1. Associe um cliente psql à instância principal do cluster, conforme descrito em Associe um cliente psql a uma instância.

  2. Na linha de comandos psql, ligue-se à base de dados que tem a extensão ativada e elimine a extensão: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Repita o passo anterior para estabelecer ligação a quaisquer outras bases de dados que tenham a extensão ativada e elimine a extensão em cada uma delas.

  4. Se a extensão exigiu que os indicadores da base de dados fossem definidos nas instâncias onde foi usada, remova os indicadores de cada uma das instâncias onde foi usada seguindo as instruções em Configure os indicadores da base de dados de uma instância.

    A lista de extensões suportadas mostra que extensões requerem a definição de flags da base de dados e identifica que flags.