使用 SDK 前必须先创建 TSDB 客户端。TSDB 对象是一个可用的客户端对象,线程安全。本文将介绍如何使用 TSDB 类创建 TSDB 对象,即 TSDB 客户端。

建议: 使用 TSDB SDK 之前,建议您先阅读名词解释 和《HTTP API 参考》对 TSDB 的基本概念和 API 的使用说明进行了解。

TSDB 类是 TSDB 客户端的操作类。对 TSDB 的读写及其他操作,都需要用该类的对象进行。

创建TSDB类对象需要使用以下两个类:

  • HiTSDBConfig 类:TSDB 客户端的基础配置类。
  • HiTSDBClientFactory 类:TSDB 类的工厂类。

通过 HiTSDBConfig 类进行配置,然后放入 HiTSDBClientFactory 类的 connect 方法中即可产生一个 TSDB 对象。

注意:在创建 TSDB 对象前,需要先创建 HiTSDBConfig 对象。

示例代码

// 为 HiTSDBConfig 配置参数,并创建HiTSDBConfig实例。
// example.hitsdb.com 表示域名或地址。8242 表示 HiTSBD 的网络端口。您实际的域名地址和网络端口可到控制台获取。
// tsdbuser和password 表示用于用户认证的用户名和密码。TSDB用户可在实例管理控制台创建。如果实例未启用用户鉴权功能,则创建Config对象时无需调用basicAuth()方法
HiTSDBConfig config = HiTSDBConfig.address("example.hitsdb.com",8242).basicAuth("tsdbuser", "password").config();

// 通过 HiTSDBClientFactory 生成一个 HiTSDB 对象。
HiTSDB tsdb = HiTSDBClientFactory.connect(config);