---
title: "OBKV-Table 开发准备 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: OBKV-Table 开发准备 本文档介绍了 OBKV-Table 的开发准备工作。在使用 OBKV-Table 客户端访问集群之前，需要进行创建租户、创建数据库、创建表、创建用户等操作。此外，OBKV-Table 支持直连和 ODP 两种连接模式，在不同的连接模式下需要进行的额外的准备工作也不相同。 注意 OBKV…
---
切换语言

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

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

# OBKV-Table 开发准备

更新时间：2026-04-15 16:01:32

[编辑](https://github.com/oceanbase/oceanbase-kv/edit/V4.3.5/zh-CN/100.obkv-table/200.use-of-the-obkv-table-client/50.obkv-table-develop-prerequisite.md)  

本文档介绍了 OBKV-Table 的开发准备工作。在使用 OBKV-Table 客户端访问集群之前，需要进行创建租户、创建数据库、创建表、创建用户等操作。此外，OBKV-Table 支持直连和 ODP 两种连接模式，在不同的连接模式下需要进行的额外的准备工作也不相同。

#### 注意

OBKV-Table 仅支持 Java 客户端。

## 通用的准备工作

### 创建租户

具体请参见 [创建租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013128)。

### 创建数据库

具体请参见 [创建数据库](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002015421)。

### 创建表

具体请参见 [创建表](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013234)。

### 创建用户

具体请参见 [创建用户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016103)。

## 直连模式下的额外准备工作

### 创建系统租户用户与路由表访问授权

OBKV-Table 直连模式下，客户端通过访问路由表获取到用户表的分区路由信息进行路由。在 OceanBase 中，只有 SYS 租户下的用户才有访问路由表的权限，因此需要在 SYS 租户下创建用户，并且赋予该用户路由表的访问权限。root 用户天然拥有路由表的访问权限。

#### 创建用户

创建用户的语法及示例请参见 [创建用户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016103)。

创建一个拥有最小数据库权限的用户 `test_sys_user` 的示例如下：

1. 通过 obclient 使用 root 用户连接 SYS 租户

   ```sql
   -h 表示主机地址
   -u 表示用户名
   -P 表示端口
   -p 表示密码
   -c 表示不使用自动补全功能，可以提高连接速度及减少不必要的系统资源消耗
   -A 表示连接到集群
   -D 表示连接到 SYS 租户
   obclient -h10.10.10.1 -uroot@$obkvcluster -P2883 -p****** -c -A -D SYS

   ```
 2. 创建用户

   ```sql
   CREATE USER 'test_sys_user'@'%' IDENTIFIED BY 'test_sys_password';

   ```

#### 路由表访问授权

用户需要拥有以下路由表的 SELECT 权限：

- __all_virtual_table
 - __all_virtual_proxy_schema
 - __all_tenant
 - __all_virtual_proxy_partition_info
 - __all_virtual_proxy_partition
 - __all_server
 - __all_virtual_proxy_sub_partition
 - __all_virtual_proxy_server_stat
 - DBA_OB_SERVERS
 - DBA_OB_ZONES
 - CDB_OB_TABLEGROUP_TABLES
 - DBA_OB_TENANTS
 - CDB_OB_TABLET_TO_LS

使用 SYS 租户连接数据库后，给用户 `test_sys_user` 授予指定路由表的 `SELECT` 权限。

```sql
GRANT SELECT ON oceanbase.__all_virtual_table TO test_sys_user;
GRANT SELECT ON oceanbase.__all_virtual_proxy_schema TO test_sys_user;
GRANT SELECT ON oceanbase.__all_tenant TO test_sys_user;
GRANT SELECT ON oceanbase.__all_virtual_proxy_partition_info TO test_sys_user;
GRANT SELECT ON oceanbase.__all_virtual_proxy_partition TO test_sys_user;
GRANT SELECT ON oceanbase.__all_server TO test_sys_user;
GRANT SELECT ON oceanbase.__all_virtual_proxy_sub_partition TO test_sys_user;
GRANT SELECT ON oceanbase.__all_virtual_proxy_server_stat TO test_sys_user;
GRANT SELECT ON oceanbase.DBA_OB_SERVERS TO test_sys_user;
GRANT SELECT ON oceanbase.DBA_OB_ZONES TO test_sys_user;
GRANT SELECT ON oceanbase.CDB_OB_TABLEGROUP_TABLES TO test_sys_user;
GRANT SELECT ON oceanbase.DBA_OB_TENANTS TO test_sys_user;
GRANT SELECT ON oceanbase.CDB_OB_TABLET_TO_LS TO test_sys_user;

```

 上一篇 下一篇 ![有帮助](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) 咨询热线