GaussDB分布式数据库安装与配置实战指南

1. GaussDB数据库安装概述

GaussDB作为一款企业级分布式数据库，在金融、电信等行业有着广泛应用。我第一次接触GaussDB是在某银行核心系统改造项目中，当时需要将传统Oracle数据库迁移到这个国产分布式数据库平台。与集中式数据库不同，GaussDB的安装过程需要考虑节点规划、网络配置等分布式特性。

典型安装场景包括：

• 开发测试环境搭建（通常3节点）
• 生产环境高可用部署（至少5节点起步）
• 云环境容器化部署（Kubernetes集群）

重要提示：生产环境安装前务必完成容量评估，包括存储空间、内存需求和网络带宽计算。我曾见过因存储规划不足导致安装后无法正常启动的案例。

2. 安装前环境准备

2.1 硬件需求评估

根据华为官方文档建议，不同规模部署的硬件基准配置如下：

实际项目中我习惯额外预留20%资源余量。特别是存储空间，数据库安装包本身约需5GB，但WAL日志和临时文件会快速占用额外空间。

2.2 操作系统配置

GaussDB支持的主流操作系统包括：

• CentOS 7.6/7.9（推荐）
• EulerOS 2.8
• openEuler 20.03

关键系统参数调整（以CentOS为例）：

bash复制# 关闭透明大页
echo never > /sys/kernel/mm/transparent_hugepage/enabled

# 调整内核参数
cat >> /etc/sysctl.conf <<EOF
kernel.sem = 250 32000 100 999
vm.swappiness = 0
EOF
sysctl -p

# 设置文件句柄数
ulimit -n 655360

常见坑点：SELinux必须禁用，否则会导致安装失败。我遇到过因SELinux未彻底关闭导致数据库进程无法访问数据目录的情况。

3. 安装包获取与校验

3.1 官方渠道下载

目前GaussDB 100的安装包需要通过华为企业支持网站获取：

1. 登录https://support.huawei.com/enterprise/
2. 搜索"GaussDB 100 V300R001C00"
3. 下载对应版本的安装包（通常名为GaussDB_100_V300R001C00_OS.tar.gz）

3.2 安装包完整性验证

下载完成后必须进行校验：

bash复制# 计算SHA256校验值
sha256sum GaussDB_100_V300R001C00_OS.tar.gz

# 对比官方提供的校验码
echo "a1b2c3d4e5...  GaussDB_100_V300R001C00_OS.tar.gz" | sha256sum -c

我曾遇到因网络传输错误导致安装包损坏的情况，校验不通过时务必重新下载。

4. 详细安装步骤

4.1 解压安装包

建议在/opt目录下创建专用目录：

bash复制mkdir -p /opt/gaussdb
tar -zxvf GaussDB_100_V300R001C00_OS.tar.gz -C /opt/gaussdb
cd /opt/gaussdb

4.2 配置文件修改

主要配置文件包括：

• cluster_config.xml（集群拓扑定义）
• gaussdb.env（环境变量）
• install.ini（安装参数）

关键配置示例：

xml复制<!-- cluster_config.xml片段 -->
<node>
    <id>1</id>
    <name>node1</name>
    <ip>192.168.1.101</ip>
    <port>5432</port>
    <role>master</role>
    <az>AZ1</az>
</node>

4.3 执行安装脚本

主安装命令：

bash复制./install.py -U gaussdb -G gaussdb -R /data/gaussdb \
    -C cluster_config.xml --skip-host-check

参数说明：

• -U：运行数据库的操作系统用户
• -G：用户组
• -R：数据目录根路径
• --skip-host-check：跳过主机名检查（测试环境可用）

实战经验：生产环境不要使用skip参数，必须确保所有节点的主机名解析配置正确。某次项目就因hosts文件配置错误导致集群脑裂。

5. 安装后配置

5.1 数据库初始化

创建初始数据库：

bash复制gs_initdb -D /data/gaussdb/data --nodename=node1 \
    --encoding=UTF8 --locale=en_US.utf8

字符集选择建议：

• 纯英文环境：en_US.utf8
• 中文环境：zh_CN.utf8

5.2 服务启动与验证

启动数据库服务：

bash复制gs_ctl start -D /data/gaussdb/data -Z single_node

验证安装成功：

sql复制-- 连接数据库
gsql -d postgres -p 5432

-- 执行测试查询
SELECT version();
CREATE TABLE test(id int);
INSERT INTO test VALUES(1);
SELECT * FROM test;

6. 常见问题排查

6.1 安装失败问题集

6.2 性能调优建议

安装后的关键优化参数：

sql复制ALTER SYSTEM SET shared_buffers = '8GB';
ALTER SYSTEM SET work_mem = '64MB';
ALTER SYSTEM SET maintenance_work_mem = '1GB';

监控工具推荐：

• gs_checkperf：内置性能检查工具
• Prometheus+Grafana：可视化监控方案

7. 扩展功能配置

7.1 高可用部署

配置流复制实现主备切换：

bash复制# 主节点配置
gs_guc set -D /data/gaussdb/data -c "synchronous_standby_names = 'node2'"

# 备节点配置
gs_ctl build -D /data/gaussdb/standby -b full

7.2 备份恢复方案

配置基础备份：

bash复制gs_basebackup -D /backup/gaussdb -h 192.168.1.101 -p 5432 -U backup

设置WAL归档：

sql复制ALTER SYSTEM SET archive_mode = on;
ALTER SYSTEM SET archive_command = 'cp %p /archive/%f';

8. 开发工具链集成

8.1 驱动安装

JDBC驱动配置示例（Maven）：

xml复制<dependency>
    <groupId>com.huawei.gaussdb</groupId>
    <artifactId>gaussdb-jdbc</artifactId>
    <version>3.0.0</version>
</dependency>

8.2 管理工具推荐

• Data Studio：官方GUI管理工具
• DBeaver：开源通用数据库工具
• Navicat Premium：商业数据库管理套件

连接字符串示例：

code复制jdbc:postgresql://192.168.1.101:5432/postgres?currentSchema=public

9. 升级与维护

9.1 版本升级流程

1. 停止所有数据库服务
2. 备份配置文件和数据库
3. 安装新版本软件包
4. 执行升级脚本：

bash复制./upgrade.py -U gaussdb -D /data/gaussdb/data

9.2 日常维护命令

检查集群状态：

bash复制gs_om -t status

日志文件位置：

• /data/gaussdb/data/pg_log/：运行日志
• /var/log/gaussdb/：安装日志

10. 安全加固建议

10.1 基础安全配置

修改默认密码：

sql复制ALTER USER gaussdb PASSWORD '新密码';

配置IP白名单：

sql复制ALTER SYSTEM SET listen_addresses = 'localhost,192.168.1.100';

10.2 审计功能启用

开启SQL审计：

sql复制ALTER SYSTEM SET audit_enabled = on;
ALTER SYSTEM SET audit_directory = '/data/gaussdb/audit';

审计策略示例：

sql复制CREATE AUDIT POLICY table_policy ON ALL TABLES;