---
title: "基本操作 | OceanBase 文档中心"
description: "基本操作 查看版本 ODP 安装后，有以下三种方法可以确定 ODP 的版本： 新版本 ODP 的目录会带版本号，如 obproxy-3.2.3 目录名表示 3.2.3 版本的 ODP 在 ODP 的目录下执行 ./bin/obproxy -V 可查看该 ODP 的版本，以 V4.0.0 为例： [admin@test…"
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*nSAhQbrBXKwAAAAAAAAAAAAADiGDAQ/original) 数据库代理 V 4.0.0 社区版

# 基本操作

更新时间：2026-07-22 14:20:56

[编辑](https://github.com/oceanbase/oceanbase-proxy-doc/edit/V4.0.0/zh-CN/300.basic-operation.md)  

## 查看版本

ODP 安装后，有以下三种方法可以确定 ODP 的版本：

1. 新版本 ODP 的目录会带版本号，如 `obproxy-3.2.3` 目录名表示 3.2.3 版本的 ODP
 2. 在 ODP 的目录下执行 `./bin/obproxy -V` 可查看该 ODP 的版本，以 V4.0.0 为例：

   ```bash
   [admin@test obproxy]# ./bin/obproxy -V
   ./bin/obproxy -V
   obproxy (OceanBase 4.0.0 5)
   REVISION: 1-local-9d5c90e562c61d9fcf8894993187aa20239db47e
   BUILD_TIME: Oct 28 2022 23:01:19

   ```
 3. 使用 `root@proxysys` 账号登录 ODP 后，执行 `show proxyinfo binary` 可查看该 ODP 的版本，以 V4.0.0 为例：

   ```sql
   MySQL [(none)]> show proxyinfo binary\G
   *************************** 1. row ***************************
   name: binary info
   info: ObProxy-OceanBase 4.0.0-5
   version:RELEASE_UNKNOWN
   MD5:
   REVISION:1-local-9d5c90e562c61d9fcf8894993187aa20239db47e
   BUILD_TIME:Oct 28 2022 23:01:19

   ```

## 连接 OceanBase

您可通过如下命令使用 OBClient 或 MySQL 客户端连接 OceanBase 集群：

```bash
obclient -h<obproxy_ip> -u<user> -P<obproxy_port> -p<obproxy_pwd>
或
mysql -h<obproxy_ip> -u<user> -P<obproxy_port> -p<obproxy_pwd>

# 示例
obclient -h10.10.10.1 -uroot@sys#obcluster -P2883 -p******

```

说明：

- `-h`：提供 OceanBase 数据库连接 IP，这里需是一个 ODP 的 IP 地址。
 - `-u`：提供租户的连接账户，格式有两种：`用户名@租户名#集群名` 或者 `集群名:租户名:用户名`。
 - `-P`：提供 OceanBase 数据库连接端口，也就是 ODP 的监听端口，默认是 2883，可以自定义。
 - `-p`：提供账户密码，为了安全可以不提供，改为在后面提示符下输入，密码文本不可见。

## ODP 重启

ODP 的进程退出后，obproxyd.sh 将在 1s 内重新拉起，有时根本察觉不到 ODP 退出过。在生产环境，该机制可以快速恢复服务，起到止血作用。

若想要手动重启，可先使用 `kill` 命令将 obproxy 进程停止，因为第一次启动后，就会在 `etc` 和 `.conf` 目录下生成配置文件并将配置信息持久化，所以直接执行 `./bin/obproxy` 命令启动即可完成重启。

如果还想用默认配置，需要执行 `rm -rf etc .conf` 删除持久化的配置信息，然后执行首次启动命令。

ODP 中可以通过查询启动时间确认是否重启过，查看启动时间的方法有很多，可通过日志 `succ to init logger` 确定启动时间，该日志只在启动时打印一次，也可通过如下命令查看启动时间：

```bash
[admin@test ~]$ ls -l /proc/`pidof obproxy` -d
dr-xr-xr-x 158 root root 0 Nov  7 17:17 /proc/

```

## 目录介绍

ODP 的目录结构如下：

```bash
[admin@test obproxy]$ ls -alrt
total 44
-rw-r--r--  1 admin admin  910 Nov  8 16:33 obproxyd.sh
drwxrwxr-x  2 admin admin 4096 Nov  9 15:05 lib
drwxr-xr-x  6 admin admin 4096 Nov  9 15:05 ..
drwxrwxr-x  2 admin admin 4096 Nov  9 15:05 bin
drwxrwxr-x  2 admin admin 4096 Nov  9 15:06 sharding-config
drwxrwxr-x  2 admin admin 4096 Nov  9 15:06 control-config
drwxrwxr-x  2 admin admin 4096 Nov  9 15:06 log
drwxrwxr-x 10 admin admin 4096 Nov  9 15:06 .
drwxrwxr-x  2 admin admin 4096 Nov 12 17:46 run
drwxrwxr-x  2 admin admin 4096 Nov 12 17:46 etc
drwxrwxr-x  2 admin admin 4096 Nov 12 17:46 .conf

```

比较重要的目录和文件包括：

- `obproxyd.sh`：守护脚本，内容简单，大家可以通过阅读脚本代码了解实现原理
 - `bin` 目录：保存 ODP 的二进制文件
 - `sharding-config` 目录：保存 Sharding 相关的配置文件
 - `log` 目录：保存日志文件的目录，磁盘占用最大，日志文件也分为多种，帮助排查定位问题
 - `etc` 和 `.conf` 目录：保存配置信息，其中 `.conf` 是 `etc` 的备份，如果 `etc` 目录被删除，会使用 `.conf` 中的内容

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