Lindorm:インターフェース

データベース管理とテーブル管理の例

DDL 操作を実行して、データベースまたはテーブルの作成、削除、およびクエリを実行できます。次のコマンドを使用して、スキーマ制約ポリシーを弱い制約に設定できます。

// 1. 既存のデータベースをクエリします。
String showDatabase = "show databases";
Result result = lindormTSDBClient.execute(showDatabase);
System.out.println("before create, db list: " +  result.getRows().stream().map(e -> (String) e.get(0)).collect(Collectors.toList()));

// 2. データベースを作成します。この例では、demo という名前のデータベースが作成されます。
String createDatabase = "create database demo";
result = lindormTSDBClient.execute(createDatabase);
System.out.println("create database:" + result.isSuccessful());

// 3. 既存のデータベースをクエリします。
result = lindormTSDBClient.execute(showDatabase);
System.out.println("after create, db list: " +  result.getRows().stream().map(e -> (String) e.get(0)).collect(Collectors.toList()));

String database = "demo";

// 4. 既存のすべてのテーブルをクエリします。
String showTables = "show tables";
result = lindormTSDBClient.execute(database, showTables);
System.out.println("before create, table list: " +  result.getRows().stream().map(e -> (String) e.get(0)).collect(Collectors.toList()));

// 5. テーブルを作成します。
String createTable = "CREATE TABLE sensor (device_id VARCHAR TAG,region VARCHAR TAG,time BIGINT,temperature DOUBLE,humidity DOUBLE,PRIMARY KEY(device_id))";
result = lindormTSDBClient.execute(database, createTable);
System.out.println("create table: " + result.isSuccessful());

// 6. 既存のテーブルをクエリして、テーブル sensor が作成されているかどうかを確認します。
result = lindormTSDBClient.execute(database, showTables);
System.out.println("after create, table list: " +  result.getRows().stream().map(e -> (String) e.get(0)).collect(Collectors.toList()));

// 7. テーブルに関する詳細情報をクエリします。
String describeTable = "describe table sensor";
result = lindormTSDBClient.execute(database, describeTable);
System.out.println("------------ describe table -------------------");
List<String> columns = result.getColumns();
System.out.println("columns: " + columns);
List<String> metadata = result.getMetadata();
System.out.println("metadata: " + metadata);
List<List<Object>> rows = result.getRows();
for (int i = 0, size = rows.size(); i < size; i++) {
    List<Object> row = rows.get(i);
    System.out.println("column #" + i + " : " + row);
}

System.out.println("------------ describe table -------------------");
// 8. テーブルを削除します。
String dropTable = "drop table sensor";
result = lindormTSDBClient.execute(database, dropTable);
System.out.println("drop table: " + result.isSuccessful());

// 9. 既存のテーブルをクエリして、テーブルが削除されているかどうかを確認します。
result = lindormTSDBClient.execute(database, showTables);
System.out.println("after drop, table list: " +  result.getRows().stream().map(e -> (String) e.get(0)).collect(Collectors.toList()));

// 10. データベースを削除します。
String dropDatabase = "drop database demo";
result = lindormTSDBClient.execute(dropDatabase);
System.out.println("drop database:" + result.isSuccessful());

// 11. 既存のデータベースをクエリして、データベースが削除されているかどうかを確認します。
result = lindormTSDBClient.execute(showDatabase);
System.out.println("after drop, db list : " +  result.getRows().stream().map(e -> (String) e.get(0)).collect(Collectors.toList()));

サンプル結果：

before create, db list: [default]
create database:true
after create, db list: [default, demo]
before create, table list: []
create table: true
after create, table list: [sensor]
------------ describe table -------------------
columns: [columnName, typeName, columnKind]
metadata: [VARCHAR, VARCHAR, VARCHAR]
column #0 : [device_id, VARCHAR, TAG]
column #1 : [region, VARCHAR, TAG]
column #2 : [time, TIMESTAMP, TIMESTAMP]
column #3 : [temperature, DOUBLE, FIELD]
column #4 : [humidity, DOUBLE, FIELD]
------------ describe table -------------------
drop table: true
after drop, table list: []
drop database:true
after drop, db list : [default]

書き込み操作レコード

LindormTSDB SDK は、Record オブジェクトを使用して、テーブルに書き込まれる行に関する情報を格納します。 Record オブジェクトには、テーブル名、タイムスタンプ、タグ、フィールド名、およびフィールド値を指定する必要があります。タイムスタンプとタグは、インデックスの作成に使用されます。

デフォルトでは、LindormTSDB SDK は、Record オブジェクトを作成するときに文字の有効性を検証します。 build() メソッドでパラメーター 'false' を指定できます。

Record record = Record
    // テーブルの名前。
    .table("sensor")
    // ミリ秒単位のタイムスタンプ。
    .time(currentTime)
    // タグ。
    .tag("device_id", "F07A1260")
    .tag("region", "north-cn")
    // フィールド名とフィールド値。
    .addField("temperature", 12.1)
    .addField("humidity", 45.0)
    .build();

CompletableFuture オブジェクトを使用して書き込み結果を処理するインターフェース

• 書き込み操作レコードを一度に 1 つだけ送信します。

// デフォルトのデータベースに書き込みます。
CompletableFuture<WriteResult> future = lindormTSDBClient.write(record);

// 指定されたデータベースにデータを書き込みます。
String database = "demo";
CompletableFuture<WriteResult> future = lindormTSDBClient.write(database, record);

• 複数の書き込み操作レコードをバッチで送信します。このメソッドを使用することをお勧めします。このメソッドを使用すると、LindormTSDB SDK を使用してタスクを送信するときに、非同期キューの保留中のタスクで発生するロック競合の問題を軽減できます。

List<Record> records;
// デフォルトのデータベースにデータを書き込みます。
CompletableFuture<WriteResult> future = lindormTSDBClient.write(records);

// 指定されたデータベースにデータを書き込みます。
String database = "demo";
CompletableFuture<WriteResult> future = lindormTSDBClient.write(database, records);

• CompletableFuture<WriteResult> オブジェクトによって返された結果を処理します。次のコードブロックは例を示しています。ビジネス要件に基づいて、CompletableFuture オブジェクトの他のメソッドを呼び出すことができます。

CompletableFuture<WriteResult> future = lindormTSDBClient.write(records);
// 非同期書き込み結果を処理します。
future.whenComplete((r, ex) -> {
    if (ex != null) { // 送信例外が発生します。ほとんどの場合、書き込み操作が失敗したために例外が返されます。
        System.out.println("Failed to write.");
        Throwable throwable = ExceptionUtils.getRootCause(ex);
        if (throwable instanceof LindormTSDBException) {
            LindormTSDBException e = (LindormTSDBException) throwable;
            System.out.println("Caught an LindormTSDBException, which means your request made it to Lindorm TSDB, "
                               + "but was rejected with an error response for some reason.");
            System.out.println("Error Code: " + e.getCode());
            System.out.println("SQL State:  " + e.getSqlstate());
            System.out.println("Error Message: " + e.getMessage());
        }  else {
            throwable.printStackTrace();
        }
    } else  { // 書き込み操作は成功です。
        if (r.isSuccessful()) {
            System.out.println("Write successfully.");
        } else {
            System.out.println("Write failure.");
        }
    }
});

コールバック関数を使用して非同期書き込み結果を処理するインターフェース

• 次のコードブロックは、書き込みコールバックを示しています。 onCompletion メソッドの result パラメーターは書き込み結果を示し、records パラメーターはコールバックに対応する書き込み操作レコードを示し、e パラメーターは書き込み操作の失敗時にスローされる例外を示します。

public interface Callback {
    void onCompletion(WriteResult result, List<Record> records, Throwable e);
}

次の例は、コールバックを使用して書き込み結果を処理する方法を示しています。

Callback callback =  new Callback() {
    @Override
    public void onCompletion(WriteResult result, List<Record> list,
                             Throwable throwable) {
        if (throwable != null) { // 書き込み操作の失敗。
            if (throwable instanceof LindormTSDBException) {
                LindormTSDBException ex = (LindormTSDBException) throwable;
                System.out.println("errorCode: " + ex.getCode());
                System.out.println("sqlstate: " + ex.getSqlstate());
                System.out.println("message: " + ex.getMessage());
            } else {
                // その他のエラー。
                throwable.printStackTrace();
            }
        } else {
            if (result.isSuccessful()) {
                System.out.println("Write successfully.");
            } else {
                System.out.println("Write failure.");
            }
        }
    }
};

• 書き込み操作レコードを一度に 1 つだけ送信します。

// デフォルトのデータベースにデータを書き込みます。
lindormTSDBClient.write(record, callback);

// 指定されたデータベースにデータを書き込みます。
String database = "demo";
lindormTSDBClient.write(database, record, callback);

• 複数の書き込み操作レコードをバッチで送信します。このメソッドを使用することをお勧めします。このメソッドを使用すると、LindormTSDB SDK を使用してタスクを送信するときに、非同期キューの保留中のタスクで発生するロック競合の問題を軽減できます。

List<Record> records;
// デフォルトのデータベースにデータを書き込みます。
lindormTSDBClient.write(records, callback);

// 指定されたデータベースにデータを書き込みます。
String database = "demo";
lindormTSDBClient.write(database, records, callback);