一、概述
连通性测试 通过指定的 计算资源 向数据源发起测试连接，用于验证数据源的连接信息（地址、端口、认证）是否正确，以及计算资源的网络环境是否可达数据源。
DataBuddy 中所有依赖数据源的功能（数据接入、外部 Catalog、联邦分析等）实际上都通过计算资源访问数据源，因此连通性测试的结果代表任务实际运行时的网络可达性 ，比独立的网络 ping 更具参考价值。
二、前提条件
在开始本操作前，请确保满足以下条件：
·已在数据源创建、编辑面板中填写完整的连接信息和认证信息（详见 全局数据源配置）。
·当前工作空间内至少有一个 运行中 的计算资源。
·如果数据源位于用户私有 VPC 内，请先完成 计算资源网络设置 中的出站 VPC 打通 配置，否则测试一定会失败。
·当前账号在目标工作空间中对该数据源拥有 可使用 或更高权限（详见 成员与权限管理）。
三、使用限制
| 限制项 | 说明 |
| 必须选择计算资源 | 连通性测试不能脱离计算资源单独执行；如果工作空间内没有任何计算资源，请先 创建计算资源 |
| 检测内容 | 仅校验网络可达性与认证有效性，不校验目标库表是否存在或是否有读写权限 |
| 测试结果不持久化 | 连通性测试的结果不会保存到数据源详情页中，仅作为创建 / 编辑过程的实时反馈 |
| 测试不影响数据源状态 | 测试失败不会阻止数据源保存。你可以保存数据源后再排查网络问题 |
| 单次测试时长 | 测试过程为同步操作，根据数据源响应速度，通常在数秒至十数秒内完成 |
四、步骤 1：在数据源创建、编辑页发起测试
1. 进入数据源创建或编辑面板。
2. 在面板底部展开 连通性测试 区域。
3. 选择一个或多个计算资源。
4. 点击 测试连通性 。
5. 测试执行期间，按钮变为加载状态。测试完成后展示结果：
·连接成功 ：弹层提示连接成功 。
·连接失败 ：弹层提示连接失败：${错误原因} 。
6. 关闭弹层即可继续完善其他配置或保存数据源。
注意：说明：
注意：连通性测试可以在保存数据源前重复执行多次，不会影响数据源本身的状态。建议保存前至少做一次连通性测试，以确保任务运行时不会因连接错误而失败。
五、步骤 2：在数据接入任务的来源、目标设置中发起测试
在数据接入任务的来源设置或目标设置中，选择已存在的数据源连接后，平台会自动发起一次连通性测试：
1. 在 来源 & 目标选择 > 源端 中选择源连接 。
2. 连接选项下方显示待测试，点击测试 开始测试连通性。
3. 如连通成功，提示连通成功 ；如连通失败，则提示连通失败及原因。
4. 点击重试 可重新触发连通性测试。
六、步骤 3：根据测试结果调整配置
| 测试结果 | 处理建议 |
| 连通成功 | 提示连接成功 ；可继续保存数据源或进入下一步任务配置 |
| 连通失败 | 提示连接失败：${失败原因} ； |
针对连通失败的常见处理参见 常见问题。
七、验证结果
成功完成连通性测试后，你可以观察到以下变化：
1. 数据源创建、编辑页：测试按钮下方出现连接成功：连接到 ${连接地址} 提示。
2. 同步任务来源、目标设置：所选数据源旁出现 连通成功 标签。
八、常见的失败原因
| 失败原因 | 排查方向 |
| 网络不可达 | 数据源位于用户私有 VPC 中，但所选计算资源未与该 VPC 打通。请前往 计算资源网络设置 添加 VPC 出站连接 |
| 公网 IP 未放白名单 | 数据源限制了 IP 白名单，但所选计算资源的出口 IP 不在白名单中。请使用计算资源的固定出口 IP，并在数据源侧加入白名单 |
| 认证信息错误 | 用户名 / 密码 / 密钥不正确，或 SSM 凭据已被删除 / 过期 |
| 数据源版本不匹配 | 数据源版本字段填写与实际数据源版本不一致（如 MySQL 5.6 数据库选择了 8.0 版本） |
| 数据源服务未启动 | 数据源所在的服务进程未启动或处于维护中 |
九、与计算资源的关系
连通性测试 = 计算资源 × 数据源 ：测试结果不仅反映数据源本身是否可达，也反映所选计算资源到数据源的网络可达性。同一个数据源在不同计算资源下的测试结果可能不同。
| 场景 | 适用配置 |
| 数据源在腾讯云内网（如腾讯云 RDS） | 任意运行中的计算资源即可 |
| 数据源在用户私有 VPC | 需先在计算资源 网络设置 中打通对应 VPC |
| 数据源在本地 IDC 或第三方云 | 需通过腾讯云 VPN / 专线先与腾讯云 VPC 打通，再做计算资源网络设置 |
| 数据源开放在公网（带 IP 白名单） | 需将计算资源的固定出口 IP 加入数据源侧白名单 |
十、Q1：连通性测试成功，但实际任务运行时仍报「连接失败」
请确认任务运行时使用的计算资源与连通性测试时选择的计算资源一致。如果不同，可能因为运行时计算资源未与数据源 VPC 打通，请重新做网络设置。
十一、Q2：如何让数据源在多个计算资源上都可达？
每个需要访问该数据源的计算资源都应单独完成 网络设置 中的 VPC 出站配置。建议在团队内统一规划计算资源池，避免每次新建计算资源都要重做网络打通。
十二、Q3：连通性测试不支持哪些数据源？
部分数据源（如内置 DataBuddy 数据源）作为系统预置源，不需要也不支持连通性测试；其他所有用户自定义的数据源都支持。
十三、Q4：测试连接失败，提示「Access denied / 认证失败」
可能原因 ：
·用户名或密码不正确。
·SSM 凭证名称或版本号错误，导致动态获取的密码与实际不符。
·Kerberos keytab 与 principal 不匹配。
解决方法 ：
1. 核对账号、密码是否正确，必要时直接在客户端工具（如 mysql、psql、ftp）验证。
2. 如使用 SSM 托管，确认凭证名称、版本号在腾讯云 凭据管理服务 中存在且未禁用。
3. 如使用 Kerberos，确认 keytab 与 principal 由同一 KDC 颁发，且 conf 中的 realm、KDC 与目标系统一致。
十四、Q5：测试通过后实际任务仍然失败，是否常见？
可能原因 ：
·任务运行账号与测试账号不同（实时同步以「负责人」身份运行）。
·库、表、主题不存在或没有相应读写权限。
·任务运行时网络发生变化（如对端服务下线、IP 变更）。
解决方法 ：
1. 在数据源详情页确认 责任人 与运行身份的一致性。
2. 核对库表、Topic、Volume 等是否存在。
3. 在任务运维监控中查看运行日志定位具体异常。
十五、Q6：是否可以通过 API 触发连通性测试？
A：开放 API 能力待补充。
十六、相关文档
·全局数据源配置
·添加数据源连接
·计算资源网络设置
·创建计算资源
·成员与权限管理