此页面由 Cloud Translation API 翻译。

配置数据库扩展程序

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

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

准备工作

您使用的 Google Cloud 项目必须已启用对 AlloyDB 的访问权限。
您必须在所使用的 Google Cloud 项目中拥有以下 IAM 角色之一：
- roles/alloydb.admin（AlloyDB 管理员预定义 IAM 角色）
- roles/owner（Owner 基本 IAM 角色）
- roles/editor（Editor 基本 IAM 角色）
如果您不具备上述任何角色，请与您的 Organization Administrator 联系以请求访问权限。

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

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

根据需要，在您要使用该扩展程序的实例（主实例或读取池实例）上设置适当的数据库标志。

支持的扩展程序列表会显示哪些扩展程序需要执行此步骤，并说明您必须设置哪些数据库标志。
按照将 psql 客户端连接到实例中所述，将 psql 客户端连接到集群的主实例。

注意：即使您是在读取池实例上启用扩展程序，也必须连接到主实例。
在 psql 命令提示符下，连接到数据库并创建扩展程序：
```
\c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
```
注意：如需创建 auto_explain 扩展程序，请使用 `LOAD` 命令。
如果需要，请重复上一步，连接到其他数据库并在其中创建扩展程序。

如需停用扩展程序，请执行启用扩展程序的逆向操作。

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

注意：即使您要停用仅在读取池实例上使用的扩展程序，也必须连接到主实例。
在 psql 命令提示符下，连接到已启用扩展程序的数据库，然后删除该扩展程序：
```
\c DB_NAME
DROP EXTENSION EXTENSION_NAME;
```
重复上一步，连接到已启用该扩展程序的任何其他数据库，并在其中删除该扩展程序。
如果扩展程序要求在使用该扩展程序的实例上设置数据库标志，请按照配置实例的数据库标志中的说明从每个使用该扩展程序的实例中移除标志。

支持的扩展程序列表会显示哪些扩展程序需要设置数据库标志，并指明具体是哪些标志。