Skip to content
On this page

Java SDK

The GreptimeDB Java SDK uses gRPC to communicate with the database. For more information on how to use the SDK, please refer to the Java SDK documentation.

To connect to GreptimeCloud, using information below:

  • Host: <host>
  • Port: 4001
  • Database: <dbname>
  • Username: <username>
  • Password: Your GreptimeCloud service password

The following code snippet shows how to create a client.

String endpoint = "<host>:4001";
AuthInfo authInfo = new AuthInfo("<username>", "*Your GreptimeCloud service password*");

GreptimeOptions opts = GreptimeOptions.newBuilder(endpoint) //
        .writeMaxRetries(1) //
        .readMaxRetries(2) //
        .routeTableRefreshPeriodSeconds(-1) //

GreptimeDB greptimeDB = new GreptimeDB();

if (!greptimeDB.init(opts)) {
    throw new RuntimeException("Fail to start GreptimeDB client");

After creating a GreptimeDB client, you can set database while writing data or querying data. For example query data:

QueryRequest request = QueryRequest.newBuilder() //
        .exprType(SelectExprType.Sql) //
        .ql("SELECT * FROM monitor;") //
        .databaseName("<dbname>") //