一、读取能力
| 能力 | 支持情况 | 说明 |
| 离线同步（读 / 写） | ✓ / – | 支持作为离线同步任务的源端读取数据；DataBuddy 数据源仅支持接入读取，不支持写入 |
完整数据源能力对照参见 支持的数据源与读取能力。
二、使用限制
| 限制项 | 说明 |
| 协议 | 支持 SMB / CIFS |
| 读取对象 | 以目录或文件为粒度读取 |
三、支持的文件格式
| 格式 | 说明 |
| Text / CSV | 文本与逗号分隔文件 |
| JSON | JSON 格式文件 |
四、前提条件
在文件服务器上创建专用账号，并授予目标共享目录的读取权限。
五、操作步骤
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标地域和 Workspace。
3. 进入 数据集成 > 数据源管理（或 平台管理 > 数据源管理）。
4. 点击 添加数据源，选择 File System。
5. 填写连接配置与认证信息，详见 参数说明。
6. 点击 连通性测试（参见 数据源连通性测试）。
7. 测试通过后点击 保存 或 保存 & 创建任务。
六、参数说明
| 参数 | 说明 | 是否必填 | 默认值 |
| 数据源名称 | 数据源在工作空间内的唯一标识 | 是 | — |
| 共享地址（SMB URL） | 网络共享地址，格式 smb://host/share | 是 | — |
| 用户名 | 文件服务器登录账号 | 是 | — |
| 密码 | 登录密码（支持 SSM 凭证托管） | 是 | — |
SMB URL 示例：
smb://10.0.0.1/data
七、离线文件读取
| 配置项 | 说明 |
| 数据来源 | 已配置的 File System 数据源 |
| 读取路径 | 目标目录或文件路径，支持通配符 |
| 文件格式 | 选择 Text / CSV / JSON 等 |
详细任务配置参见 文件到表同步。
八、最佳实践
| 实践 | 建议 |
| 账号最小化 | 为同步任务创建专用账号 |
| 目录规划 | 按日期分区组织目录，便于增量同步 |
| 网络打通 | 确保与文件服务器网络连通 |
九、Q：连接超时或被拒绝？
A：检查共享地址、账号密码与网络连通性。
十、Q：读取不到文件？
A：确认读取路径正确，且账号具备目标共享目录的读取权限。
十一、相关文档
·添加数据源连接
·数据源连通性测试
·支持的数据源与读取能力