--- title: "体验 OceanBase 数据库 | OceanBase 文档中心" description: 体验 OceanBase 数据库 本文以单机安装 OceanBase 数据库为例指导您如何快速使用 OceanBase 数据库。 注意 本文中的方法仅适用于 OceanBase 数据库快速上手体验，不适用生产环境，如需在生产环境中部署 OceanBase 数据库，请参考 部署 OceanBase 社区版 章节。 组件… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.0.0 社区版 # 体验 OceanBase 数据库 更新时间：2026-06-02 18:22:41 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.0.0/zh-CN/200.quick-start/000.Quickly-experience-OceanBase.md) 本文以单机安装 OceanBase 数据库为例指导您如何快速使用 OceanBase 数据库。 #### 注意 本文中的方法仅适用于 OceanBase 数据库快速上手体验，不适用生产环境，如需在生产环境中部署 OceanBase 数据库，请参考 [部署 OceanBase 社区版](https://www.oceanbase.com/docs/community-observer-cn-10000000000901208) 章节。 ## 组件介绍 - OBD OceanBase Deployer，OceanBase 安装部署工具，简称为 OBD。详细信息请参考 [OBD 文档](https://www.oceanbase.com/docs/obd-cn)。 - ODP OceanBase Database Proxy，OceanBase 数据库代理，是 OceanBase 数据库专用的代理服务器，简称为 ODP（又称为 OBProxy）。详细信息请参考 [ODP 文档](https://www.oceanbase.com/docs/odp-cn)。 - OBAgent OBAgent 是 OceanBase 数据库监控采集框架，支持推、拉两种数据采集模式，可以满足不同的应用场景。详细信息可参见 [OBAgent](https://www.oceanbase.com/docs/community-observer-cn-10000000000901418) 章节。 - Grafana Grafana 是一款开源的数据可视化工具，它可以将数据源中的各种指标数据进行可视化展示，以便更直观地了解系统运行状态和性能指标。详细信息可参见 [Grafana 官网](https://grafana.com/)。 - Prometheus Prometheus 是一个开源的服务监控系统和时序数据库，其提供了通用的数据模型以及快捷数据采集、存储和查询接口。详细信息可参见 [Prometheus 官网](https://prometheus.io/)。 ## 前提条件 在参考本文安装 OceanBase 数据库之前，确保您的软硬件环境满足以下要求： | 项目 | 描述 | | --- | --- | | 系统 | - Alibaba Cloud Linux 2/3 版本（内核 Linux 3.10.0 版本及以上） - Anolis OS 8.X 版本（内核 Linux 3.10.0 版本及以上） - Red Hat Enterprise Linux Server 7.X 版本、8.X 版本（内核 Linux 3.10.0 版本及以上） - CentOS Linux 7.X 版本、8.X 版本（内核 Linux 3.10.0 版本及以上） - Debian 9.X 版本及以上版本（内核 Linux 3.10.0 版本及以上） - Ubuntu 20.X 版本及以上版本（内核 Linux 3.10.0 版本及以上） - SUSE / OpenSUSE 15.X 版本及以上版本（内核 Linux 3.10.0 版本及以上） - KylinOS V10 版本 - 统信 UOS 1020a/1021a/1021e/1001c 版本 - 中科方德 NFSChina 4.0 版本及以上 - 浪潮 Inspur kos 5.8 版本 | | CPU | 测试环境最低要求 2 核，推荐 4 核及以上。 | | 内存 | 最低要求 8 GB，推荐设置在 16 GB 至 1024 GB 范围内。 | | 磁盘类型 | 使用 SSD 存储。 | | 磁盘存储空间 | 最低要求 54 GB。 | | 文件系统 | EXT4 或 XFS，当数据超过 16T 时，使用 XFS。 | | Docker | 使用 Docker 部署 OceanBase 数据库时需提前安装 Docker 并启动 Docker 服务，详细操作请参考 [Docker 文档](https://docs.docker.com/get-docker/)。 #### 说明 在使用 x86 架构的 MAC 机器中，仅支持使用 V4.9.0 及以下版本的 Docker 部署 OceanBase 数据库，可点击 [链接](https://desktop.docker.com/mac/main/amd64/81317/Docker.dmg?_gl=17jelfd_gcl_auOTk5Nzk0MDUwLjE3MTE4ODMyNzM._gaNDQyMjE1MDE5LjE3MTE4ODMyNzQ._ga_XJWPQMJYHQ*MTcxOTIxOTEwMy4xMS4xLjE3MTkyMjEwMTAuNjAuMC4w) 下载 Docker。 | #### 说明 以下内容以 x86 架构的 CentOS Linux 7.9 镜像作为环境，其他环境可能略有不同。 ## 使用 OBD 部署 OceanBase 数据库 ### 步骤 1：下载并安装 all-in-one package 从 V4.0.0 开始，OceanBase 提供统一的安装包 all-in-one package。您可以通过这个统一的安装包一次性完成 OBD、OceanBase 数据库、ODP、OBAgent、Grafana 和 Prometheus 的安装；您可以根据实际需求选择部分组件安装或者指定组件的版本。all-in-one package 提供了两种安装方式。 #### 在线安装 all-in-one package 执行以下命令，可以在线下载并安装 all-in-one package ```bash bash -c "$(curl -s https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/download-center/opensource/oceanbase-all-in-one/installer.sh)" ``` #### 离线安装 all-in-one package 1. 从 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter) 下载最新的 all-in-one 安装包，并将其上传到机器的任一目录下。 2. 在安装包所在目录下执行以下命令解压安装包并安装。 ```shell [admin@test001 ~]$ tar -xzf oceanbase-all-in-one-*.tar.gz [admin@test001 ~]$ cd oceanbase-all-in-one/bin/ [admin@test001 bin]$ ./install.sh [admin@test001 bin]$ source ~/.oceanbase-all-in-one/bin/env.sh ``` #### 说明 安装后您可执行 `which obd` 或 `which obclient` 检测是否安装成功，成功安装的情况下会输出 oceanbase-all-in-one 下的 OBD 和 OBClient 路径 ### 步骤 2：使用 obd demo 快速部署单机体验环境 1. 执行 obd demo 命令部署 OceanBase 数据库 ```shell [admin@test001 ~]$ obd demo ``` `obd demo` 命令默认在当前用户家目录下以最小规格部署并启动 OceanBase 数据库及相关组件（包括 ODP、OBAgent、Grafana 和 Prometheus），固定部署名为 `demo`。如需更多定制化的部署形式，参见 [快速部署命令](https://www.oceanbase.com/docs/community-obd-cn-10000000001690698)。 您也可以使用 OBD 命令管理该 OceanBase 数据库，详细命令介绍请参考 [集群命令组](https://www.oceanbase.com/docs/community-obd-cn-10000000001690699)。 #### 说明 当安装 grafana 或 prometheus 时，会输出 grafana 或 prometheus 的访问地址。在阿里云或其他云环境下，可能出现因无法获取公网 IP 而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址。 2. 执行输出中的连接命令连接数据库 `obd demo` 命令成功执行后会输出通过 OBClient 连接 OceanBase 数据库的命令，示例如下。 - 通过 2881 端口直连数据库 ```shell [admin@test001 ~]$ obclient -h127.0.0.1 -P2881 -uroot@sys -Doceanbase -A ``` - 通过 ODP 代理访问数据库 ```shell [admin@test001 ~]$ obclient -h127.0.0.1 -P2883 -uroot@sys -Doceanbase -A ``` 使用 OBClient 客户端连接 OceanBase 集群的详细操作可参考 [通过 OBClient 连接 OceanBase 数据库](https://www.oceanbase.com/docs/community-observer-cn-10000000000900907)。 3. （可选）配置密码 使用 `obd demo` 命令快速部署 OceanBase 数据库后，您可参考如下步骤为 demo 集群配置密码。 1. 修改配置文件 ```shell obd cluster edit-config demo ``` 执行上述命令打开配置文件后，在配置文件中 oceanbase-ce 组件下添加 `root_password: xxxx`，添加完成后保存退出。示例如下： ```yaml oceanbase-ce: servers: - 127.0.0.1 global: home_path: /home/admin/oceanbase-ce ... # 省略部分配置项 log_disk_size: 13G root_password: ****** ``` 2. 重启集群 修改并保存配置文件后，OBD 会输出待执行的重启命令，直接复制执行即可，示例如下。 ```shell [admin@test001 ~]$ obd cluster edit-config demo Search param plugin and load ok Search param plugin and load ok Parameter check ok Save deploy "demo" configuration Use `obd cluster reload demo` to make changes take effect. Trace ID: 29dd12fa-3d73-11ee-91bc-00163e01cd7a If you want to view detailed obd logs, please run: obd display-trace 29dd12fa-3d73-11ee-91bc-00163e01cd7a ``` 从输出可以看出，修改配置文件中 root@sys 用户密码后，需执行 `obd cluster reload demo` 命令重启 demo 集群。 ## 使用 Docker 部署 OceanBase 数据库 您可参考本节内容在 Docker 容器里启动 OceanBase 数据库，帮助您快速了解 OceanBase 数据库。 ### （可选）步骤一：拉取 OceanBase 数据库镜像 运行如下命令，拉取 OceanBase 数据库所需镜像。 - 搜索 OceanBase 数据库相关镜像 ```shell [admin@test001 ~]$ docker search oceanbase ``` - 拉取 OceanBase 数据库最新镜像 ```shell [admin@test001 ~]$ docker pull oceanbase/oceanbase-ce ``` #### 说明 上述命令默认拉取最新版本，可根据实际需求在 [Docker 镜像](https://hub.docker.com/r/oceanbase/oceanbase-ce/tags) 中选择版本。 ### 步骤二：启动 OceanBase 数据库实例 运行如下命令，启动 OceanBase 数据库实例。 - 根据当前容器部署最大规格实例 ```shell [admin@test001 ~]$ sudo docker run -p 2881:2881 --name obstandalone -e MODE=normal -d oceanbase/oceanbase-ce ``` - 部署 mini 的独立实例 ```shell [admin@test001 ~]$ sudo docker run -p 2881:2881 --name obstandalone -e MODE=mini -d oceanbase/oceanbase-ce ``` 其中： - `--name` 用于设置 Docker 容器名称，比如示例中创建一个名为 `obstandalone` 的 Docker 容器。 - `-e` 用于设置环境变量，其中 `MODE` 用于设置 OceanBase 数据库的部署规格。 启动预计需要 2~5 分钟。执行以下命令，如果返回 `boot success!`，则表示启动成功。 ```shell [admin@test001 ~]$ sudo docker logs obstandalone | tail -1 boot success! ``` ### 步骤三：连接 OceanBase 数据库实例 oceanbase-ce 镜像安装了 OBD（OceanBase Deployer，OceanBase 安装部署工具）和 OBClient（OceanBase 命令行客户端）。您可选择进入容器，使用 OBD 命令管理和 OBClient 客户端连接实例，也可使用宿主机本地 OBClient 或 MySQL 客户端连接到 OceanBase 数据库实例。 #### 进入容器后连接 1. 进入 Docker 容器 ```shell [admin@test001 ~]$ sudo docker exec -it obstandalone bash ``` 2. 查看集群详情 ```shell # 查看集群列表 obd cluster list # 查看 obcluster 集群详情 obd cluster display obcluster ``` 3. 连接集群 ```shell obclient -h127.0.0.1 -uroot@sys -A -Doceanbase -P2881 -p ``` #### 使用宿主机本地客户端连接 您可选择使用宿主机本地 OBClient 或 MySQL 客户端连接到 OceanBase 数据库实例，示例如下： ```shell [admin@test001 ~]$ obclient -uroot@sys -h127.0.0.1 -P2881 -p ``` 连接成功后，终端将显示如下内容： ```shell Welcome to the OceanBase. Commands end with ; or \g. Your OceanBase connection id is 3221487727 Server version: 5.7.25 OceanBase 4.0.0 (r10100032022041510-a09d3134c10665f03fd56d7f8bdd413b2b771977) (Built Oct 15 2022 02:16:22) Copyright (c) 2000, 2022, OceanBase and/or its affiliates. All rights reserved. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. obclient [(none)]> ``` 上一篇 下一篇 ![有帮助](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) 咨询热线