使用 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);