É possível estender o PostgreSQL agrupando objetos SQL em um pacote e usando-os como uma unidade. Esta página contém informações sobre como configurar as extensões do PostgreSQL compatíveis com o Cloud SQL.
Usar extensões do PostgreSQL
Só é possível instalar as extensões compatíveis com o Cloud SQL. Para mais informações, consulte Extensões do PostgreSQL compatíveis com o Cloud SQL.
Instalar uma extensão
Antes de usar uma extensão, instale-a:
- Na ferramenta psql, execute o comando CREATE EXTENSION.
Atualizar uma extensão
Embora as atualizações de manutenção do Cloud SQL para PostgreSQL instalem automaticamente os binários de extensão mais recentes no software 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 nas tabelas Extensões do PostgreSQL compatíveis com o Cloud SQL.
Conecte-se ao banco de dados e execute o seguinte comando para conferir as versões instaladas:
SELECT * FROM pg_extension;
Para atualizar uma extensão para a versão mais recente disponível na sua instância, use o
comando ALTER EXTENSION.
Conecte-se à instância principal usando um cliente de sua escolha, como o Cloud SQL Studio ou o 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 a seguinte sintaxe:
ALTER EXTENSION EXTENSION_NAME
UPDATE TO 'VERSION_NUMBER';
Requisito para privilégios de superusuário
No Cloud SQL, as extensões só podem ser criadas por usuários que fazem parte do
papel cloudsqlsuperuser. Quando você cria uma nova instância do PostgreSQL,
o usuário postgres padrão é criado para você (embora seja
necessário definir a senha do usuário). O usuário postgres padrão faz parte do
papel cloudsqlsuperuser. Para mais informações, consulte
Sobre usuários do PostgreSQL.
Conexões entre bancos de dados
As instâncias de destino para conexões precisam estar na mesma rede VPC que a instância de conexão.
Para instâncias de cluster, não é possível escolher a opção
Exigir certificados do cliente confiáveis no
Google Cloud console.
Além disso, para se conectar a outros bancos de dados
na mesma instância, não é possível definir o host
como localhost ou como 127.0.0.1. Em vez disso, use o endereço IP
mostrado para sua instância no console do Google Cloud .
Solicitar suporte para uma nova extensão
Não é possível criar suas próprias extensões com o Cloud SQL.
Para solicitar suporte para uma extensão, clique em +1 no problema aberto ou crie um novo. Para ver uma lista de problemas abertos do Cloud SQL e informações sobre como criar novos problemas, consulte Pesquisar ou criar problemas e solicitações de recursos por produto.
Extensões PostgreSQL aceitas pelo Cloud SQL
Para informações sobre como usar uma extensão específica, consulte o link da documentação em uma das tabelas abaixo.
O suporte do Cloud SQL para extensões do PostgreSQL pode ser dividido nestas categorias:
PostGIS
A extensão PostGIS é compatível com o Cloud SQL para PostgreSQL em todas as versões principais.
A tabela a seguir contém as versões de extensão do PostGIS para cada versão do Cloud SQL para PostgreSQL:
| Versão do Cloud SQL para PostgreSQL | Extensão do PostGIS |
| PostgreSQL 9.6 | 3.2.5 |
| PostgreSQL 10 | 3.2.5 |
| PostgreSQL 11 | 3.2.5 |
| PostgreSQL 12 | 3.4.4 |
| PostgreSQL 13 | 3.5.2 |
| PostgreSQL 14 | 3.5.2 |
| PostgreSQL 15 | 3.5.2 |
| PostgreSQL 16 | 3.5.2 |