配置数据库扩展程序

本页面介绍了如何在 AlloyDB 中启用和停用 PostgreSQL 扩展程序。

如需查看 AlloyDB 支持的扩展程序列表，请参阅支持的数据库扩展程序。

准备工作

• 您使用的 Google Cloud 项目必须已启用才能访问 AlloyDB。
• 您必须在所使用的 Google Cloud 项目中拥有以下 IAM 角色之一：
  • roles/alloydb.admin（AlloyDB Admin 预定义 IAM 角色）
  • roles/owner（Owner 基本 IAM 角色）
  • roles/editor（Editor 基本 IAM 角色）

  如果您不拥有上述任何角色，请与组织管理员联系以申请访问权限。

启用扩展程序

一般来说，您可以通过连接到 AlloyDB 集群主实例中的数据库并输入 LOAD 或 CREATE EXTENSION 命令来启用扩展程序。

不过，某些扩展程序要求您先设置一个或多个数据库标志，然后才能使用 LOAD 或 CREATE EXTENSION 命令启用相应扩展程序。您可以对使用扩展程序的 AlloyDB 实例（无论该实例是主实例还是读取池实例）设置这些标志。

过程

1. 如果需要，请对要使用扩展程序的主实例或读取池实例设置适当的数据库标志。

   支持的扩展程序列表显示了哪些扩展程序要求执行此步骤，并说明了您必须设置哪些数据库标志。

2. 按照将 psql 客户端连接到实例中所述，将 psql 客户端连接到集群的主实例。

   注意：即使您是在读取池实例上启用扩展程序，也必须连接到主实例。
3. 在 psql 命令提示符下，连接到数据库并创建扩展程序：

   \c DB_NAME
   CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;

   注意：如需创建 auto_explain 扩展程序，请使用“LOAD”命令。
4. 如果需要，请重复上一步以连接到其他数据库，并在每个数据库中创建扩展程序。

停用扩展程序

您可以通过反向执行用于启用扩展程序的步骤来停用相应的扩展程序。

1. 按照将 psql 客户端连接到实例中所述，将 psql 客户端连接到集群的主实例。

   注意：即使您要停用仅在读取池实例上使用的扩展程序，也必须连接到主实例。
2. 在 psql 命令提示符下，连接到已启用扩展程序的数据库，然后删除扩展程序：

   \c DB_NAME
   DROP EXTENSION EXTENSION_NAME;

3. 重复上一步以连接到已启用扩展程序的任何其他数据库，并在每个数据库中删除扩展程序。

4. 如果扩展程序要求对使用它的实例设置数据库标志，请按照配置实例的数据库标志中的说明，从使用扩展程序的每个实例中移除这些标志。

   支持的扩展程序列表显示了哪些扩展程序要求设置数据库标志，并标明了要设置哪些标志。