Polardb-X源码分析: 标准版和分布式版介绍

1. PolarDB-X 标准版（单节点）

• 定义：所有功能（CN、DN、GMS）都在同一个进程/节点上运行，数据不分片，适合开发、测试或小型场景。
• 实现：
  • 启动时只配置一个 Data Node（DN），所有数据都存储在这一个 DN 上。
  • 路由、分布式事务、GMS 等模块依然存在，但实际只管理一个 DN。
  • 代码层面，配置文件（如 polardbx-server 的启动参数、元数据表）只声明一个 DN 实例。
• 源码体现：
  • 配置文件中 DN 列表只有一个。
  • 路由、分片、事务等逻辑会自动退化为单节点模式（无分布式协调）。

2. PolarDB-X 分布式版（多节点）

• 定义：有多个 Data Node（DN），数据按分片规则分布在多个 DN 上，具备弹性扩展、分布式事务、分布式查询等能力。
• 实现：
  • 启动时配置多个 DN，GMS 负责全局元数据和分片信息。
  • CN 负责 SQL 解析、分布式路由、2PC 协调等，SQL 请求会被拆分并分发到多个 DN。
  • 事务、分布式 Join、分布式聚合等功能全部启用。
• 源码体现：
  • 配置文件中 DN 列表有多个。
  • 路由、分片、事务等逻辑会走完整的分布式流程。
  • 相关源码模块：polardbx-rule（分片规则）、polardbx-optimizer（分布式计划）、polardbx-transaction（分布式事务）、polardbx-gms（元数据/分片管理）。

3. 如何切换/配置

• 核心在于配置文件（如 GMS 的元数据表、polardbx-server 的启动参数），决定了是单节点还是多节点。
• 源码本身是统一的，没有“标准版”和“分布式版”两个不同的代码分支，所有分布式能力都在同一套代码中，根据配置自动启用或退化。

4. 典型配置举例

• 单节点（标准版）：

  dataNodes:
    - dn1: 127.0.0.1:3306
  

• 多节点（分布式版）：

  dataNodes:
    - dn1: 10.0.0.1:3306
    - dn2: 10.0.0.2:3306
    - dn3: 10.0.0.3:3306
  

5. 总结

• 标准版/分布式版的区别本质是部署和配置，源码是统一的。
• 单节点模式适合开发测试，多节点模式才体现出 PolarDB-X 的分布式能力。
• 你可以通过配置文件和 GMS 元数据表来灵活切换。