---
title: "基本操作 - 数据库代理  V4.3.2 | OceanBase 文档中心"
description: "基本操作 查看版本 ODP 安装后，有以下三种方法可以确定 ODP 的版本： 新版本 ODP 的目录会带版本号，如 obproxy-4.0.0 目录名表示 4.0.0 版本的 ODP 在 ODP 的 home 目录下执行 ./bin/obproxy -V 可查看该 ODP 的版本，以 V3.2.3 为例： [admi…"
---
切换语言

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

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

# 基本操作

更新时间：2026-04-14 17:41:09

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

## 查看版本

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

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

   ```bash
   [admin@test obproxy]# ./bin/obproxy -V
   ./bin/obproxy -V
   obproxy (OceanBase 3.2.3 2)
   REVISION: 6-local-99faebfc7130b70ad0f56330a28cab6a32ec9a33
   BUILD_TIME: Mar 30 2022 01:53:08

   ```
 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-20221103165243.el7
   version:RELEASE_7U
   MD5:
   REVISION:20221103165243-7c7e5821009b2d3924d1bc7a8165edf7384f6ed3
   BUILD_TIME:Nov  3 2022 16:57:16

   ```

## 连接 OceanBase 数据库

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

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

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

```

说明：

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

  #### 说明

  Hint 是特殊的注释，不受 `-c` 影响。
 - `-A`：表示在 OBClient 连接数据库时不自动获取统计信息。

## ODP 重启

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

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

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

### 操作步骤

1. 使用启动 ODP 进程的用户登录到 obproxy 进程所在机器
 2. 执行如下命令查看 obproxy 进程的进程号

   ```shell
   -bash-4.2$ ps -ef | grep obproxy

   ```

   输出如下，obproxy 进程号为 37360。

   ```shell
   admin     37360      0  6 11:35 ?        00:00:09 bin/obproxy
   admin     43055  36750  0 11:37 pts/10   00:00:00 grep --color=auto obproxy
   root      85623      1  0 Jun02 ?        00:15:19 /home/admin/ocp_agent/obagent/obstat2 -o http://xx.xx.xx.xx:81 -c test323 __obproxy__ -f 20

   ```
 3. 执行如下命令，根据查询到的进程号，停止 obproxy 进程

   ```shell
   -bash-4.2$ kill -9 37360

   ```
 4. 停止成功后，再次查询 obproxy 进程的进程号，确认 obproxy 进程是否已不存在

   ```

   输出如下，obproxy 进程已不存在。

   ```shell
   admin     43055  36750  0 11:37 pts/10   00:00:00 grep --color=auto obproxy
   root      85623      1  0 Jun02 ?        00:15:19 /home/admin/ocp_agent/obagent/obstat2 -o http://xx.xx.xx.xx:81 -c test323 __obproxy__ -f 20

   ```
 5. 根据实际情况选择如下任一方式启动 obproxy 进程

      - 若想参照上次启动的配置进行启动，在 ODP 家目录下直接执行 `./bin/obproxy` 命令启动即可完成重启。
      - 若想重新进行配置并启动，需在 ODP 家目录下执行 `rm -rf etc .conf` 删除持久化的配置信息，之后执行启动命令。详细的启动方法可参考 [通过命令行部署 ODP](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000001600961) 中 **启动 ODP** 部分内容。
 6. 验证是否重启

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

   ```bash
   -bash-4.2$ ls -l /proc/`pidof obproxy` -d
   dr-xr-xr-x 8 admin admin 0 Nov 14 14:18 /proc/118273

   ```

## 目录介绍

ODP 的目录结构如下：

```bash
-bash-4.2$ ls -alrt
total 48
-rw-r--r-- 1 admin admin 14245 Nov  3 16:57 start_obproxy.sh
drwxr-xr-x 2 admin admin  4096 Nov 14 14:15 bin
drwxr-xr-x 2 admin admin  4096 Nov 14 14:15 tools
lrwxrwxrwx 1 admin admin    28 Nov 14 14:15 log -> /home/admin/logs/obproxy/log
lrwxrwxrwx 1 admin admin    33 Nov 14 14:15 minidump -> /home/admin/logs/obproxy/minidump
drwxr-xr-x 1 root  root   4096 Nov 14 14:16 ..
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 sharding-config
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 control-config
drwxr-xr-x 8 admin admin  4096 Nov 14 14:18 .
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 etc
drwxrwxr-x 2 admin admin  4096 Nov 14 14:18 .conf

```

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

- `start_obproxy.sh`：守护脚本，内容简单，大家可以通过阅读脚本代码了解实现原理，使用 obd 部署的 ODP 中守护脚本为 obproxyd.sh
 - `bin` 目录：保存 ODP 的二进制文件
 - `log` 目录：保存日志文件的目录，磁盘占用最大，日志文件也分为多种，帮助排查定位问题
 - `sharding-config` 目录：保存 Sharding 相关的配置文件
 - `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) 咨询热线