概述
CTSDB（腾讯云时序数据库）与 InfluxDB 均为面向时序场景的数据库，支持海量时间序列数据的高效写入与查询，广泛用于监控、物联网等场景。DataBuddy 数据接入支持将 CTSDB / InfluxDB 作为来源端，覆盖离线同步场景。本文介绍其连接配置、能力支持范围、前提条件与常见问题。
支持的版本
类型 | 支持版本 |
InfluxDB | 2.5 / 2.6 / 2.7 |
读取能力
能力 | 支持情况 | 说明 |
离线同步（读 / 写） | ✓ / - | 支持作为离线同步任务的源端读取数据；DataBuddy 数据源仅支持接入读取，不支持写入 |
使用限制
限制项 | 说明 |
数据模型 | 以数据库（Database）/ 测量（Measurement）为读取粒度 |
时序语义 | 读取时需关注时间戳字段与标签（Tag）字段 |
支持的字段类型
字段类型 | 说明 |
timestamp | 时间戳 |
integer | 整数 |
float | 浮点数 |
string | 字符串 |
boolean | 布尔 |
前提条件
配置账号权限
CREATE USER wedata_user WITH PASSWORD 'your_password' WITH ALL PRIVILEGES;GRANT READ ON your_database TO wedata_user;
建议为同步任务创建专用账号，仅授
READ 权限。创建数据源
操作步骤
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标地域和 Workspace。
3. 进入 数据集成 > 数据源管理（或 平台管理 > 数据源管理）。
4. 点击 添加数据源，选择 CTSDB / InfluxDB。
5. 填写连接配置与认证信息，详见 参数说明。
6. 点击 连通性测试（参见 数据源连通性测试）。
7. 测试通过后点击 保存 或 保存 & 创建任务。
参数说明
参数 | 说明 | 是否必填 | 默认值 |
数据源名称 | 数据源在工作空间内的唯一标识 | 是 | — |
连接地址 | 数据库服务地址，格式 http://host:port | 是 | — |
用户名 | 数据库连接账号 | 是 | — |
密码 | 数据库连接密码（支持 SSM 凭证托管） | 是 | — |
连接地址示例：
http://10.0.0.1:8086
在数据接入任务中使用
离线单表
配置项 | 说明 |
数据来源 | 已配置的 CTSDB / InfluxDB 数据源 |
库 / 测量 | 从列表中选择数据库与测量（Measurement） |
查询条件 | 支持按时间范围等条件过滤 |
最佳实践
实践 | 建议 |
账号权限最小化 | 为同步任务创建专用账号，仅授 READ 权限 |
时间范围 | 按时间窗口分批读取，避免一次性拉取过大数据量 |
网络打通 | 优先使用内网连接，提升传输性能 |
常见问题
Q：连接超时或被拒绝？
A：检查连接地址与端口可达性，确认账号密码正确。
Q：读取数据不完整？
A：确认目标测量（Measurement）存在且账号具备读取权限。
