TSDB 专享版从用户视角分为集群管理和数据访问两类能力：集群管理用于创建和维护专享资源，数据访问用于管理数据库资源以及写入和查询时序数据。

集群的时序数据存储在托管的对象存储中，存储容量不受集群节点规格限制，按实际用量付费。

您可以在 TSDB 监控页面查看集群运行指标。

资源关系

TSDB 专享版以集群为计算资源边界。一个集群包含多个数据库；数据库包含表；应用通过访问令牌连接集群并读写被授权的数据库或表。

关键概念

概念	说明
集群	TSDB 专享版的计算资源和生命周期管理单元。
数据库（Database）	数据和权限的主要组织边界。应用写入和查询时需要指定目标数据库。
表（Table）	同一类时序数据的集合。Line Protocol 中的 measurement 对应表。
时间戳	每条时序数据对应的时间。写入时可以指定时间戳和精度。
Tag	用于描述和筛选数据的维度，适合保存主机、地域、设备等可枚举属性；同一组 Tag 取值对应一条序列（时间线）。
Field	随时间变化的业务值，例如温度、负载或计数。
Retention	数据保留策略。可以在数据库或表级设置；表级设置覆盖数据库级设置。
管理员访问令牌	集群初始化和恢复访问所用的高权限访问令牌，通过控制台或集群生命周期 OpenAPI 获取或重置。
业务访问令牌	面向应用创建的命名访问令牌，可以按数据库或表授予最小权限。
连接地址	应用访问集群数据接口的地址。以内网地址为默认接入方式；启用公网访问后可使用公网地址。

管理能力与数据访问边界

操作	推荐入口	使用的凭证
创建、查看、变配、升级或释放集群	Console 或集群生命周期 OpenAPI	百度智能云账号；调用 OpenAPI 时使用该账号的 AK/SK
获取或重置管理员访问令牌	Console 或集群生命周期 OpenAPI	百度智能云账号；调用 OpenAPI 时使用该账号的 AK/SK
管理 Database、Table、Retention 和业务访问令牌	tsdb-cli；程序化集成时使用数据库资源管理 API	具备相应管理权限的访问令牌
写入和查询时序数据	本文档列出的开源 SDK、数据读写 API 或 tsdb-cli	具备目标数据库或表权限的业务访问令牌
查看运行指标	TSDB 监控页面	百度智能云账号

数据库资源管理能力当前不提供管理 SDK。日常管理 Database、Table、Retention 和业务访问令牌时，推荐使用 tsdb-cli；需要将管理操作集成到自有程序中时，可以调用数据库资源管理 V3 API。开源 InfluxDB 3 SDK 用于数据写入和查询。

访问令牌分工

管理员访问令牌和业务访问令牌用途不同：

1. 首次进入集群时，使用管理员访问令牌创建数据库和业务访问令牌。
2. 按应用或职责分别创建业务访问令牌，并只授予必要的数据库或表权限。
3. 应用使用业务访问令牌执行写入或查询，不建议长期使用管理员访问令牌。
4. 创建或重新生成访问令牌时，明文只返回一次，请立即安全保存。
5. 重置管理员访问令牌或重新生成业务访问令牌后，旧访问令牌立即失效，请提前规划应用切换。

API 边界

• 集群生命周期 OpenAPI：管理集群、规格、扩缩容、升级、公网访问、操作记录和管理员访问令牌。
• 数据读写 API：写入 Line Protocol、执行 HTTP SQL 或 Flight SQL 查询。
• 数据库资源管理 API：供程序调用以管理 Database、Table、Retention 和业务访问令牌。