作为一名加瓦工程师，我一直在寻找能够满足企业级分布式需求的数据库解决方案。最近接触到了OpenTenBase，这是一个基于Postgres-XL的企业级分布式数据库系统。今天我将分享我的一日入门实战经历，从环境准备到集群搭建，再到实际业务测试的完整过程。

OpenTenBase是腾讯开源的分布式数据库系统，采用了经典的分布式架构：

这种架构让我想起了传统的分库分表方案，但OpenTenBase在透明性和一致性方面做得更好。

我准备了4台CentOS 7虚拟机来搭建测试集群：

每台机器配置：4核CPU，8GB内存，100GB存储空间。

首先在所有节点上安装必要的依赖：

# 安装编译依赖
sudo yum -y install gcc make readline-devel zlib-devel openssl-devel uuid-devel bison flex git

# 关闭防火墙和SELinux（测试环境）
sudo systemctl stop firewalld
sudo systemctl disable firewalld
sudo sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

在所有节点上创建opentenbase用户：

sudo mkdir -p /data
sudo useradd -d /data/opentenbase -s /bin/bash -m opentenbase
sudo passwd opentenbase  # 设置密码为：OpenTenBase@2024

这一步很关键，集群管理工具需要通过SSH连接各个节点：

# 在主节点生成密钥
ssh-keygen -t rsa -N "" -f ~/.ssh/id_rsa

# 分发公钥到所有节点
for ip in 192.168.1.101 192.168.1.102 192.168.1.103 192.168.1.104; do
    ssh-copy-id opentenbase@$ip
done

切换到opentenbase用户，开始编译安装：

su - opentenbase
cd /data/opentenbase

# 下载源码
git clone https://github.com/OpenTenBase/OpenTenBase.git

# 设置环境变量
export SOURCECODE_PATH=/data/opentenbase/OpenTenBase
export INSTALL_PATH=/data/opentenbase/install

cd ${SOURCECODE_PATH}

# 配置编译选项
./configure --prefix=${INSTALL_PATH}/opentenbase_bin_v2.0 \
    --enable-user-switch \
    --with-openssl \
    --with-ossp-uuid \
    CFLAGS=-g

# 编译安装
make clean
make -sj4  # 使用4个并行任务
make install

# 编译扩展模块
cd contrib
make -sj4
make install

编译过程大约需要20-30分钟，期间我去泡了杯咖啡。编译完成后，设置环境变量：

# 添加到 ~/.bashrc
cat >> ~/.bashrc << 'EOF'
export PG_HOME=/data/opentenbase/install/opentenbase_bin_v2.0
export PATH="$PATH:$PG_HOME/bin"
export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$PG_HOME/lib"
export LC_ALL=C
EOF

source ~/.bashrc

启动pgxc_ctl工具生成配置模板：

#!/usr/bin/env bash

# OpenTenBase集群配置文件
pgxcInstallDir=/data/opentenbase/install/opentenbase_bin_v2.0

#---- GTM 配置 ----
gtmName=gtm
gtmMasterServer=192.168.1.101
gtmMasterPort=50001
gtmMasterDir=/data/opentenbase/data/gtm_master

# 暂不配置GTM备节点
gtmSlave=n

#---- Coordinator 配置 ----
coordNames=(cn001)
coordMasterCluster=(opentenbase_cluster)
coordPorts=(30004)
poolerPorts=(30014)
coordPgHbaEntries=(0.0.0.0/0)
coordMasterServers=(192.168.1.101)
coordMasterDirs=(/data/opentenbase/data/cn_master/cn001)

# 暂不配置Coordinator备节点
coordSlave=n

#---- DataNode 配置 ----
primaryDatanode=dn001
datanodeNames=(dn001 dn002)
datanodePorts=(20008 20009)
datanodePoolerPorts=(20018 20019)
datanodeMasterCluster=(opentenbase_cluster opentenbase_cluster)
datanodePgHbaEntries=(0.0.0.0/0)
datanodeMasterServers=(192.168.1.102 192.168.1.103)
datanodeMasterDirs=(/data/opentenbase/data/dn_master/dn001 /data/opentenbase/data/dn_master/dn002)

# 暂不配置DataNode备节点
datanodeSlave=n

#---- 其他配置 ----
pgxcOwner=opentenbase
pgxcUser=opentenbase
tmpDir=/tmp
localTmpDir=/tmp
configBackup=y
configBackupHost=192.168.1.101
configBackupDir=/data/opentenbase/backup
configBackupFile=pgxc_ctl.conf.backup

这个过程会将编译好的二进制文件分发到各个节点。我看到类似这样的输出：

Installing pgxc_ctl_bash script as /data/opentenbase/pgxc_ctl/pgxc_ctl_bash.
Installing pgxc_ctl_bash script as /data/opentenbase/pgxc_ctl/pgxc_ctl_bash.
pgxc_ctl_bash script installed.
Deploying Postgres-XC components to all the target servers.
Prepare tarball to deploy ...
Deploying to the server 192.168.1.101
Deploying to the server 192.168.1.102
Deploying to the server 192.168.1.103
Done.

这是最激动人心的时刻！初始化过程包括：

Initialize GTM master
You can now start the database server using:

    /data/opentenbase/install/opentenbase_bin_v2.0/bin/gtm -D /data/opentenbase/data/gtm_master

Start GTM master
server starting
Initialize coordinator master cn001
The files belonging to this database system will be owned by user "opentenbase".
...
database system is ready to accept connections
Initialize datanode master dn001
Initialize datanode master dn002
...
Done.

输出显示所有节点都在正常运行：

Running: gtm master
Running: coordinator master cn001
Running: datanode master dn001
Running: datanode master dn002

使用psql客户端连接到Coordinator节点：

psql -h 192.168.1.101 -p 30004 -U opentenbase -d postgres

首先创建默认节点组和分片组：

-- 创建默认节点组
postgres=# CREATE DEFAULT NODE GROUP default_group WITH (dn001, dn002);
CREATE NODE GROUP

-- 创建分片组
postgres=# CREATE SHARDING GROUP TO GROUP default_group;
CREATE SHARDING GROUP

创建一个用户订单表来测试分布式功能：

-- 创建用户表（按用户ID分片）
CREATE TABLE users (
    user_id BIGINT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) DISTRIBUTE BY SHARD(user_id);

-- 创建订单表（按用户ID分片，与用户表保持数据亲和性）
CREATE TABLE orders (
    order_id BIGINT PRIMARY KEY,
    user_id BIGINT NOT NULL,
    product_name VARCHAR(200),
    amount DECIMAL(10,2),
    order_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) DISTRIBUTE BY SHARD(user_id);

插入一些模拟数据来测试分布式特性：

-- 插入用户数据
INSERT INTO users (user_id, username, email) VALUES
(1001, 'alice', 'alice@example.com'),
(1002, 'bob', 'bob@example.com'),
(1003, 'charlie', 'charlie@example.com'),
(1004, 'diana', 'diana@example.com'),
(1005, 'eve', 'eve@example.com');

-- 插入订单数据
INSERT INTO orders (order_id, user_id, product_name, amount) VALUES
(2001, 1001, 'iPhone 15', 7999.00),
(2002, 1001, 'AirPods Pro', 1999.00),
(2003, 1002, 'MacBook Pro', 15999.00),
(2004, 1003, 'iPad Air', 4599.00),
(2005, 1004, 'Apple Watch', 2999.00),
(2006, 1005, 'Magic Keyboard', 1299.00);

-- 查询用户及其订单信息
SELECT u.username, u.email, o.product_name, o.amount, o.order_date
FROM users u
JOIN orders o ON u.user_id = o.user_id
WHERE u.user_id IN (1001, 1002)
ORDER BY o.order_date;

使用pgbench进行简单的性能测试：

# 初始化测试数据
pgbench -i -s 10 -h 192.168.1.101 -p 30004 -U opentenbase postgres

# 运行性能测试（10个并发，持续60秒）
pgbench -c 10 -j 2 -T 60 -h 192.168.1.101 -p 30004 -U opentenbase postgres
​

测试结果显示TPS约为1200，对于我的测试环境来说表现不错。

OpenTenBase提供了一些有用的监控视图：

-- 查看节点信息
SELECT * FROM pgxc_node;

-- 查看表分布信息
SELECT schemaname, tablename, nodeoids 
FROM pgxc_class 
WHERE schemaname = 'public';

-- 查看连接池状态
SELECT * FROM pool_connections;

验证数据是否按预期分布到不同节点：

-- 在dn001上查看数据
EXECUTE DIRECT ON (dn001) 'SELECT count(*) FROM users';

-- 在dn002上查看数据  
EXECUTE DIRECT ON (dn002) 'SELECT count(*) FROM users';

结果显示数据确实分布在不同的节点上，证明分片功能正常工作。

对于生产环境，建议制定完整的备份策略：

# 备份GTM
pg_dumpall -h 192.168.1.101 -p 50001 -U opentenbase > gtm_backup.sql

# 备份Coordinator元数据
pg_dump -h 192.168.1.101 -p 30004 -U opentenbase -s postgres > coord_schema.sql

# 备份各个DataNode的数据
pg_dump -h 192.168.1.102 -p 20008 -U opentenbase postgres > dn001_backup.sql
pg_dump -h 192.168.1.103 -p 20009 -U opentenbase postgres > dn002_backup.sql

：集群启动失败，日志显示端口被占用

使用不同的端口号，并检查系统中没有其他服务占用这些端口。

：deploy阶段失败，提示SSH连接被拒绝

：检查SSH服务是否启动，确保防火墙允许SSH连接，验证SSH免密配置是否正确。

从零到集群的实战 OpenTenBase 一日入门

产品KOL

数据库

云计算

运维

OpenTenBase是基于PostgreSQL的企业级分布式数据库解决方案，支持透明分片和分布式事务。本文详细介绍了从环境准备、集群搭建到业务测试的全过程，包括4节点CentOS7环境配置、分布式表创建、跨节点JOIN查询和性能测试。适合需要SQL兼容性高、水平扩展能力强的OLTP业务场景，为开发者提供完整的分布式数据库实践指南。

分布式数据库

数据一致性

性能测试

PostgreSQL

虚拟机

防火墙

Ubuntu

OLTP

AI驱动 智领未来

tencentdb-catalog

tddbms

postgres

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

OpenTenBase是基于PostgreSQL的企业级分布式数据库解决方案，支持透明分片和分布式事务。本文详细介绍了从环境准备、集群搭建到业务测试的全过程，包括4节点CentOS7环境配置、分布式表创建、跨节点JOIN查询和性能测试。适合需要SQL兼容性高、水平扩展能力强的OLTP业务场景，为开发者提供完整的分布式数...

从零到集群的实战 OpenTenBase 一日入门

从零到集群的实战 OpenTenBase 一日入门

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐