Java

安装 Java Development Kit(JDK)

请确认你的系统已经安装了 JDK 8 或者更高版本。更多关于如何检查你的 Java 版本和安装 JDK 的信息，请参考 Oracle Overview of JDK Installation documentation

创建项目

该指南演示了如何使用 Maven 添加 Java SDK 依赖项。建议使用集成开发环境（IDE）如 Intellij IDEA 或 Eclipse IDE 来更容易的配置 Maven 以构建和运行你的项目。 如果你没有在使用 IDE，请参考 Building Maven 来了解更多关于如何设置你的项目的信息。

添加 GreptiemDB Java SDK 作为依赖

如果你正在使用 Maven，请将以下内容添加到 pom.xml 的依赖项列表中：

  1. <dependencies>
  2.     <dependency>
  3.         <groupId>io.greptime</groupId>
  4.         <artifactId>greptimedb-all</artifactId>
  5.         <version>${latest_version}</version>
  6.     </dependency>
  7. </dependencies>

可以到这里查看最新的版本。

在配置完依赖后，请确保它们可以被你的项目使用，这可能需要在你的 IDE 中刷新项目或者运行依赖管理器。

连接数据库

现在创建一个文件 QuickStart.java 放在你的项目的基础包目录下。使用下面的示例代码来连接数据库，将 endpoints 变量的值替换为你实际的连接地址。

java

  1. package io.greptime.example;
  3. import io.greptime.GreptimeDB;
  4. import io.greptime.models.AuthInfo;
  5. import io.greptime.models.ColumnDataType;
  6. import io.greptime.models.Err;
  7. import io.greptime.models.QueryOk;
  8. import io.greptime.models.QueryRequest;
  9. import io.greptime.models.Result;
  10. import io.greptime.models.SelectExprType;
  11. import io.greptime.models.SelectRows;
  12. import io.greptime.models.SemanticType;
  13. import io.greptime.models.TableName;
  14. import io.greptime.models.TableSchema;
  15. import io.greptime.models.WriteOk;
  16. import io.greptime.models.WriteRows;
  17. import io.greptime.options.GreptimeOptions;
  18. import org.slf4j.Logger;
  19. import org.slf4j.LoggerFactory;
  20. import java.util.List;
  21. import java.util.Map;
  22. import java.util.concurrent.CompletableFuture;
  24. /**
  25.  * @author jiachun.fjc
  26.  */
  27. public class QuickStart {
  29.     private static final Logger LOG = LoggerFactory.getLogger(QuickStart.class);
  31.     public static void main(String[] args) throws Exception {
  32.         String endpoint = "127.0.0.1:4001";
  33.         AuthInfo authInfo = new AuthInfo("username", "password");
  34.         GreptimeOptions opts = GreptimeOptions.newBuilder(endpoint) //
  35.                 .authInfo(authInfo) // By default, no authentication is required; you can remove this line.
  36.                 .writeMaxRetries(1) //
  37.                 .readMaxRetries(2) //
  38.                 .routeTableRefreshPeriodSeconds(-1) //
  39.                 .build();
  41.         GreptimeDB greptimeDB = new GreptimeDB();
  43.         if (!greptimeDB.init(opts)) {
  44.             throw new RuntimeException("Fail to start GreptimeDB client");
  45.         }
  46.     }
  47. }

请前往 Java SDK in reference 获得更多的配置和指标信息。

写入数据

请参考 写入数据.

读取数据

请参考 读取数据.