管理 Database 与 Retention
更新时间:2026-07-24
以下命令需要具有相应管理权限的访问令牌。
Database
Bash
1# 创建数据库,并设置 30 天保留期
2tsdb-cli database create --retention-period 30d mydb
3
4# 列出当前令牌可见的数据库
5tsdb-cli database list
6
7# 更新为 7 天保留期
8tsdb-cli database update --retention-period 7d mydb
9
10# 清除数据库的显式保留期
11tsdb-cli database update --retention-period none mydb
12
13# 删除数据库
14tsdb-cli database delete mydb
--retention-period 接受时长字符串,支持小时(h)、天(d)、周(w)、月(mo)和年(y)的组合,例如 30d、2w3d、1y6mo;none 表示清除显式设置。
删除数据库会删除其下的数据和表。CLI 会要求输入 yes 交互确认,不提供跳过确认的参数;自动化流程中需要无交互删除时,请使用数据库资源管理 API,并在调用前校验目标名称和环境。
Retention
Bash
1# 列出当前令牌可见的全部 Retention
2tsdb-cli retention list
3
4# 只查看指定数据库
5tsdb-cli retention list -d mydb
6
7# 输出 JSON
8tsdb-cli retention list --format json
缩短保留期可能使更早的数据进入删除范围。生产环境修改前请确认数据保留和合规要求。
评价此篇文章
