Configurar extensões de banco de dados

Nesta página, descrevemos 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.

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. Você define essas flags na instância do AlloyDB em que quer usar a extensão, seja 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 principal ou uma instância do pool de leitura.

   A lista de extensões com suporte mostra quais extensões exigem essa etapa e quais flags de banco de dados precisam ser definidas.

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 do 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. É sua responsabilidade atualizar manualmente as extensões para garantir que elas usem as versões mais recentes com suporte.

Para determinar quais extensões exigem uma atualização, compare a versão instalada com a versão mais recente com suporte listada na tabela de referência Extensões com suporte.

Conecte-se ao banco de dados e execute o comando a seguir para conferir 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 comando a seguir para cada extensão que você quer atualizar:

ALTER EXTENSION EXTENSION_NAME UPDATE;

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

ALTER EXTENSION EXTENSION_NAME UPDATE TO 'VERSION_NUMBER';

Desativar uma extensão

Você desativa uma extensão revertendo 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ó está sendo 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 solte a extensão:

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

3. Repita a etapa anterior para se conectar a outros bancos de dados que têm a extensão ativada e solte a extensão em cada um deles.

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

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