创建TsdbClient
更新时间：2021-01-04
用户可以参考如下代码新建一个TsdbClient：
HTTP Client
String ACCESS_KEY_ID = <your-access-key-id>; // 用户的Access Key ID
String SECRET_ACCESS_KEY = <your-secret-access-key>; // 用户的Secret Access Key
String ENDPOINT = <your-tsdb-database-endpoint>; // 用户的时序数据库域名，形式如databasename.tsdb.iot.gz.baidubce.com
// 创建配置
BceClientConfiguration config = new BceClientConfiguration()
.withCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY))
.withEndpoint(ENDPOINT);
// 初始化一个TsdbClient
TsdbClient tsdbClient = new TsdbClient(config);HTTPS Client
String ACCESS_KEY_ID = <your-access-key-id>; // 用户的Access Key ID
String SECRET_ACCESS_KEY = <your-secret-access-key>; // 用户的Secret Access Key
String ENDPOINT = <your-tsdb-database-endpoint>; // 用户的时序数据库域名，形式如databasename.tsdb.iot.gz.baidubce.com
// 创建配置
BceClientConfiguration config = new BceClientConfiguration()
.withProtocol(Protocol.HTTPS) // 使用HTTPS协议;不设置，默认使用HTTP协议
.withCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY))
.withEndpoint(ENDPOINT);
// 初始化一个TsdbClient
TsdbClient 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访问
String ACCESS_KEY_ID = <your-access-key-id>; // 用户的Access Key ID
String SECRET_ACCESS_KEY = <your-secret-access-key>; // 用户的Secret Access Key
String ENDPOINT = <ip>; // 时序数据库的ip或者正向代理的ip
String databaseName = <database-name>; // 创建的时序数据库名称
// 创建配置
BceClientConfiguration config = new BceClientConfiguration()
.withCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY))
.withEndpoint(ENDPOINT);
// 初始化一个TsdbClient
TsdbClient 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头 |