快速体验 OceanBase

本文介绍如何快速安装部署并体验 OceanBase 数据库。

前提条件

在参考本文安装 OceanBase 数据库之前，确保您的机器可以连接公网。并且您的软硬件环境满足以下要求：

说明

若您选择使用 Docker 部署 OceanBase 数据库，则内存最低要求 10G。

操作步骤

说明

以下内容以 x86 架构的 CentOS Linux 7.9 镜像作为环境，其他环境可能略有不同。

使用 OBD 部署 OceanBase 数据库

您可参考本节内容快速部署单机 OceanBase 数据库。

步骤一：下载安装 OBD

获取 OceanBase 数据库最快的方式是使用数据库部署工具 OceanBase Deployer（简称 OBD），因此推荐您使用此方式体验 OceanBase 数据库。按照以下步骤下载并安装 OBD。

如您的机器可以访问公网，并能够添加三方 YUM 软件源，您可以运行以下命令，使用 OceanBase 的官方软件源安装 OBD：

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 数据库在此目录下启动。

   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. 运行以下命令部署集群。

   obd cluster autodeploy obtest -c single-example.yaml -A
   

   • obtest 为集群名称，这里只是示例，您可自行定义集群名称。一个集群只能有一个名称，且集群名称不能重复。

   • single-example.yaml 是 OBD 提供的配置文件示例，您需根据自身情况进行修改。

   • 增加 -A 参数后，将自动用系统剩余资源创建 test 租户。

2. 运行以下命令查看集群状态。

   obd cluster display obtest
   

步骤四：连接 OceanBase 数据库

按照以下步骤连接 OceanBase 数据库。

1. 安装 OceanBase 数据库客户端 OBClient。

   sudo yum install -y obclient
   

2. 使用 OBClient 客户端连接 OceanBase 数据库。

   执行 obd clustere display 命令会自动输出连接命令，复制连接命令执行即可连接 OceanBase 数据库，连接命令示例如下。

   obclient -h10.10.10.1 -P2881 -uroot -p****** -Doceanbase -A
   

   使用 OBClient 客户端连接 OceanBase 集群的详细操作可参考 通过 OBClient 连接 OceanBase 租户。

使用 Docker 部署 OceanBase 数据库

您可参考本节内容在 Docker 容器里启动 OceanBase 数据库，帮助您快速了解 OceanBase 数据库。

（可选）步骤一：拉取 OceanBase 数据库镜像

运行如下命令，拉取 OceanBase 数据库所需镜像。

• 搜索 OceanBase 数据库相关镜像

  [admin@test001 ~]$ docker search oceanbase
  

• 拉取 OceanBase 数据库最新镜像

  [admin@test001 ~]$ docker pull oceanbase/oceanbase-ce
  

  说明

  上述命令默认拉取最新版本，可根据实际需求在 Docker 镜像 中选择版本。

步骤二：启动 OceanBase 数据库实例

运行如下命令，启动 OceanBase 数据库实例。

• 根据当前容器部署最大规格实例

  [admin@test001 ~]$ sudo docker run -p 2881:2881 --name obstandalone -e MODE=normal -d oceanbase/oceanbase-ce
  

• 部署 mini 的独立实例

  [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!，则表示启动成功。

[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 容器

   [admin@test001 ~]$ sudo docker exec -it obstandalone bash
   

2. 查看集群详情

   # 查看集群列表
   obd cluster list
   # 查看 obcluster 集群详情
   obd cluster display obcluster
   

3. 连接集群

   obclient -h127.0.0.1 -uroot@sys -A -Doceanbase -P2881 -p
   

使用宿主机本地客户端连接

您可选择使用宿主机本地 OBClient 或 MySQL 客户端连接到 OceanBase 数据库实例，示例如下：

[admin@test001 ~]$ obclient -uroot@sys -h127.0.0.1 -P2881 -p

连接成功后，终端将显示如下内容：

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)]>