首頁(yè)
時(shí)間序列數(shù)據(jù)庫(kù) TSDB
時(shí)間序列數(shù)據(jù)庫(kù) TSDB(文檔停止維護(hù))
HTTP API 參考
設(shè)置數(shù)據(jù)時(shí)效
設(shè)置數(shù)據(jù)時(shí)效
更新時(shí)間:
設(shè)置數(shù)據(jù)時(shí)效
請(qǐng)求路徑和方法
請(qǐng)求路徑 | 請(qǐng)求方法 | 描述 |
---|---|---|
/api/ttl | POST | 設(shè)置 TTL |
請(qǐng)求內(nèi)容
名稱(chēng) | 類(lèi)型 | 是否必需 | 描述 | 舉例 |
---|---|---|---|---|
val | Integer | 是 | 設(shè)置 ttl 的值,以秒為單位,大于等于1,小于等于2147483647(Integer.MAX_VALUE) 高可用版本中允許設(shè)置的最小值為3600,設(shè)置小于3600的值會(huì)報(bào)錯(cuò); 允許設(shè)置的最大值為2147483647,表示的含義為”無(wú)數(shù)據(jù)時(shí)效”,設(shè)置超過(guò)2147483647的值仍然會(huì)被視作2147483647. |
7776000 |
請(qǐng)求 JSON 示例
任務(wù):設(shè)置數(shù)據(jù)時(shí)效為 90 天
請(qǐng)求: POST/api/ttl
請(qǐng)求體:
{ "val": 7776000 }
響應(yīng)說(shuō)明
200 表示成功,其他返回碼表示失敗,錯(cuò)誤信息參見(jiàn)公共響應(yīng)狀態(tài)碼。
數(shù)據(jù)時(shí)效說(shuō)明
- 此處設(shè)置的數(shù)據(jù)時(shí)效的計(jì)算不是對(duì)數(shù)據(jù)自身帶入的時(shí)間戳為基準(zhǔn)進(jìn)行計(jì)算,而是基于數(shù)據(jù)實(shí)際寫(xiě)入到數(shù)據(jù)庫(kù)的時(shí)間為基準(zhǔn)進(jìn)行計(jì)算。
- 數(shù)據(jù)在數(shù)據(jù)庫(kù)中的時(shí)間超過(guò)設(shè)置的數(shù)據(jù)時(shí)效后并不會(huì)立刻失效,而是會(huì)由數(shù)據(jù)庫(kù)后臺(tái)慢慢自行清理。
- 數(shù)據(jù)失效時(shí),數(shù)據(jù)所屬的時(shí)間線并不會(huì)隨之失效。對(duì)于早已不活躍的時(shí)間線可能需要主動(dòng)調(diào)用刪除接口進(jìn)行清理。
獲取數(shù)據(jù)時(shí)效
請(qǐng)求路徑和方法
請(qǐng)求路徑 | 請(qǐng)求方法 | 描述 |
---|---|---|
/api/ttl | GET | 查詢(xún)數(shù)據(jù)時(shí)效 |
請(qǐng)求內(nèi)容
無(wú)需請(qǐng)求實(shí)體
響應(yīng)說(shuō)明
200 表示成功,其他返回碼表示失敗,錯(cuò)誤信息參見(jiàn)公共響應(yīng)狀態(tài)碼。
返回 JSON 舉例:
{ "val": 7776000 }
val 的值即為 ttl 的值,秒為單位。
文檔內(nèi)容是否對(duì)您有幫助?