概述
添加数据源连接（Connection）后，您才能在数据接入任务、外部 Catalog 等场景中引用该数据源。本文介绍如何在 DataBuddy 中创建数据源连接、配置认证信息、设置高级参数，并完成保存与下一步操作。
前提条件
在开始本操作前，请确保满足以下条件：
已开通 DataBuddy 服务并完成空间初始化。
当前账号在目标 Workspace 中拥有 数据源创建 相关角色（详见 成员与权限管理）。
已确认目标数据源的访问地址、端口、用户名、密码或其他认证凭据可用。
如需通过腾讯云实例方式接入（如腾讯云 MySQL、CKafka、TCHouse 系列），请确认对应实例与 DataBuddy 处于网络可达的地域。
如需使用 SSM 凭证托管密码，请提前在腾讯云 凭据管理服务 中创建凭证。
使用限制
限制项 | 说明 |
支持的数据源类型 | 详见 支持的数据源与读写能力 |
数据源名称 | 与 Catalog 命名规则一致；同一工作空间内不允许重名 |
凭证管理 | 密码类字段支持普通密码与 SSM 托管两种方式 |
编辑限制 | 编辑数据源时不允许切换数据源类型 |
操作步骤
下面以 TDSQL-C MySQL 接入为例，说明如何创建和修改数据源。
步骤 1：进入数据源列表
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标地域和 Workspace。
3. 通过以下任一入口进入数据源列表：
入口 | 路径 |
数据集成入口 | 进入 数据集成 模块，确认在接入方式 Tab，在「连接器」部分，点击 数据源管理 。 |
全局数据源管理 | 平台管理 > 数据源 |
步骤 2：选择数据源类型
1. 点击 创建数据源 。
2. 在数据源类型下拉框中选择 TDSQL-C MySQL。
步骤 3：配置连接信息
进入连接设置页面，按以下顺序填写：
1. 数据源名称 ：必填。
2. 如所选数据源支持多种连接方式（具体支持的连接方式见界面展示），选择连接方式 ：
串连接 ：手动输入 JDBC URL、服务列表或主机端口等。
腾讯云实例 ：选择地域和实例。
1. 连接信息 ，以串连接为例：
JDBC URL ：必填，如 「jdbc:mysql://168.0.0.1:3306/db_name」,请确保 URL 格式正确。
数据源版本 ：必填，如 「8.0.x」表示支持 8.0 的所有版本,因数据源驱动版本较多，这里可选择最接近的版本。
步骤 4：配置认证信息
1. 选择该数据源支持的 认证方式 （用户名密码 / SSH 密钥 / Kerberos / OAuth 2.0 / SAS / SecretId+SecretKey 等），如该数据源只支持一种认证，则会直接展开该认证的配置，如 mysql 只支持用户名&密码，则只显示用户名输入和密码输入。
2. 填写对应的认证字段：
用户名 ：填写 TDSQL-C MySQL 数据库的用户名，我们强烈建议你在创建连接前，先在数据库里创建一个专用账户，以便控制最终的数据权限。
密码 ： 支持普通密码和 SSM 托管，普通密码输入密码即可，在编辑时，不允许查看之前设置的密码，但可以修改。
SSM 托管 ：如您的密码托管在 SSM，则可以切换到「从 SSM 获取」，填写 地域 、凭证名称 、凭证版本 ，由 DataBuddy 在使用时动态获取实际值；需要注意，SSM 提供自定义凭证和数据库凭证两种模式，wedata 仅支持自定义凭证模式。
1. 如数据源支持其他认证，请参考界面提示完整配置。
步骤 5：（可选）配置高级参数
部分数据源（如 MySQL、PostgreSQL、Hive、MongoDB 等）支持在 高级设置 中配置扩展参数，具体拓展参数请见各数据源官方说明，该参数将拼接到 JDBC URL 后面，如
?param1=value1¶m2=value2。步骤 6：连通性测试
1. 在页面下方点击 测试连通性 。
2. 等待连通性测试结果（详见 数据源连通性测试）。
3. 如测试失败，根据返回的失败原因调整连接、认证字段，再次测试直至成功。
注意
连通性测试仅验证当前的网络可达性与认证有效性，不会校验目标库表是否存在。任务运行时如目标库表权限或环境发生变化，仍可能失败。
步骤 7：保存数据源
按使用场景选择以下任一保存方式：
创建并接入数据 ：创建数据源并跳转到接入任务创建页，将该数据源作为来源端（推荐首次创建后使用）。
仅创建：仅创建该数据源，允许用户稍后去创建同步任务。
保存成功后会出现成功提示；保存失败时会提示具体失败原因。
验证结果
数据源创建成功后，您可以通过以下方式确认：
1. 在数据源列表中可以看到刚创建的数据源，类型、名称、负责人显示正确。
2. 点击数据源名称进入详情页，概览 中信息与所填一致；关联任务 列表初始为空。
3. 在创建数据接入任务时，所选数据源类型对应的 数据源连接 下拉列表中包含该数据源连接名称。
编辑与删除数据源
操作 | 入口 | 说明 |
编辑 | 列表页操作列 编辑 ； | 不允许切换数据源类型；其他字段保存即生效，当你编辑数据源前，请确认操作不会影响现有任务 |
删除 | 列表页操作列 删除 ； | 操作不可恢复，当你删除数据源前，请确认操作不会影响现有任务 |
警告
删除数据源前，请先在详情页 关联任务 标签确认是否仍有任务依赖该数据源。删除后，依赖该数据源的同步任务运行时会报错「数据源连接异常：数据源不存在或当前账号无数据源访问权限」。
常见问题
Q：不同数据源类型的字段差异较大，应该到哪里查看完整字段说明？
A：详见前端界面显示。
Q：密码字段是否必须使用 SSM 托管？
A：不是。普通密码模式直接输入即可使用；如有合规或集中凭证管理需求，建议改用 SSM 托管，避免密码以明文形式留在数据源配置中。
Q：修改了数据源信息后，为什么任务还是使用的旧连接数据？
A：主要发生在实时任务场景，实时任务一旦启动，运行信息不发生变动，除非重启才会更新运行信息， 因此请停止实时任务后重启；离线任务在每次调度时会自动更新数据源信息。
Q：保存数据源时提示连通性失败，是否会阻塞保存？
A：不会。连通性测试与保存是两个独立操作，您可以先保存数据源再排查连通性问题。但建议保存前完成测试，避免后续任务运行失败。
