Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Extension management

Última atualização: Aug 14, 2026

Este tópico descreve como gerenciar extensões do ApsaraDB RDS for PostgreSQL no console do ApsaraDB RDS, incluindo filtragem, instalação, desinstalação, atualização e aplicação em outros bancos de dados.

Pré-requisitos

  • A versão principal do mecanismo é PostgreSQL 10 ou superior.

  • A versão secundária do mecanismo da instância é 20230330 ou superior. Para visualizar e atualizar a versão secundária do mecanismo, consulte Upgrade the minor engine version.

  • A instância é primária e utiliza ESSD ou Premium ESSD.

  • A instância possui pelo menos uma conta privilegiada e um banco de dados. Para criar esses recursos, consulte Create an account and a database.

Observações de uso

  • A instância reinicia automaticamente ao instalar uma extensão que exige pré-carregamento via parâmetro shared_preload_libraries e ainda não consta no valor desse parâmetro.

    Nota

    Na página Parameters, verifique o parâmetro shared_preload_libraries para confirmar se a extensão requer pré-carregamento e se já está incluída no valor.

  • A extensão pg_cron depende do parâmetro cron.database_name. Alterações nesse parâmetro só entram em vigor após a reinicialização da instância. Ao instalar a pg_cron em um banco de dados de destino, o sistema define cron.database_name como esse banco. Portanto, a instalação reinicia a instância mesmo que a pg_cron já conste no valor do parâmetro shared_preload_libraries. Instale a pg_cron fora dos horários de pico.

  • As extensões GanosBase e PostGIS não podem ser instaladas no mesmo schema.

  • Para instalar as extensões listadas abaixo, a conta do banco de dados de destino deve ser privilegiada. Caso contrário, a instalação falhará.

    ganos_geometry_topology, ganos_tiger_geocoder, postgis_tiger_geocoder e postgis_topology.

  • Tenha cautela ao desinstalar uma extensão. Essa operação pode causar perda de dados ou interrupções no service.

Procedimento

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região da instância RDS. Em seguida, localize a instância e clique em no respectivo ID.

  2. No painel de navegação à esquerda, clique em Plug-ins.

    • Na aba Extension Marketplace, visualize e instale extensões populares .

      • Clique em Install na extensão desejada para instalá-la no banco de dados de destino.

    • Na aba Extension Management, selecione um banco de dados pelo nome para gerenciar suas extensões.

      • Filtrar extensões

        Use Filter by extension para filtrar extensões por recurso. É possível selecionar vários recursos.

      • Instalar extensões

        Na aba Uninstalled Extensions, localize a extensão desejada e clique em Install na coluna Actions.

        Também é possível selecionar várias extensões para instalação em lote.

      • Desinstalar extensões

        Na aba Installed Extensions, localize a extensão desejada e clique em Uninstall na coluna Actions.

        Também é possível selecionar várias extensões para desinstalação em lote.

        Importante

        Tenha cautela ao desinstalar uma extensão. Essa operação pode causar perda de dados ou interrupções no service.

      • Atualizar extensões

        Na aba Installed Extensions, localize a extensão desejada e clique em Upgrade Version na coluna Actions.

        Nota

        Se a coluna Actions de uma extensão não exibir o botão Upgrade Version, a extensão já está na versão mais recente.

      • Aplicar extensões a outros bancos de dados

        Na aba Installed Extensions, clique em Apply to Other Databases para instalar todas as extensões do banco de dados atual em outros bancos de dados.

Referência de API

API

Descrição

CreatePostgresExtensions

Instala uma ou mais extensões especificadas em um banco de dados de destino.

Nota

Se a extensão não for criada após chamar esta API, verifique se a versão principal do mecanismo da instância oferece suporte à extensão. Para mais informações, consulte Supported extensions for ApsaraDB RDS for PostgreSQL.

DescribePostgresExtensions

Consulta informações sobre todas as extensões em um banco de dados específico de uma instância.

UpdatePostgresExtensions

Atualiza uma extensão especificada em um banco de dados de destino.

DeletePostgresExtensions

Exclui uma extensão especificada de um banco de dados de destino.