Lindorm:Initialize a LindormTSDB client

How it works

1. Build a ClientOptions object — specify the endpoint, optional credentials, and tuning parameters.

2. Call LindormTSDBFactory.connect(options) to create the client.

3. Use the client for read and write operations.

4. Call client.shutdown() when done to release resources.

Prerequisites

Before you begin, ensure that you have:

• A LindormTSDB endpoint. To get the endpoint, see View endpoints.

• (If authentication is enabled) A username and password for LindormTSDB. See User and permission management.

Create a LindormTSDBClient instance

The following example shows the full set of ClientOptions parameters. Only url is required — all other parameters are optional.

// Endpoint of LindormTSDB
String url = "http://ld-bp1489gr5t*****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242";
// Credentials — required only if authentication is enabled
String username = "username";
String password = "password";
// Default database to connect to
String db = "default";

ClientOptions options = ClientOptions
        .newBuilder(url)                    // Required
        .setUsername(username)              // Required if authentication is enabled
        .setPassword(password)              // Required if authentication is enabled
        .setNumBatchThreads(8)              // Optional. Default: 8
        .setMaxRetries(3)                   // Optional. Default: 3
        .setRetryBackoffMs(1000)            // Optional. Default: 1000 ms
        .setRequestTimeoutMs(30000)         // Optional. Default: 30000 ms
        .setConnectTimeoutMs(30000)         // Optional. Default: 30000 ms
        .setMaxWaitTimeMs(300)              // Optional. Default: 300 ms
        .setBatchSize(500)                  // Optional. Default: 500
        .setMaxPointBatches(32)             // Optional. Default: 32
        .setDefaultDatabase(db)             // Optional. Default: "default"
        .setQueryChunkSize(1000)            // Optional. Default: 1000
        .setSchemaPolicy(SchemaPolicy.WEAK) // Optional. Default: STRONG
        .build();

LindormTSDBClient client = LindormTSDBFactory.connect(options);

// ... perform read and write operations ...

client.shutdown();

Configure ClientOptions

ClientOptions is the configuration class for LindormTSDBClient. The following tables describe each parameter, grouped by function.

What's next

• View endpoints

• User and permission management

• Supported schema constraint policies