创建TsdbClient

更新时间：2025-08-22

用户可以参考如下代码新建一个TsdbClient：

HTTP Client

Plain Text

1String ACCESS_KEY_ID = <your-access-key-id>;               // 用户的Access Key ID
2String SECRET_ACCESS_KEY = <your-secret-access-key>;       // 用户的Secret Access Key
3String ENDPOINT = <your-tsdb-database-endpoint>;           // 用户的时序数据库域名，形式如databasename.tsdb.iot.gz.baidubce.com
4 
5// 创建配置
6BceClientConfiguration config = new BceClientConfiguration()
7                .withCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY))
8                .withEndpoint(ENDPOINT);
9 
10// 初始化一个TsdbClient
11TsdbClient tsdbClient = new TsdbClient(config);

HTTPS Client

Plain Text

1String ACCESS_KEY_ID = <your-access-key-id>;               // 用户的Access Key ID
2String SECRET_ACCESS_KEY = <your-secret-access-key>;       // 用户的Secret Access Key
3String ENDPOINT = <your-tsdb-database-endpoint>;           // 用户的时序数据库域名，形式如databasename.tsdb.iot.gz.baidubce.com
4 
5// 创建配置
6BceClientConfiguration config = new BceClientConfiguration()
7                .withProtocol(Protocol.HTTPS)              // 使用HTTPS协议;不设置，默认使用HTTP协议
8                .withCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY))
9                .withEndpoint(ENDPOINT);
10 
11// 初始化一个TsdbClient
12TsdbClient tsdbClient = new TsdbClient(config);

在上面代码中，变量ACCESS_KEY_ID与SECRET_ACCESS_KEY是由系统分配给用户的，均为字符串，用于标识用户，为访问TSDB做签名验证。其中ACCESS_KEY_ID对应控制台中的“Access Key ID”，SECRET_ACCESS_KEY对应控制台中的“Access Key Secret”，获取方式请参考获取AK/SK。

通过IP访问

在一些场景下比如正向代理，无法采用域名直接访问tsdb，java sdk也支持通过IP访问

Plain Text

1String ACCESS_KEY_ID = <your-access-key-id>;               // 用户的Access Key ID
2String SECRET_ACCESS_KEY = <your-secret-access-key>;       // 用户的Secret Access Key
3String ENDPOINT = <ip>;                                    // 时序数据库的ip或者正向代理的ip
4String databaseName = <database-name>;                     // 创建的时序数据库名称
5 
6// 创建配置
7BceClientConfiguration config = new BceClientConfiguration()
8                .withCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY))
9                .withEndpoint(ENDPOINT);
10
11// 初始化一个TsdbClient
12TsdbClient tsdbClient = new TsdbClient(config, databaseName);

参数说明

BceClientConfiguration中有更多的配置项，可配置如下参数：

参数	说明
connectionTimeoutInMillis	建立连接的超时时间（单位：毫秒）
localAddress	本地地址
maxConnections	允许打开的最大HTTP连接数
protocol	连接协议类型
proxyDomain	访问NTLM验证的代理服务器的Windows域名
proxyHost	代理服务器主机地址
proxyPassword	代理服务器验证的密码
proxyPort	代理服务器端口
proxyPreemptiveAuthenticationEnabled	是否设置用户代理认证
proxyUsername	代理服务器验证的用户名
proxyWorkstation	NTLM代理服务器的Windows工作站名称
retryPolicy	连接重试策略
socketBufferSizeInBytes	Socket缓冲区大小
socketTimeoutInMillis	通过打开的连接传输数据的超时时间（单位：毫秒）
userAgent	用户代理，指HTTP的User-Agent头

写入操作

Demo工程下载

时序时空数据库 TSDB

时序时空数据库 TSDB

创建TsdbClient