V3.1.2
更新时间：2022-02-24 21:38:13
本文介绍如何安装 OceanBase 部署工具 OBD。
获取 OceanBase 数据库最快的方式是使用 OBD 获取，因此推荐您使用此方式体验 OceanBase 数据库。您还可以通过以下方式获取 OceanBase 数据库：
前提条件
在安装 OceanBase 数据库之前，您需要确认以下信息：
您的机器满足软硬件要求。详情参考 资源准备。
您的机器可以连接公网。
如果您的机器不能连接公网，您需要 使用 RPM 包安装 OceanBase 数据库。
获取 OBD
您可以通过以下方式获取 OBD：
安装 OBD
更新时间：2022-02-24 21:38:13
通过 YUM 软件源安装 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
下载 OBD 离线 RPM 安装包。
运行以下命令安装 OBD。
yum install -y ob-deploy-1.0.0-1.el7.x86_64.rpm
source /etc/profile.d/obd.sh运行以下命令，安装 OBD：
后续操作
如果您的机器可以连接公网，在您执行了 obd cluster deploy 命令之后，OBD 将检查您的目标机器是否有 OceanBase 数据库安装包。如果没有安装包，OBD 将自动从 yum 源获取。详情参考 使用 OBD 部署 OceanBase 数据库。
使用 OBD 部署 OceanBase 数据库
更新时间：2022-02-24 21:38:13
本文介绍如何使用 OBD 部署 OceanBase 数据库。
名词解释
中控机器
存储 OceanBase 数据库安装包和集群配置信息的机器。
目标机器
安装 OceanBase 数据库的机器。
前提条件
在连接 OceanBase 数据库之前，请您确认以下信息：
您已经在中控机器安装了 OBD。详细信息，参考 安装 OBD。
您已经在目标机器安装了 OceanBase 数据库。
您已经在中控机器安装了 OceanBase 数据库的客户端 OBClient。详细信息，参考 OBClient 文档。
修改配置文件
从 GitHub 上下载对应的配置文件模板。
如果您采用本地安装，即中控机器和目标机器是同一台机器，请下载 本地安装配置文件。
如果您采用单机安装，即中控机器和目标机器不是同一台机器，且目标机器只有一台，请下载 单机安装配置文件。
如果您采用分布式安装，即中控机器和目标机器不是同一台机器，且目标机器有多台，请下载 分布式安装配置文件。 注意
此处以本地安装为例，介绍如何修改配置文件。您必须按照您的安装方式选择对应的配置文件模板。
在配置文件顶部添加用户密码信息。
user: username: <您的账号名> password: <您的登录密码> key_file: <您的私钥路径>其中，
username为登录到目标机器的用户名，确保您的用户名有 observer 进程工作目录home_path的权限。 注意通常情况下，您只能使用登录密码或者私钥登录中的一种方式目标机器。
修改配置文件中的 IP 地址。
oceanbase-ce: servers: - name: z1 # Please don't use hostname, only IP can be supported ip: 11.166.80.01修改配置文件中的
devname变量和home_path。oceanbase-ce: global: home_path: <your_observer_work_path> # Please set devname as the network adaptor's name whose ip is in the setting of severs. # if set severs as "127.0.0.1", please set devname as "lo" # if current ip is 192.168.1.10, and the ip's network adaptor's name is "eth0", please use "eth0" devname: bond0注意
您需要拥有
home_path目录的权限。
启动 OceanBase 数据库
运行以下命令部署集群：
obd cluster deploy <deploy_name> -c <deploy_config_path>其中，参数
deploy_name为部署配置名称，可以理解为配置文件名称，且部署配置名称不能重复。运行以下命令启动集群：
obd cluster start <deploy_name>运行以下命令查看集群状态：
obd cluster display <deploy_name>
连接 OceanBase 数据库
按照以下步骤连接 OceanBase 数据库：
安装 OceanBase 数据库客户端 OBClient：
通过 YUM 软件源安装 OBClient
sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo sudo yum install -y obclient离线安装 OBClient
下载 OBClient 的离线安装包。更多信息，参考 下载中心。并执行以下命令安装：
sudo yum install -y libobclient-2.0.0-2.el7.x86_64.rpm sudo yum install -y obclient-2.0.0-2.el7.x86_64.rpm注意
您必须首先下载 OBClient 的依赖包 LibOBClient。示例中的安装包可能不是最新版本，建议您下载最新的安装包。详细信息，参考 下载中心。
运行以下命令，使用 OBClient 客户端连接 OceanBase 数据库：
obclient -h<your_ip> -P<observer_mysql_port> -uroot其中，
your_ip为您 OceanBase 实例所在的机器 IP 地址。observer默认使用端口2881连接 OBClient。如果您对端口做了更改，此处使用您实际的端口号。返回以下信息：
Welcome to the MariaDB monitor. Commands end with ; or \g. Your MySQL connection id is 3221546072 Server version: 5.7.25 OceanBase 3.1.0 (r1-) (Built Apr 7 2021 08:14:49) Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MySQL [(none)]>
（可选）验证集群
连接 OceanBase 数据库，运行以下命令验证集群：
MySQL [oceanbase]> USE oceanbase;
MySQL [oceanbase]> SELECT * FROM __all_server;
返回以下结果：
+----------------------------+----------------------------+---------------+----------+----+-------+------------+-----------------+--------+-----------------------+--------------------------------+-----------+--------------------+--------------+----------------+-------------------+
| gmt_create | gmt_modified | svr_ip | svr_port | id | zone | inner_port | with_rootserver | status | block_migrate_in_time | build_version | stop_time | start_service_time | first_sessid | with_partition | last_offline_time |
+----------------------------+----------------------------+---------------+----------+----+-------+------------+-----------------+--------+-----------------------+--------------------------------+-----------+--------------------+--------------+----------------+-------------------+
| 2021-04-21 10:59:04.967158 | 2021-04-21 10:59:20.344774 | 11.166.80.01 | 2882 | 1 | zone1 | 2881 | 1 | active | 0 | 3.1.0_1-(Apr 7 2021 08:14:49) | 0 | 1618973957346877 | 0 | 1 | 0 |
| 2021-04-21 10:59:04.956632 | 2021-04-21 10:59:20.223340 | 11.166.80.02 | 2882 | 2 | zone2 | 2881 | 0 | active | 0 | 3.1.0_1-(Apr 7 2021 08:14:49) | 0 | 1618973958225270 | 0 | 1 | 0 |
| 2021-04-21 10:59:03.956853 | 2021-04-21 10:59:22.415147 | 11.166.81.103 | 2882 | 3 | zone3 | 2881 | 0 | active | 0 | 3.1.0_1-(Apr 7 2021 08:14:49) | 0 | 1618973958416271 | 0 | 1 | 0 |
+----------------------------+----------------------------+---------------+----------+----+-------+------------+-----------------+--------+-----------------------+--------------------------------+-----------+--------------------+--------------+----------------+-------------------+
3 rows in set (0.00 sec)
以上返回结果说明集群部署成功。
数据库操作
更新时间：2022-02-24 21:38:13
本节主要提供数据库的创建、查看、修改和删除示例。
创建数据库
使用 CREATE DATABASE 语句创建数据库。
示例如下：
创建数据库
test 2，并指定字符集为UTF8。obclient> CREATE DATABASE test2 DEFAULT CHARACTER SET UTF8; Query OK, 1 row affected (0.00 sec)创建读写属性的数据库
test3。obclient> CREATE DATABASE test3 READ WRITE; Query OK, 1 row affected (0.03 sec)更多
CREATE DATABASE语句相关的语法说明请参见《SQL 参考》中 CREATE DATABASE章节。
查看数据库
使用 SHOW DATABASES 语句查看数据库。
示例如下：
obclient> SHOW DATABASES;
修改数据库
使用 ALTER DATABASE 语句来修改 DataBase 数据库的属性。
示例如下：
修改数据库 test2 的字符集为 UTF8MB4，校对规则为 UTF8MB4_BIN，且为读写属性。
obclient> ALTER DATABASE test2 DEFAULT CHARACTER SET UTF8MB4;
obclient> ALTER DATABASE test2 DEFAULT COLLATE UTF8MB4_BIN;
obclient> ALTER DATABASE test2 READ WRITE;
更多 ALTER DATABASE 语句相关的语法说明请参见《SQL 参考》中 ALTER DATABASE章节。
删除数据库
使用 DROP DATABASE 语句删除数据库。
示例如下：
obclient> DROP DATABASE my_db;
更多 DROP DATABASE 语句相关的语法说明请参见《SQL 参考》中 DROP DATABASE章节。
