The JDBC URL specifies the endpoint and connection parameters that an application passes to the JDBC Connection interface to connect to LindormTSDB.
URL syntax
jdbc:lindorm:tsdb:url=http://<host>:<port>[;<parameter>=<value>]...Examples
Minimal connection (no authentication):
jdbc:lindorm:tsdb:url=http://ld-bp12pc23yfb3*****-proxy-tsdb-pub.lindorm.rds.aliyuncs.com:8242Connection with authentication and a specific database:
jdbc:lindorm:tsdb:url=http://ld-bp12pc23yfb3*****-proxy-tsdb-pub.lindorm.rds.aliyuncs.com:8242;user=root;password=<your-password>;database=mydbConnection parameters
Endpoint
| Parameter | Description |
|---|---|
<host>:<port> | The endpoint and port of your LindormTSDB instance. For instructions on finding the endpoint, see View endpoints. |
Authentication
| Parameter | Default | Description |
|---|---|---|
user | — | Username for authentication. Required only if the user authentication feature is enabled. For instructions on enabling this feature, see Enable the user authentication and permission verification feature. |
password | — | Password for the specified user. Required only if the user authentication feature is enabled. To reset a forgotten password, see Change the password in the cluster management system of LindormTable. |
Database selection
| Parameter | Default | Description |
|---|---|---|
database | default | The database to connect to. If omitted, connects to the default database. |
Timeouts
| Parameter | Default | Description |
|---|---|---|
lindorm.tsdb.driver.connect.timeout | 60,000 ms (60 s) | Timeout for establishing a connection to the LindormTSDB server. |
lindorm.tsdb.driver.socket.timeout | -1 (no timeout) | Timeout for socket read and write operations. |
Usage notes
Idle connection timeout
LindormTSDB closes connections that have been idle for more than 90 seconds to free server resources. Using a closed connection throws:
com.aliyun.lindorm.client.shaded.org.apache.calcite.avatica.http.ConnectionDisconnectedExceptionTo avoid this error, establish a new connection after a disconnect.