接入与操作故障
无法连接集群怎么办？
- 确认集群状态为“运行中”。
- 确认使用集群详情页显示的连接地址和服务端口，没有自行使用其他端口。
- 内网连接时检查客户端与集群 VPC 的网络可达性。
- 公网连接时确认 EIP 已绑定且公网访问状态正常。
- 使用
curl或tsdb-cli进行最小请求验证，并保存错误状态码。
是否支持 HTTPS / TLS 访问？
当前数据访问入口仅提供明文 HTTP，不支持 HTTPS / TLS。公网访问时访问令牌和数据都以明文传输，请严格控制访问来源并使用最小权限业务访问令牌；安全要求高的场景建议使用 VPC 内网访问。
为什么返回 401？
请求缺少有效令牌。检查 Authorization 头、环境变量和令牌是否完整；确认管理员令牌没有被重置，业务令牌没有被重新生成、删除或过期。
为什么返回 403？
令牌有效，但对目标数据库或表没有所需权限。使用管理员令牌查看业务令牌的授权范围；需要调整权限时，请重新生成该令牌并在业务中替换旧令牌，或创建具有所需最小权限的新令牌。重新生成后，旧令牌立即失效。
使用 SDK 写入时提示接口不存在，应该如何处理？
TSDB 专享版使用 V3 写入接口。请对照所使用语言的 SDK 使用文档，检查初始化客户端时是否完整保留了示例中的 V3 写入配置。不同 SDK 的参数名称和配置结构不同，请以对应语言文档中的完整示例为准。缺少这项配置时，SDK 可能调用 TSDB 专享版不提供的写入接口。
TSDB 专享版支持哪些查询语言？
仅支持标准 SQL 查询，包括 HTTP SQL 和 Flight SQL 两种接入方式。写入使用 Line Protocol。完整语法和函数见SQL 查询语言参考。
创建或重新生成 Token 后，为什么看不到原明文？
Token 明文只在创建或重新生成响应中返回一次，之后列表只展示名称、权限和元数据。明文丢失时需要重新生成；重新生成后旧 Token 立即失效。
写入返回部分失败怎么办？
默认写入可以接受部分成功。请解析响应中的失败行，确认已成功和未成功的范围，只重试失败数据。需要整批拒绝时，使用 HTTP API 并设置 accept_partial=false。
首次写入新的 measurement 后，为什么立即查询不到？
首次向新的 measurement 写入数据时，服务端会自动创建对应的 Table，新表通常在约 5 秒后可以查询，实际时间可能受集群运行状态影响。建议首次写入后等待约 5 秒再执行首次查询。该等待只适用于首次写入创建 Table 的场景；向已有 Table 写入不受影响。
到期停服和主动释放集群后，数据分别保留多久？
包年包月集群到期或欠费停服后，资源保留 30 天，保留期内完成续费或结清欠费即可恢复服务，数据不受影响；超过 30 天仍未处理时，计费侧会触发资源删除，数据无法恢复。主动释放集群没有保留期，释放受理后数据立即开始清理且无法恢复，请勿把释放作为临时停机手段。
集群操作失败后是否可以直接重试？
不要盲目重试创建、变配、升级或释放操作。如果请求未被接受，请保留 HTTP 状态码、错误码、错误信息和 requestId；如果请求已经生成操作记录，请先查看集群状态和操作进度，并保留操作记录 ID、操作类型、提交时间以及目标配置或版本。确认操作结果后，再决定是否重试或提交工单。提交工单时请勿附带访问令牌。
评价此篇文章