全部产品
云市场
云游戏

TSDB 2.0应用开发概览

更新时间:2020-01-02 21:40:43

TSDB 2.0提供了以SQL为基础的编程接口,方便用户按照传统关系型数据库的方式来编写业务应用。而且TSDB 2.0在通信协议上兼容了PostgreSQL的 前后端通信协议, 用户可以基于支持PostgreSQL的数据库驱动程序或者其他客户端程序访问TSDB 2.0

目前,用户开发应用程序时可以用于访问TSDB 2.0的数据库驱动列在下方:

编程语言 驱动名称 项目地址 说明
Java PostgreSQL JDBC Driver https://jdbc.postgresql.org/ 社区提供技术支持的原生JDBC驱动。用于访问TSDB 2.0时推荐使用42.2.4 以上版本
Go Pgx https://github.com/jackc/pgx 第三方个人开源组件

开发应用程序时可用的SQL详细,请参见SQL参考

此外,为了向下兼容 TSDB 1.0的行为,TSDB 2.0还提供了一套兼容 TSDB 1.0的HTTP 接口,可以方便地让用户将基于TSDB 1.0构建的应用迁移至 TSDB 2.0 。但是目前提供的接口尚未完全覆盖原有的 TSDB 1.0的全部接口,以实现支持的 TSDB 1.0接口包括以下接口

API接口 作用
api/put 单值数据写入
api/query 单值数据查询
api/query/last 单值数据最新值查询
api/suggest 查询 Metric,Tagk,Tagv
api/ttl 设置数据时效
api/truncate 清空数据
api/search/lookup 检索元数据

各个API在 TSDB 2.0上详细的定义,请参见 API参考

⚠️ 使用上述兼容TSDB 1.0的HTTP API时,只能操作基于 api/put 写入的数据。无法操作通过SQL写入的数据;且通过 api/put 写入的数据无法用SQL进行查询