--- title: "快速体验 OceanBase | OceanBase 文档中心" description: 快速体验 OceanBase 本文介绍如何快速安装部署并体验 OceanBase 数据库。 注意 本文中的方法仅适用于 OceanBase 数据库快速上手体验，不适用生产环境，如需在生产环境中部署 OceanBase 数据库，请参考 安装部署 章节。 前提条件 在参考本文安装 OceanBase 数据库之前，确保您的… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.1.5 社区版 # 快速体验 OceanBase 更新时间：2026-05-26 08:51:27 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.5/zh-CN/100.users-guide/200.Get-started-quickly/000.Quickly-experience-OceanBase.md) 本文介绍如何快速安装部署并体验 OceanBase 数据库。 #### 注意 本文中的方法仅适用于 OceanBase 数据库快速上手体验，不适用生产环境，如需在生产环境中部署 OceanBase 数据库，请参考 [安装部署](https://www.oceanbase.com/docs/community-observer-cn-1000000000050452) 章节。 ## 前提条件 在参考本文安装 OceanBase 数据库之前，确保您的机器可以连接公网。并且您的软硬件环境满足以下要求： | 项目 | 描述 | | --- | --- | | 系统 | - Anolis OS 8.X 版本（内核 Linux 3.10.0 版本及以上） - Red Hat Enterprise Linux Server 7.X 版本（内核 Linux 3.10.0 版本及以上） - CentOS Linux 7.X 版本及以上版本（内核 Linux 3.10.0 版本及以上） | | CPU | 最低要求 2 核，推荐 8 核及以上 | | 内存 | 最低要求 8 GB，推荐设置在 32 GB 至 1024 GB 范围内。 | | 磁盘类型 | 推荐使用 SSD | | 磁盘存储空间 | 内存大小的 4 倍及以上 | | 文件系统 | 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。 | > **说明** > > > > 若您选择使用 Docker 部署 OceanBase 数据库，则内存最低要求 10G。 ## 操作步骤 > **说明** > > > > 以下内容以 x86 架构的 CentOS Linux 7.9 镜像作为环境，其他环境可能略有不同。 ### 使用 OBD 部署 OceanBase 数据库 您可参考本节内容快速部署单机 OceanBase 数据库。 #### 步骤一：下载安装 OBD 获取 OceanBase 数据库最快的方式是使用数据库部署工具 OceanBase Deployer（简称 OBD），因此推荐您使用此方式体验 OceanBase 数据库。按照以下步骤下载并安装 OBD。 如您的机器可以访问公网，并能够添加三方 YUM 软件源，您可以运行以下命令，使用 OceanBase 的官方软件源安装 OBD： ```shell sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo sudo yum install -y ob-deploy ``` #### 步骤二：修改配置文件 本节介绍如何使用 OBD 部署 OceanBase 数据库。按照以下步骤部署 OceanBase 数据库。 1. 在目录 `/usr/obd/example/autodeploy` 下找到 OceanBase 数据库单机安装所需的配置文件 `single-example.yaml` 。 2. 按需求在配置文件中修改 IP 和 `home_path`。 > **说明** > > > > `home_path` 是 OceanBase 数据库的工作目录，OceanBase 数据库在此目录下启动。 ```yaml oceanbase-ce: servers: # Please don't use hostname, only IP can be supported - 10.10.10.1 global: # The working directory for OceanBase Database. OceanBase Database is started under this directory. This is a required field. home_path: ``` #### 步骤三：部署并启动 OceanBase 数据库 按照以下步骤部署并启动 OceanBase 数据库实例。 1. 运行以下命令部署集群。 ```shell obd cluster autodeploy obtest -c single-example.yaml -A ``` - `obtest` 为集群名称，这里只是示例，您可自行定义集群名称。一个集群只能有一个名称，且集群名称不能重复。 - `single-example.yaml` 是 OBD 提供的配置文件示例，您需根据自身情况进行修改。 - 增加 `-A` 参数后，将自动用系统剩余资源创建 test 租户。 2. 运行以下命令查看集群状态。 ```shell obd cluster display obtest ``` #### 步骤四：连接 OceanBase 数据库 按照以下步骤连接 OceanBase 数据库。 1. 安装 OceanBase 数据库客户端 OBClient。 ```shell sudo yum install -y obclient ``` 2. 使用 OBClient 客户端连接 OceanBase 数据库。 执行 `obd clustere display` 命令会自动输出连接命令，复制连接命令执行即可连接 OceanBase 数据库，连接命令示例如下。 ```shell obclient -h10.10.10.1 -P2881 -uroot -p****** -Doceanbase -A ``` 使用 OBClient 客户端连接 OceanBase 集群的详细操作可参考 [通过 OBClient 连接 OceanBase 租户](https://www.oceanbase.com/docs/community-observer-cn-10000000001879104)。 ### 使用 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 3221487633 Server version: 5.7.25 OceanBase 3.1.4 (r10000092022071511-a09d3134c10665f03fd56d7f8bdd413b2b771977) (Built Jul 15 2022 11: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) 咨询热线