---
title: "使用 OBKV-Table Java 客户端连接集群 - OceanBase 数据库 V4.3.3 | OceanBase 文档中心"
description: 使用 OBKV-Table Java 客户端连接集群 OBKV-Table 是 OceanBase 针对 NOSQL 场景推出的一种 OBServer 服务端的访问模式。本篇将简单介绍如何使用客户端 ob_table_client_java 进行接口访问。 说明 OBKV-Table 仅支持 Java 客户端。 客户…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库KV 型 - V 4.3.3

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

更新时间：2025-12-02 17:36:38

[编辑](https://github.com/oceanbase/oceanbase-kv/edit/V4.3.3/zh-CN/100.obkv-table/200.use-of-the-obkv-table-client/100.introduction-to-the-obkv-table-client-and-instructions-of-use.md)  

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

#### 说明

OBKV-Table 仅支持 Java 客户端。

## 客户端简介

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

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

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

![OBKV-Table client](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.1/700.reference/1500.command-line-tools/900.ob-agent/TableAPI-client.png)

## 准备工作

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

- 已经部署了 OceanBase 集群。关于支持的部署方案、部署方式以及详细的部署操作，参见 [部署简介](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001428586)。
 - 已经创建了 MySQL 租户。关于创建租户的详细操作，参见 [创建租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001428978)。
 - 已经创建了数据库。关于创建数据库的详细操作，参见 [创建数据库](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001431012)。
 - 已经创建了 OBKV-Table 数据表。关于创建 OBKV-Table 数据表的详细操作，参见 [数据库模式设计](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001544699)。

建表示例如下。

```sql
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 客户端仓库](https://github.com/oceanbase/obkv-table-client-java)，获取当前最新客户端版本，并添加到 pom.xml 文件中。

## 后续操作

- 可以根据需要设置客户端的相关参数，参数的详细介绍参见 [客户端参数设置](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001544693)。
 - 使用客户端通过支持的接口操作数据，关于接口的详细介绍参见 [客户端支持的接口](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001544694)。
 - 使用客户端的示例参见 [客户端使用示例](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001544692)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线