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

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

TSDB类

TSDB 类是时序引擎客户端的操作类。对时序引擎的读写及其他操作,都需要用该类的对象进行。创建TSDB类对象需要使用以下两个类:

  • TSDBConfig 类:时序引擎客户端的基础配置类
  • TSDBClientFactory 类:TSDB 类的工厂类

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

说明 在创建 TSDB 对象前,需要先创建 TSDBConfig 对象。

创建TSDB对象

// 为 TSDBConfig 配置参数,并创建TSDBConfig实例。
// example.tsdb.com 表示域名或地址。8242 表示 TSBD 的网络端口。您实际的域名地址和网络端口可到控制台获取。

TSDBConfig config = TSDBConfig.address("example.tsdb.com",8242).config();
// 通过 TSDBClientFactory 生成一个 TSDB 对象。
TSDB tsdb = TSDBClientFactory.connect(config);