Configurar extensões de banco de dados

Para adicionar mais funcionalidades aos bancos de dados do AlloyDB para PostgreSQL, como pesquisa vetorial, indexação geoespacial ou auditoria de consultas, é possível ativar, atualizar e desativar as extensões compatíveis do PostgreSQL.

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

Ativar uma extensão

Em geral, para ativar uma extensão, conecte-se a um banco de dados na instância principal de um cluster do AlloyDB e insira 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 apropriadas na instância em que você quer usar a extensão, seja a instância primária ou uma instância de pool de leitura.

   A lista de extensões compatíveis mostra quais extensões exigem essa etapa e indica quais flags de 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.

   Observação:é necessário se conectar à instância principal, mesmo que você esteja ativando a extensão em uma instância de pool de leitura.
3. No prompt de comando psql, conecte-se ao banco de dados e crie a extensão:

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   Observação:para criar a extensão auto_explain, use o comando LOAD.
4. Se quiser, repita a etapa anterior para se conectar a outros bancos de dados e criar a extensão em cada um deles.

Atualizar uma extensão

Embora as atualizações de manutenção do AlloyDB instalem automaticamente os binários de extensão mais recentes no software subjacente da instância, elas não atualizam automaticamente o catálogo de banco de dados da extensão. Você é responsável por atualizar manualmente suas extensões para garantir que elas usem as versões mais recentes compatíveis.

Para determinar quais extensões precisam de uma atualização, compare a versão instalada com a versão mais recente compatível listada na tabela de referência de extensões compatíveis.

Conecte-se ao banco de dados e execute o seguinte comando para ver as versões instaladas:

SELECT * FROM pg_extension;

Para atualizar uma extensão para a versão mais recente disponível na instância, use o comando ALTER EXTENSION.

Conecte-se à instância principal do cluster usando um cliente de sua escolha, como o AlloyDB Studio ou um cliente psql, e execute o seguinte comando para cada extensão que você quer atualizar:

ALTER EXTENSION EXTENSION_NAME UPDATE;

Se você precisar atualizar para uma versão específica, use esta sintaxe:

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

Desativar uma extensão

Para desativar uma extensão, reverta 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.

   Observação:é necessário se conectar à instância principal, mesmo que você esteja desativando uma extensão que só é usada em instâncias do pool de leitura.
2. No prompt de comando psql, conecte-se ao banco de dados que tem a extensão ativada e remova-a:

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

3. Repita a etapa anterior para se conectar a outros bancos de dados que tenham a extensão ativada e remova a extensão em cada um deles.

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

   A lista de extensões compatíveis mostra quais extensões exigem a configuração de flags de banco de dados e identifica quais flags.