使用 OBKV-Table Java 客户端连接集群

OBKV-Table 是 OceanBase 针对 NOSQL 场景推出的一种 OBServer 服务端的访问模式。本篇将简单介绍如何使用客户端 ob_table_client_java 进行接口访问。

客户端简介

总体上看，应用层可通过 OBKV-Table 或 SQL 两种方式访问到 OBServer 节点，分别对应 NOSQL 模式和 SQL 模式。

NOSQL 模式下，客户端接口 JavaClient 通过 RPC 协议与 OBServer 节点通信，同时客户端支持丰富多样的操作函数，功能上基本可以满足大部分场景的需求。

相比于 SQL 模式，整体流程上，OBKV-Table 并没有复杂的 SQL 语法语义等繁琐的解析以及生成执行计划等过程，但却具有与 SQL 模式几乎同等的事务以及存储能力，使用起来相对简单。整体流程图如下：

准备工作

使用 OBKV-Table 客户端连接 OBKV-Table 集群进行数据处理之前，请确保您已经完成如下准备工作：

• 已经部署了 OceanBase 集群。关于支持的部署方案、部署方式以及详细的部署操作，参见 部署简介。
• 已经创建了 MySQL 租户。关于创建租户的详细操作，参见 创建租户。
• 已经创建了数据库。关于创建数据库的详细操作，参见 创建数据库。
• 已经创建了 OBKV-Table 数据表。关于创建 OBKV-Table 数据表的详细操作，参见 数据库模式设计。

建表示例如下。

CREATE TABLE IF NOT EXISTS `test_varchar_table_00` (
    `c1` varchar(20) NOT NULL,
    `c2` varchar(20) DEFAULT NULL,
    `c3` varchar(20) DEFAULT NULL,
    PRIMARY KEY (`c1`)
);

引入 maven obkv-table-client 依赖

登录到 obkv java 客户端仓库，获取当前最新客户端版本，并添加到 pom.xml 文件中。

后续操作

• 可以根据需要设置客户端的相关参数，参数的详细介绍参见 客户端参数设置。
• 使用客户端通过支持的接口操作数据，关于接口的详细介绍参见 客户端支持的接口。
• 使用客户端的示例参见 客户端使用示例。