数据库性能诊断DBdoctor快速纳管PolarDB-X 分布式版数据库

PolarDB分布式版(PolarDB for Xscale，简称“PolarDB-X”)是一款云原生分布式数据库，具备弹性扩展、高可用和分布式事务处理能力。DBdoctor是集性能监控与根因诊断、SQL审核与优化治理、数据脱敏与安全防护三大功能于一体的智能数据库管理平台。现已支持对PolarDB-X 分布式版数据库的纳管，可为PolarDB用户提供高效的数据库智能诊断服务。

一.如何快速纳管PolarDB-X分布式版数据库

下面将详细介绍如何使用DBdoctor纳管PolarDB-X分布式版数据库并对其进行性能诊断。

1.PolarDB-X分布式版数据库纳管部署架构：

上图中PolarDB-X 分布式版数据库有3个CN 节点、9个DN节点。CN负责SQL解析和查询调度，而DN负责数据存储和本地计算，两者协同实现分布式数据库的高效处理与扩展性。DBdoctor 可直接通过PolarDB对外统一地址来进行纳管PolarDB-X分布式版数据库，并自动发现所有的DN 节点。每一个DN 节点上只需要部署一个agent(可自动部署)，即可实现对虚拟集群的纳管。

2.一分钟零依赖DBdoctor Server安装：

环境要求：4c8g（建议独立的资源部署，可以添加选项--unlimited忽略4c8g的限制）

下载安装包：https://www.dbdoctor.cn/?utm=02

用系统root账号进行安装包解压，然后执行 ./dbd -I

服务访问地址：http://<部署服务的主机ip>:13000

登录账号：tester/Root2023!

详细文档：https://demo.dbdoctor.cn/modules/dbDoctor/mdPreview/index.html?readme=help#/

3.快速纳管PolarDB-X 分布式版数据库

a) 创建访问账号（如已有账号，则直接进入下一步）

针对于PolarDB-X 分布式版数据库，需要分别在CN节点和 DN Leader节点创建相同的账号并赋予查询权限。

在CN节点上执行以下命令创建数据库账号并授予权限

create user test identified by 'Root2023!';GRANT SELECT, SHOW VIEW, REPLICATION SLAVE ON *.* TO 'test'@'%'

在DN Leader节点上执行以下命令创建数据库账号并授予只读权限。可根据以下两种场景说明DN的登录方式及执行授权操作。

1. 连接CN执行以下命令，可查询出DN节点的LEADER_NODE的ip:port： show storage2. 针对PXD部署方式：  - 登陆LEADER_NODE ip所在机器上执行以下命令找到指定容器：   docker ps | grep <LEADER_NODE port>  - 找到容器后，执行以下命令进入LEADER DN容器：   docker exec -it <容器id> bash  - 执行myc登录DN数据库，然后可执行create user创建账号与grant授权命令3. 针对K8S部署方式：  - 执行以下命令找到POD：   kubectl -n <集群部署的namespace> get pods -owide | grep <LEADER_NOD ip>  - 找到POD后，执行以下命令进入LEADER DN的POD：   kubectl -n <集群部署的namespace> exec -it <pod_name> bash  - 执行myc登录DN数据库，然后可执行create user创建账号与grant授权命令4. DN账号只需要只读权限，如无权限，可执行以下赋权命令：   create user test identified by 'Root2023!';   GRANT SELECT, PROCESS, SHOW VIEW ON *.* TO test@'%'5. 重复上面步骤登录所有LEADER NODE创建账号与赋权，gms节点不需要赋权。

b）页面纳管PolarDB-X 分布式版数据库实例

点击“实例纳管”按钮后，在类型下拉框中选中"PolarDB 分布式"引擎类型；
填写数据库的访问地址、账号以及密码等基本信息;
点击"check"按钮，检查实例数据库是否连接正常，检查通过则会在纳管界面展示所有的node信息；
录入node所在主机的账号信息，默认自动安装Agent。注意：开启拓扑自适应后，DBdoctor Server可动态纳管扩展的集群节点；

连通性检测通过后，点击提交后即可成功纳管PolarDB 分布式版数据库。在实例列表界面，可以看到已纳管的PolarDB 分布式数据库实例信息。

重点说明：

a）PolarDB集群资源使用率及业务流量

如采集方式选择“部署Agent”方式，DBdoctor会自动对cluster集群下的所有node节点进行Agent安装，并展示该cluster集群的整体资源使用率及业务流量情况，同时针对每个node节点也可查看详细的资源使用率及业务流量。

b）自动感知集群的节点拓扑变化并进行管理

当开启“拓扑自适应”功能后，DBdoctor能够自动感知集群的节点拓扑变化，节点有扩增时可自动纳管，当节点被删除时也会自动移除并持续监控其状态。通过这种自动化管理和监控能力，可显著减少人工操作，降低了数据库管理成本，提升了运维效率和系统稳定性。

c）提供分布式架构下的监控与诊断能力

DBdoctor 不仅可监控用户提交的原始 SQL，而且还能精准采集经过协调节点（CN）拆分后下发到各 DN 执行的具体 SQL 语句。通过性能洞察，我们能够迅速掌握SQL集群的整体资源消耗情况，并清晰地观察到每个分片节点的SQL执行细节。此外，还能实时揭示是否存在热点问题或数据倾斜等导致集群数据库产生性能问题。

二.针对PolarDB-X分布式版数据库，DBdoctor提供哪些功能服务

当前DBdoctor 适配PolarDB-X分布式 2.x版本，并提供SQL审核、AI-SQL改写、性能洞察、锁透视（分布式锁）、根因诊断、慢SQL治理、索引推荐、实例巡检、基础监控、数据安全等功能服务。

1.SQL审核

SQL审核提供对SQL从开发到运维的全生命周期质量管理：

1）开发审核：包含快速审核、IDE审核、CICD审核、代码仓审核，可以帮助开发人员从代码编写、代码提交等多个维度检查SQL的规范性，实现SQL全流程管理。

2）生产审核：包含慢SQL审核、库表元数据审核，可以帮助运维人员快速发现问题SQL并能发起工单进行跟踪处理，可有效提升生产系统的稳定性。

2 AI-SQL改写

AI-SQL改写引擎结合大语言模型能力，能够深入理解业务语义和执行上下文，准确把握SQL的应用场景和目标。内嵌自研SQL审核引擎，依据规则进行严格的合规与性能审查，确保改写后的SQL既符合最佳实践，又能提升性能。接入自研Cost优化器，从成本效益的角度出发，自动评估并选择成本最优的SQL写法。

3.性能洞察

通过数学模型精准定位,打破基于经验、规则、阈值诊断的传统,真正实现单条SQL资源量化,把资源消耗映射为颜色面积,直观定位数据库性能问题并给出优化建议（比如索引推荐）。包含资源使用率、业务流量、Average Active Session(AAS即平均活跃会话)曲线，同屏展示三者的关联关系，三步即可快速定位性能问题。