All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.iotdb.session.pool.SessionPool Maven / Gradle / Ivy

There is a newer version: 1.3.2
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.iotdb.session.pool;

import org.apache.iotdb.rpc.IoTDBConnectionException;
import org.apache.iotdb.rpc.StatementExecutionException;
import org.apache.iotdb.session.Config;
import org.apache.iotdb.session.Session;
import org.apache.iotdb.session.SessionDataSet;
import org.apache.iotdb.session.template.Template;
import org.apache.iotdb.session.util.SystemStatus;
import org.apache.iotdb.tsfile.file.metadata.enums.CompressionType;
import org.apache.iotdb.tsfile.file.metadata.enums.TSDataType;
import org.apache.iotdb.tsfile.file.metadata.enums.TSEncoding;
import org.apache.iotdb.tsfile.write.record.Tablet;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.nio.ByteBuffer;
import java.time.ZoneId;
import java.util.List;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentLinkedDeque;
import java.util.concurrent.ConcurrentMap;

/**
 * SessionPool is a wrapper of a Session Set. Using SessionPool, the user do not need to consider
 * how to reuse a session connection. Even if the session is disconnected, the session pool can
 * recognize it and remove the broken session connection and create a new one.
 *
 * 

If there is no available connections and the pool reaches its max size, the all methods will * hang until there is a available connection. * *

If a user has waited for a session for more than 60 seconds, a warn log will be printed. * *

The only thing you have to remember is that: * *

For a query, if you have get all data, i.e., SessionDataSetWrapper.hasNext() == false, it is * ok. Otherwise, i.e., you want to stop the query before you get all data * (SessionDataSetWrapper.hasNext() == true), then you have to call * closeResultSet(SessionDataSetWrapper wrapper) manually. Otherwise the connection is occupied by * the query. * *

Another case that you have to manually call closeResultSet() is that when there is exception * when you call SessionDataSetWrapper.hasNext() or next() */ public class SessionPool { private static final Logger logger = LoggerFactory.getLogger(SessionPool.class); public static final String SESSION_POOL_IS_CLOSED = "Session pool is closed"; public static final String CLOSE_THE_SESSION_FAILED = "close the session failed."; private static final int RETRY = 3; private static final int FINAL_RETRY = RETRY - 1; private final ConcurrentLinkedDeque queue = new ConcurrentLinkedDeque<>(); // for session whose resultSet is not released. private final ConcurrentMap occupied = new ConcurrentHashMap<>(); private int size = 0; private int maxSize = 0; private final long waitToGetSessionTimeoutInMs; // parameters for Session constructor private final String host; private final int port; private final String user; private final String password; private final int fetchSize; private final ZoneId zoneId; private final boolean enableCacheLeader; // parameters for Session#open() private final int connectionTimeoutInMs; private final boolean enableCompression; // whether the queue is closed. private boolean closed; // Redirect-able SessionPool private final List nodeUrls; public SessionPool(String host, int port, String user, String password, int maxSize) { this( host, port, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, false, null, Config.DEFAULT_CACHE_LEADER_MODE, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool(List nodeUrls, String user, String password, int maxSize) { this( nodeUrls, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, false, null, Config.DEFAULT_CACHE_LEADER_MODE, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool( String host, int port, String user, String password, int maxSize, boolean enableCompression) { this( host, port, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, enableCompression, null, Config.DEFAULT_CACHE_LEADER_MODE, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool( List nodeUrls, String user, String password, int maxSize, boolean enableCompression) { this( nodeUrls, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, enableCompression, null, Config.DEFAULT_CACHE_LEADER_MODE, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool( String host, int port, String user, String password, int maxSize, boolean enableCompression, boolean enableCacheLeader) { this( host, port, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, enableCompression, null, enableCacheLeader, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool( List nodeUrls, String user, String password, int maxSize, boolean enableCompression, boolean enableCacheLeader) { this( nodeUrls, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, enableCompression, null, enableCacheLeader, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool( String host, int port, String user, String password, int maxSize, ZoneId zoneId) { this( host, port, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, false, zoneId, Config.DEFAULT_CACHE_LEADER_MODE, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } public SessionPool( List nodeUrls, String user, String password, int maxSize, ZoneId zoneId) { this( nodeUrls, user, password, maxSize, Config.DEFAULT_FETCH_SIZE, 60_000, false, zoneId, Config.DEFAULT_CACHE_LEADER_MODE, Config.DEFAULT_CONNECTION_TIMEOUT_MS); } @SuppressWarnings("squid:S107") public SessionPool( String host, int port, String user, String password, int maxSize, int fetchSize, long waitToGetSessionTimeoutInMs, boolean enableCompression, ZoneId zoneId, boolean enableCacheLeader, int connectionTimeoutInMs) { this.maxSize = maxSize; this.host = host; this.port = port; this.nodeUrls = null; this.user = user; this.password = password; this.fetchSize = fetchSize; this.waitToGetSessionTimeoutInMs = waitToGetSessionTimeoutInMs; this.enableCompression = enableCompression; this.zoneId = zoneId; this.enableCacheLeader = enableCacheLeader; this.connectionTimeoutInMs = connectionTimeoutInMs; } public SessionPool( List nodeUrls, String user, String password, int maxSize, int fetchSize, long waitToGetSessionTimeoutInMs, boolean enableCompression, ZoneId zoneId, boolean enableCacheLeader, int connectionTimeoutInMs) { this.maxSize = maxSize; this.host = null; this.port = -1; this.nodeUrls = nodeUrls; this.user = user; this.password = password; this.fetchSize = fetchSize; this.waitToGetSessionTimeoutInMs = waitToGetSessionTimeoutInMs; this.enableCompression = enableCompression; this.zoneId = zoneId; this.enableCacheLeader = enableCacheLeader; this.connectionTimeoutInMs = connectionTimeoutInMs; } private Session constructNewSession() { Session session; if (nodeUrls == null) { // Construct custom Session session = new Session.Builder() .host(host) .port(port) .username(user) .password(password) .fetchSize(fetchSize) .zoneId(zoneId) .enableCacheLeader(enableCacheLeader) .build(); } else { // Construct redirect-able Session session = new Session.Builder() .nodeUrls(nodeUrls) .username(user) .password(password) .fetchSize(fetchSize) .zoneId(zoneId) .enableCacheLeader(enableCacheLeader) .build(); } return session; } // if this method throws an exception, either the server is broken, or the ip/port/user/password // is incorrect. @SuppressWarnings({"squid:S3776", "squid:S2446"}) // Suppress high Cognitive Complexity warning private Session getSession() throws IoTDBConnectionException { Session session = queue.poll(); if (closed) { throw new IoTDBConnectionException(SESSION_POOL_IS_CLOSED); } if (session != null) { return session; } boolean shouldCreate = false; long start = System.currentTimeMillis(); while (session == null) { synchronized (this) { if (size < maxSize) { // we can create more session size++; shouldCreate = true; // but we do it after skip synchronized block because connection a session is time // consuming. break; } // we have to wait for someone returns a session. try { if (logger.isDebugEnabled()) { logger.debug("no more sessions can be created, wait... queue.size={}", queue.size()); } this.wait(1000); long timeOut = Math.min(waitToGetSessionTimeoutInMs, 60_000); if (System.currentTimeMillis() - start > timeOut) { logger.warn( "the SessionPool has wait for {} seconds to get a new connection: {}:{} with {}, {}", (System.currentTimeMillis() - start) / 1000, host, port, user, password); logger.warn( "current occupied size {}, queue size {}, considered size {} ", occupied.size(), queue.size(), size); if (System.currentTimeMillis() - start > waitToGetSessionTimeoutInMs) { throw new IoTDBConnectionException( String.format("timeout to get a connection from %s:%s", host, port)); } } } catch (InterruptedException e) { // wake up from this.wait(1000) by this.notify() } session = queue.poll(); if (closed) { throw new IoTDBConnectionException(SESSION_POOL_IS_CLOSED); } } } if (shouldCreate) { // create a new one. if (logger.isDebugEnabled()) { if (nodeUrls == null) { logger.debug("Create a new Session {}, {}, {}, {}", host, port, user, password); } else { logger.debug("Create a new redirect Session {}, {}, {}", nodeUrls, user, password); } } session = constructNewSession(); try { session.open(enableCompression, connectionTimeoutInMs); // avoid someone has called close() the session pool synchronized (this) { if (closed) { // have to release the connection... session.close(); throw new IoTDBConnectionException(SESSION_POOL_IS_CLOSED); } } } catch (IoTDBConnectionException e) { // if exception, we will throw the exception. // Meanwhile, we have to set size-- synchronized (this) { size--; // we do not need to notifyAll as any waited thread can continue to work after waked up. this.notify(); if (logger.isDebugEnabled()) { logger.debug("open session failed, reduce the count and notify others..."); } } throw e; } } return session; } public int currentAvailableSize() { return queue.size(); } public int currentOccupiedSize() { return occupied.size(); } @SuppressWarnings({"squid:S2446"}) private void putBack(Session session) { queue.push(session); synchronized (this) { // we do not need to notifyAll as any waited thread can continue to work after waked up. this.notify(); // comment the following codes as putBack is too frequently called. // if (logger.isTraceEnabled()) { // logger.trace("put a session back and notify others..., queue.size = {}", // queue.size()); // } } } private void occupy(Session session) { occupied.put(session, session); } /** close all connections in the pool */ public synchronized void close() { for (Session session : queue) { try { session.close(); } catch (IoTDBConnectionException e) { // do nothing logger.warn(CLOSE_THE_SESSION_FAILED, e); } } for (Session session : occupied.keySet()) { try { session.close(); } catch (IoTDBConnectionException e) { // do nothing logger.warn(CLOSE_THE_SESSION_FAILED, e); } } logger.info("closing the session pool, cleaning queues..."); this.closed = true; queue.clear(); occupied.clear(); } public void closeResultSet(SessionDataSetWrapper wrapper) { boolean putback = true; try { wrapper.sessionDataSet.closeOperationHandle(); } catch (IoTDBConnectionException | StatementExecutionException e) { tryConstructNewSession(); putback = false; } finally { Session session = occupied.remove(wrapper.session); if (putback && session != null) { putBack(wrapper.session); } } } @SuppressWarnings({"squid:S2446"}) private void tryConstructNewSession() { Session session = constructNewSession(); try { session.open(enableCompression, connectionTimeoutInMs); // avoid someone has called close() the session pool synchronized (this) { if (closed) { // have to release the connection... session.close(); throw new IoTDBConnectionException(SESSION_POOL_IS_CLOSED); } queue.push(session); this.notify(); } } catch (IoTDBConnectionException e) { synchronized (this) { size--; // we do not need to notifyAll as any waited thread can continue to work after waked up. this.notify(); if (logger.isDebugEnabled()) { logger.debug("open session failed, reduce the count and notify others..."); } } } } private void closeSession(Session session) { if (session != null) { try { session.close(); } catch (Exception e2) { // do nothing. We just want to guarantee the session is closed. logger.warn(CLOSE_THE_SESSION_FAILED, e2); } } } private void cleanSessionAndMayThrowConnectionException( Session session, int times, IoTDBConnectionException e) throws IoTDBConnectionException { closeSession(session); tryConstructNewSession(); if (times == FINAL_RETRY) { throw new IoTDBConnectionException( String.format( "retry to execute statement on %s:%s failed %d times: %s", host, port, RETRY, e.getMessage()), e); } } /** * insert the data of a device. For each timestamp, the number of measurements is the same. * * @param tablet data batch */ public void insertTablet(Tablet tablet) throws IoTDBConnectionException, StatementExecutionException { /* * A Tablet example: * device1 * time s1, s2, s3 * 1, 1, 1, 1 * 2, 2, 2, 2 * 3, 3, 3, 3 * * times in Tablet may be not in ascending orde */ insertTablet(tablet, false); } /** * insert the data of a device. For each timestamp, the number of measurements is the same. * *

Users need to control the count of Tablet and write a batch when it reaches the maxBatchSize * * @param tablet a tablet data of one device * @param sorted whether times in Tablet are in ascending order */ public void insertTablet(Tablet tablet, boolean sorted) throws IoTDBConnectionException, StatementExecutionException { /* * A Tablet example: * device1 * time s1, s2, s3 * 1, 1, 1, 1 * 2, 2, 2, 2 * 3, 3, 3, 3 */ for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertTablet(tablet, sorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertTablet failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * insert the data of a device. For each timestamp, the number of measurements is the same. * *

Users need to control the count of Tablet and write a batch when it reaches the maxBatchSize * * @param tablet a tablet data of one device */ public void insertAlignedTablet(Tablet tablet) throws IoTDBConnectionException, StatementExecutionException { insertAlignedTablet(tablet, false); } /** * insert the data of a device. For each timestamp, the number of measurements is the same. * *

Users need to control the count of Tablet and write a batch when it reaches the maxBatchSize * * @param tablet a tablet data of one device * @param sorted whether times in Tablet are in ascending order */ public void insertAlignedTablet(Tablet tablet, boolean sorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedTablet(tablet, sorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedTablet failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * use batch interface to insert data * * @param tablets multiple batch */ public void insertTablets(Map tablets) throws IoTDBConnectionException, StatementExecutionException { insertTablets(tablets, false); } /** * use batch interface to insert data * * @param tablets multiple batch */ public void insertAlignedTablets(Map tablets) throws IoTDBConnectionException, StatementExecutionException { insertAlignedTablets(tablets, false); } /** * use batch interface to insert aligned data * * @param tablets multiple batch */ public void insertTablets(Map tablets, boolean sorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertTablets(tablets, sorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertTablets failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * use batch interface to insert aligned data * * @param tablets multiple batch */ public void insertAlignedTablets(Map tablets, boolean sorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedTablets(tablets, sorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedTablets failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert data in batch format, which can reduce the overhead of network. This method is just like * jdbc batch insert, we pack some insert request in batch and send them to server If you want * improve your performance, please see insertTablet method * * @see Session#insertTablet(Tablet) */ public void insertRecords( List deviceIds, List times, List> measurementsList, List> typesList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecords(deviceIds, times, measurementsList, typesList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecords failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert aligned data in batch format, which can reduce the overhead of network. This method is * just like jdbc batch insert, we pack some insert request in batch and send them to server If * you want improve your performance, please see insertTablet method. * * @see Session#insertTablet(Tablet) */ public void insertAlignedRecords( List multiSeriesIds, List times, List> multiMeasurementComponentsList, List> typesList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedRecords( multiSeriesIds, times, multiMeasurementComponentsList, typesList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedRecords failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert data that belong to the same device in batch format, which can reduce the overhead of * network. This method is just like jdbc batch insert, we pack some insert request in batch and * send them to server If you want improve your performance, please see insertTablet method * * @see Session#insertTablet(Tablet) */ public void insertRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> typesList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecordsOfOneDevice( deviceId, times, measurementsList, typesList, valuesList, false); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert data that belong to the same device in batch format, which can reduce the overhead of * network. This method is just like jdbc batch insert, we pack some insert request in batch and * send them to server If you want improve your performance, please see insertTablet method * * @see Session#insertTablet(Tablet) */ @Deprecated public void insertOneDeviceRecords( String deviceId, List times, List> measurementsList, List> typesList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecordsOfOneDevice( deviceId, times, measurementsList, typesList, valuesList, false); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert String format data that belong to the same device in batch format, which can reduce the * overhead of network. This method is just like jdbc batch insert, we pack some insert request in * batch and send them to server If you want improve your performance, please see insertTablet * method * * @see Session#insertTablet(Tablet) */ public void insertStringRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertStringRecordsOfOneDevice( deviceId, times, measurementsList, valuesList, false); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertStringRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert data that belong to the same device in batch format, which can reduce the overhead of * network. This method is just like jdbc batch insert, we pack some insert request in batch and * send them to server If you want improve your performance, please see insertTablet method * * @param haveSorted whether the times list has been ordered. * @see Session#insertTablet(Tablet) */ public void insertRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> typesList, List> valuesList, boolean haveSorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecordsOfOneDevice( deviceId, times, measurementsList, typesList, valuesList, haveSorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert data that belong to the same device in batch format, which can reduce the overhead of * network. This method is just like jdbc batch insert, we pack some insert request in batch and * send them to server If you want improve your performance, please see insertTablet method * * @param haveSorted whether the times list has been ordered. * @see Session#insertTablet(Tablet) */ @Deprecated public void insertOneDeviceRecords( String deviceId, List times, List> measurementsList, List> typesList, List> valuesList, boolean haveSorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecordsOfOneDevice( deviceId, times, measurementsList, typesList, valuesList, haveSorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert String format data that belong to the same device in batch format, which can reduce the * overhead of network. This method is just like jdbc batch insert, we pack some insert request in * batch and send them to server If you want improve your performance, please see insertTablet * method * * @param haveSorted whether the times list has been ordered. * @see Session#insertTablet(Tablet) */ public void insertStringRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> valuesList, boolean haveSorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertStringRecordsOfOneDevice( deviceId, times, measurementsList, valuesList, haveSorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertStringRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert aligned data that belong to the same device in batch format, which can reduce the * overhead of network. This method is just like jdbc batch insert, we pack some insert request in * batch and send them to server If you want improve your performance, please see insertTablet * method. * * @see Session#insertTablet(Tablet) */ public void insertAlignedRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> typesList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedRecordsOfOneDevice( deviceId, times, measurementsList, typesList, valuesList, false); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert aligned data as String format that belong to the same device in batch format, which can * reduce the overhead of network. This method is just like jdbc batch insert, we pack some insert * request in batch and send them to server If you want improve your performance, please see * insertTablet method. * * @see Session#insertTablet(Tablet) */ public void insertAlignedStringRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedStringRecordsOfOneDevice( deviceId, times, measurementsList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedStringRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert aligned data that belong to the same device in batch format, which can reduce the * overhead of network. This method is just like jdbc batch insert, we pack some insert request in * batch and send them to server If you want improve your performance, please see insertTablet * method. * * @param haveSorted whether the times list has been ordered. * @see Session#insertTablet(Tablet) */ public void insertAlignedRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> typesList, List> valuesList, boolean haveSorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedRecordsOfOneDevice( deviceId, times, measurementsList, typesList, valuesList, haveSorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert aligned data as String format that belong to the same device in batch format, which can * reduce the overhead of network. This method is just like jdbc batch insert, we pack some insert * request in batch and send them to server If you want improve your performance, please see * insertTablet method. * * @param haveSorted whether the times list has been ordered. * @see Session#insertTablet(Tablet) */ public void insertAlignedStringRecordsOfOneDevice( String deviceId, List times, List> measurementsList, List> valuesList, boolean haveSorted) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedStringRecordsOfOneDevice( deviceId, times, measurementsList, valuesList, haveSorted); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedStringRecordsOfOneDevice failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert data in batch format, which can reduce the overhead of network. This method is just like * jdbc batch insert, we pack some insert request in batch and send them to server If you want * improve your performance, please see insertTablet method * * @see Session#insertTablet(Tablet) */ public void insertRecords( List deviceIds, List times, List> measurementsList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecords(deviceIds, times, measurementsList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecords failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Insert aligned data in batch format, which can reduce the overhead of network. This method is * just like jdbc batch insert, we pack some insert request in batch and send them to server If * you want improve your performance, please see insertTablet method. * * @see Session#insertTablet(Tablet) */ public void insertAlignedRecords( List multiSeriesIds, List times, List> multiMeasurementComponentsList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedRecords( multiSeriesIds, times, multiMeasurementComponentsList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedRecords failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * insert data in one row, if you want improve your performance, please use insertRecords method * or insertTablet method * * @see Session#insertRecords(List, List, List, List, List) * @see Session#insertTablet(Tablet) */ public void insertRecord( String deviceId, long time, List measurements, List types, List values) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecord(deviceId, time, measurements, types, values); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecord failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * insert aligned data in one row, if you want improve your performance, please use * insertAlignedRecords method or insertTablet method. * * @see Session#insertAlignedRecords(List, List, List, List, List) * @see Session#insertTablet(Tablet) */ public void insertAlignedRecord( String multiSeriesId, long time, List multiMeasurementComponents, List types, List values) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedRecord(multiSeriesId, time, multiMeasurementComponents, types, values); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedRecord failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * insert data in one row, if you want improve your performance, please use insertRecords method * or insertTablet method * * @see Session#insertRecords(List, List, List, List, List) * @see Session#insertTablet(Tablet) */ public void insertRecord( String deviceId, long time, List measurements, List values) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertRecord(deviceId, time, measurements, values); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertRecord failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * insert aligned data in one row, if you want improve your performance, please use * insertAlignedRecords method or insertTablet method. * * @see Session#insertAlignedRecords(List, List, List, List, List) * @see Session#insertTablet(Tablet) */ public void insertAlignedRecord( String multiSeriesId, long time, List multiMeasurementComponents, List values) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.insertAlignedRecord(multiSeriesId, time, multiMeasurementComponents, values); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("insertAlignedRecord failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * This method NOT insert data into database and the server just return after accept the request, * this method should be used to test other time cost in client */ public void testInsertTablet(Tablet tablet) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.testInsertTablet(tablet); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("testInsertTablet failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * This method NOT insert data into database and the server just return after accept the request, * this method should be used to test other time cost in client */ public void testInsertTablets(Map tablets) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.testInsertTablets(tablets); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("testInsertTablets failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * This method NOT insert data into database and the server just return after accept the request, * this method should be used to test other time cost in client */ public void testInsertRecords( List deviceIds, List times, List> measurementsList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.testInsertRecords(deviceIds, times, measurementsList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("testInsertRecords failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * This method NOT insert data into database and the server just return after accept the request, * this method should be used to test other time cost in client */ public void testInsertRecords( List deviceIds, List times, List> measurementsList, List> typesList, List> valuesList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.testInsertRecords(deviceIds, times, measurementsList, typesList, valuesList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("testInsertRecords failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * This method NOT insert data into database and the server just return after accept the request, * this method should be used to test other time cost in client */ public void testInsertRecord( String deviceId, long time, List measurements, List values) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.testInsertRecord(deviceId, time, measurements, values); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("testInsertRecord failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * This method NOT insert data into database and the server just return after accept the request, * this method should be used to test other time cost in client */ public void testInsertRecord( String deviceId, long time, List measurements, List types, List values) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.testInsertRecord(deviceId, time, measurements, types, values); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("testInsertRecord failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * delete a timeseries, including data and schema * * @param path timeseries to delete, should be a whole path */ public void deleteTimeseries(String path) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteTimeseries(path); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteTimeseries failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * delete a timeseries, including data and schema * * @param paths timeseries to delete, should be a whole path */ public void deleteTimeseries(List paths) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteTimeseries(paths); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteTimeseries failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * delete data <= time in one timeseries * * @param path data in which time series to delete * @param time data with time stamp less than or equal to time will be deleted */ public void deleteData(String path, long time) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteData(path, time); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteData failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * delete data <= time in multiple timeseries * * @param paths data in which time series to delete * @param time data with time stamp less than or equal to time will be deleted */ public void deleteData(List paths, long time) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteData(paths, time); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteData failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * delete data >= startTime and data <= endTime in multiple timeseries * * @param paths data in which time series to delete * @param startTime delete range start time * @param endTime delete range end time */ public void deleteData(List paths, long startTime, long endTime) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteData(paths, startTime, endTime); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteData failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void setStorageGroup(String storageGroupId) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.setStorageGroup(storageGroupId); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("setStorageGroup failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void deleteStorageGroup(String storageGroup) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteStorageGroup(storageGroup); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteStorageGroup failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void deleteStorageGroups(List storageGroup) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteStorageGroups(storageGroup); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteStorageGroups failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void createTimeseries( String path, TSDataType dataType, TSEncoding encoding, CompressionType compressor) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createTimeseries(path, dataType, encoding, compressor); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("createTimeseries failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void createTimeseries( String path, TSDataType dataType, TSEncoding encoding, CompressionType compressor, Map props, Map tags, Map attributes, String measurementAlias) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createTimeseries( path, dataType, encoding, compressor, props, tags, attributes, measurementAlias); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("createTimeseries failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void createMultiTimeseries( List paths, List dataTypes, List encodings, List compressors, List> propsList, List> tagsList, List> attributesList, List measurementAliasList) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createMultiTimeseries( paths, dataTypes, encodings, compressors, propsList, tagsList, attributesList, measurementAliasList); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("createMultiTimeseries failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public boolean checkTimeseriesExists(String path) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { boolean resp = session.checkTimeseriesExists(path); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("checkTimeseriesExists failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } // never go here. return false; } /** * Construct Template at session and create it at server. * * @see Template */ public void createSchemaTemplate(Template template) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createSchemaTemplate(template); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("createSchemaTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Create a template with flat measurements, not tree structured. Need to specify datatype, * encoding and compressor of each measurement, and alignment of these measurements at once. * * @oaram templateName name of template to create * @param measurements flat measurements of the template, cannot contain character dot * @param dataTypes datatype of each measurement in the template * @param encodings encodings of each measurement in the template * @param compressors compression type of each measurement in the template * @param isAligned specify whether these flat measurements are aligned */ public void createSchemaTemplate( String templateName, List measurements, List dataTypes, List encodings, List compressors, boolean isAligned) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createSchemaTemplate( templateName, measurements, dataTypes, encodings, compressors, isAligned); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("createSchemaTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * Compatible for rel/0.12, this method will create an unaligned flat template as a result. Notice * that there is no aligned concept in 0.12, so only the first measurement in each nested list * matters. * * @param name name of the template * @param schemaNames it works as a virtual layer inside template in 0.12, and makes no difference * after 0.13 * @param measurements the first measurement in each nested list will constitute the final flat * template * @param dataTypes the data type of each measurement, only the first one in each nested list * matters as above * @param encodings the encoding of each measurement, only the first one in each nested list * matters as above * @param compressors the compressor of each measurement * @throws IoTDBConnectionException * @throws StatementExecutionException */ @Deprecated public void createSchemaTemplate( String name, List schemaNames, List> measurements, List> dataTypes, List> encodings, List compressors) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createSchemaTemplate( name, schemaNames, measurements, dataTypes, encodings, compressors); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("createSchemaTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void addAlignedMeasurementsInTemplate( String templateName, List measurementsPath, List dataTypes, List encodings, List compressors) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.addAlignedMeasurementsInTemplate( templateName, measurementsPath, dataTypes, encodings, compressors); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("addAlignedMeasurementsInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void addAlignedMeasurementInTemplate( String templateName, String measurementPath, TSDataType dataType, TSEncoding encoding, CompressionType compressor) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.addAlignedMeasurementInTemplate( templateName, measurementPath, dataType, encoding, compressor); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("addAlignedMeasurementInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void addUnalignedMeasurementsInTemplate( String templateName, List measurementsPath, List dataTypes, List encodings, List compressors) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.addUnalignedMeasurementsInTemplate( templateName, measurementsPath, dataTypes, encodings, compressors); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("addUnalignedMeasurementsInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void addUnalignedMeasurementInTemplate( String templateName, String measurementPath, TSDataType dataType, TSEncoding encoding, CompressionType compressor) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.addUnalignedMeasurementInTemplate( templateName, measurementPath, dataType, encoding, compressor); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("addUnalignedMeasurementInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void deleteNodeInTemplate(String templateName, String path) throws IOException, IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deleteNodeInTemplate(templateName, path); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("deleteNodeInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public int countMeasurementsInTemplate(String name) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { int resp = session.countMeasurementsInTemplate(name); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("countMeasurementsInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return -1; } public boolean isMeasurementInTemplate(String templateName, String path) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { boolean resp = session.isMeasurementInTemplate(templateName, path); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("isMeasurementInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return false; } public boolean isPathExistInTemplate(String templateName, String path) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { boolean resp = session.isPathExistInTemplate(templateName, path); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("isPathExistInTemplata failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return false; } public List showMeasurementsInTemplate(String templateName) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { List resp = session.showMeasurementsInTemplate(templateName); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("showMeasurementsInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return null; } public List showMeasurementsInTemplate(String templateName, String pattern) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { List resp = session.showMeasurementsInTemplate(templateName, pattern); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("showMeasurementsInTemplate failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return null; } public List showAllTemplates() throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { List resp = session.showAllTemplates(); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("showAllTemplates failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return null; } public List showPathsTemplateSetOn(String templateName) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { List resp = session.showPathsTemplateSetOn(templateName); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("showPathsTemplateSetOn failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return null; } public List showPathsTemplateUsingOn(String templateName) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { List resp = session.showPathsTemplateUsingOn(templateName); putBack(session); return resp; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("showPathsTemplateUsingOn failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return null; } public void setSchemaTemplate(String templateName, String prefixPath) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.setSchemaTemplate(templateName, prefixPath); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn( String.format("setSchemaTemplate [%s] on [%s] failed", templateName, prefixPath), e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void unsetSchemaTemplate(String prefixPath, String templateName) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.unsetSchemaTemplate(prefixPath, templateName); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn( String.format("unsetSchemaTemplate [%s] on [%s] failed", templateName, prefixPath), e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void createTimeseriesOfTemplateOnPath(String path) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.createTimeseriesOfTemplateOnPath(path); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn(String.format("create timeseries of template on [%s] failed", path), e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void deactivateTempalte(String templateName, String prefixPath) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.deactivateTemplateOn(templateName, prefixPath); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn( String.format("Deactivate template [%s] on [%s] failed", templateName, prefixPath), e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } public void dropSchemaTemplate(String templateName) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.dropSchemaTemplate(templateName); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn(String.format("dropSchemaTemplate [%s] failed", templateName), e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } /** * execure query sql users must call closeResultSet(SessionDataSetWrapper) if they do not use the * SessionDataSet any more. users do not need to call sessionDataSet.closeOpeationHandler() any * more. * * @param sql query statement * @return result set Notice that you must get the result instance. Otherwise a data leakage will * happen */ @SuppressWarnings("squid:S2095") // Suppress wrapper not closed warning public SessionDataSetWrapper executeQueryStatement(String sql) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { SessionDataSet resp = session.executeQueryStatement(sql); SessionDataSetWrapper wrapper = new SessionDataSetWrapper(resp, session, this); occupy(session); return wrapper; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("executeQueryStatement failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } // never go here return null; } /** * execure query sql users must call closeResultSet(SessionDataSetWrapper) if they do not use the * SessionDataSet any more. users do not need to call sessionDataSet.closeOpeationHandler() any * more. * * @param sql query statement * @param timeoutInMs the timeout of this query, in milliseconds * @return result set Notice that you must get the result instance. Otherwise a data leakage will * happen */ @SuppressWarnings("squid:S2095") // Suppress wrapper not closed warning public SessionDataSetWrapper executeQueryStatement(String sql, long timeoutInMs) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { SessionDataSet resp = session.executeQueryStatement(sql, timeoutInMs); SessionDataSetWrapper wrapper = new SessionDataSetWrapper(resp, session, this); occupy(session); return wrapper; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("executeQueryStatement failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } // never go here return null; } /** * execute non query statement * * @param sql non query statement */ public void executeNonQueryStatement(String sql) throws StatementExecutionException, IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { session.executeNonQueryStatement(sql); putBack(session); return; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("executeNonQueryStatement failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } } @SuppressWarnings("squid:S2095") // Suppress wrapper not closed warning public SessionDataSetWrapper executeRawDataQuery(List paths, long startTime, long endTime) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { SessionDataSet resp = session.executeRawDataQuery(paths, startTime, endTime); SessionDataSetWrapper wrapper = new SessionDataSetWrapper(resp, session, this); occupy(session); return wrapper; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. logger.warn("executeRawDataQuery failed", e); cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } // never go here return null; } /** Transmit insert record request for OperationSync */ public boolean operationSyncTransmit(ByteBuffer buffer) throws IoTDBConnectionException, StatementExecutionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { buffer.position(0); session.operationSyncTransmit(buffer); putBack(session); return true; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. cleanSessionAndMayThrowConnectionException(session, i, e); } catch (StatementExecutionException | RuntimeException e) { putBack(session); throw e; } } return false; } public SystemStatus getSystemStatus() throws IoTDBConnectionException { for (int i = 0; i < RETRY; i++) { Session session = getSession(); try { SystemStatus status = session.getSystemStatus(); putBack(session); return status; } catch (IoTDBConnectionException e) { // TException means the connection is broken, remove it and get a new one. cleanSessionAndMayThrowConnectionException(session, i, e); } catch (RuntimeException e) { putBack(session); throw e; } } return null; } public int getMaxSize() { return maxSize; } public String getHost() { return host; } public int getPort() { return port; } public String getUser() { return user; } public String getPassword() { return password; } public int getFetchSize() { return fetchSize; } public ZoneId getZoneId() { return zoneId; } public long getWaitToGetSessionTimeoutInMs() { return waitToGetSessionTimeoutInMs; } public boolean isEnableCompression() { return enableCompression; } public boolean isEnableCacheLeader() { return enableCacheLeader; } public int getConnectionTimeoutInMs() { return connectionTimeoutInMs; } public static class Builder { private String host = Config.DEFAULT_HOST; private int port = Config.DEFAULT_PORT; private List nodeUrls = null; private int maxSize = Config.DEFAULT_SESSION_POOL_MAX_SIZE; private String user = Config.DEFAULT_USER; private String password = Config.DEFAULT_PASSWORD; private int fetchSize = Config.DEFAULT_FETCH_SIZE; private long waitToGetSessionTimeoutInMs = 60_000; private boolean enableCompression = false; private ZoneId zoneId = null; private boolean enableCacheLeader = Config.DEFAULT_CACHE_LEADER_MODE; private int connectionTimeoutInMs = Config.DEFAULT_CONNECTION_TIMEOUT_MS; public Builder host(String host) { this.host = host; return this; } public Builder port(int port) { this.port = port; return this; } public Builder nodeUrls(List nodeUrls) { this.nodeUrls = nodeUrls; return this; } public Builder maxSize(int maxSize) { this.maxSize = maxSize; return this; } public Builder user(String user) { this.user = user; return this; } public Builder password(String password) { this.password = password; return this; } public Builder fetchSize(int fetchSize) { this.fetchSize = fetchSize; return this; } public Builder zoneId(ZoneId zoneId) { this.zoneId = zoneId; return this; } public Builder waitToGetSessionTimeoutInMs(long waitToGetSessionTimeoutInMs) { this.waitToGetSessionTimeoutInMs = waitToGetSessionTimeoutInMs; return this; } public Builder enableCompression(boolean enableCompression) { this.enableCompression = enableCompression; return this; } public Builder enableCacheLeader(boolean enableCacheLeader) { this.enableCacheLeader = enableCacheLeader; return this; } public Builder connectionTimeoutInMs(int connectionTimeoutInMs) { this.connectionTimeoutInMs = connectionTimeoutInMs; return this; } public SessionPool build() { if (nodeUrls == null) { return new SessionPool( host, port, user, password, maxSize, fetchSize, waitToGetSessionTimeoutInMs, enableCompression, zoneId, enableCacheLeader, connectionTimeoutInMs); } else { return new SessionPool( nodeUrls, user, password, maxSize, fetchSize, waitToGetSessionTimeoutInMs, enableCompression, zoneId, enableCacheLeader, connectionTimeoutInMs); } } } }