配置数据库参数

选择文档版本：

本页面介绍了如何使用 AlloyDB Omni RPM 编排器配置数据库参数。

数据库参数也称为全局统一配置 (GUC) 参数，可用于调整 AlloyDB Omni 数据库集群的性能和行为。如需了解详情，请参阅 PostgreSQL 文档中的 设置参数。

准备工作

在配置数据库参数之前，请确保您已完成以下操作：

  1. 已安装 AlloyDB Omni 编排器。
  2. 预配并创建您的 AlloyDB Omni 集群。

配置数据库参数

如需配置数据库参数，请使用 DBCluster 资源规范的 primarySpec 部分中的 parameters 字段。

更新资源规范

在 DBCluster 资源规范中添加或修改所需参数及其值。您可以在创建集群期间配置参数，也可以在创建集群后更新参数。

以下代码段展示了 GUC 参数的示例。您可以采用类似的方式配置其他受支持的数据库参数：

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

替换以下内容：

  • CLUSTER_NAME：数据库集群的名称。
  • MAX_WAL_SIZE：一个示例参数，用于控制 WAL 在自动 WAL 检查点之间可以增长到的最大大小，例如 2GB。
  • MAX_CONNECTIONS_LIMIT：一个示例参数，用于控制允许连接到数据库服务器的并发连接数上限，例如 200。支持的最小值是 50。
  • HUGE_PAGES：一个示例参数，用于控制巨型页面的使用，例如 on。
  • LOG_STATEMENT：一个示例参数，用于控制要记录哪些 SQL 语句，例如 all。

应用配置

使用您偏好的编排器界面应用更改。

Ansible

如果您直接使用 Ansible 管理 AlloyDB Omni RPM 编排器基础架构，则系统会通过运行相应的 playbook 并将所选 update_action 作为额外变量传递来触发更新。

update.yml 的示例文件：

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

运行 Ansible 命令：

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

执行以下变量替换操作：

  • DEPLOYMENT_SPECIFICATION： 您在 安装 AlloyDB Omni 组件中创建的部署规范的路径。

  • DBCLUSTER_SPECIFICATION：集群规范的路径。

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

执行以下变量替换操作：

  • DEPLOYMENT_SPECIFICATION： 您在 安装 AlloyDB Omni 组件中创建的部署规范的路径。

  • DBCLUSTER_SPECIFICATION：集群规范的路径。

验证参数更改

应用配置后，您可以使用 psql 中的 SHOW 命令验证参数是否已更新：

SHOW PARAMETER_NAME;

将 PARAMETER_NAME 替换为您配置的参数的名称。