Configurar extensões de banco de dados

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

Consulte Extensões de banco de dados com suporte para conferir a lista de extensões compatíveis com o AlloyDB.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • É necessário ter uma destas funções do IAM no projeto do Google Cloud que você está usando:
    • roles/alloydb.admin (papel predefinido do IAM de administrador do AlloyDB)
    • roles/owner (o papel básico do IAM "Proprietário")
    • roles/editor (papel básico do IAM de editor)

    Se você não tiver nenhuma dessas funções, entre em contato com o administrador da organização para solicitar acesso.

Ativar uma extensão

Em geral, você ativa uma extensão conectando-se a um banco de dados na instância principal de um cluster do AlloyDB e inserindo um comando LOAD ou CREATE EXTENSION.

No entanto, algumas extensões exigem que você defina uma ou mais flags de banco de dados antes de usar o comando LOAD ou CREATE EXTENSION para ativar a extensão. Defina essas flags na instância do AlloyDB em que você quer usar a extensão, seja ela a instância principal ou a instância do pool de leitura.

Procedimento

  1. Se necessário, defina as flags de banco de dados adequadas na instância em que você quer usar a extensão, seja a principal ou uma instância de pool de leitura.

    A lista de extensões com suporte mostra quais extensões exigem essa etapa e quais sinalizações do banco de dados você precisa definir.

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

  3. No prompt de comando psql, conecte-se ao banco de dados e crie a extensão: 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. Se quiser, repita a etapa anterior para se conectar a outros bancos de dados e criar a extensão em cada um deles.

Desativar uma extensão

Para desativar uma extensão, inverta o procedimento usado para ativá-la.

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

  2. No prompt de comando psql, conecte-se ao banco de dados que tem a extensão ativada e exclua-a: 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. Repita a etapa anterior para se conectar a outros bancos de dados com a extensão ativada e exclua-a em cada um deles.

  4. Se a extensão exigiu que as flags do banco de dados fossem definidas nas instâncias em que ela foi usada, remova as flags de cada uma das instâncias em que ela foi usada seguindo as instruções em Configurar as flags do banco de dados de uma instância.

    A lista de extensões com suporte mostra quais extensões exigem a configuração de flags do banco de dados e identifica quais flags.