**活动时间：**2022年01月 28日~2022年02月 20日
**活动方案：**阅读官网社区版教程 https://open.oceanbase.com/docs/tutorials/quickstart/V1.0.0/chapter-1-overview-of-the-oceanbase-database
在问答区帖子下面提出bug点或者修改意见：
每个人按先后顺序在帖子下留言认领相应的审核章节，可以任选一章，或者任选几小节。
每节最多两个人选。每个人至少选3小节～
审核范围：
第2章-第7章
提建议要求：
1）说明具体章节
2）说明具体问题
3）建议修改的点
示例：
1）说明具体章节：
教程5.1 如何管理 OceanBase 集群 – 如何给 OceanBase 集群扩容/缩容副本
2）说明具体问题
不启动zone，在添加server时会报错
3）建议修改的点
启动 ZONE ：alter system start zone 新zone名。
沟通钉钉群：【 OceanBase 教程阅读官群】
权益：
有付出，就会有收获。
为感谢各位阅读官们辛勤的“除旧"，OceanBase 开源团队将为每位阅读官送出自己审阅的《社区版教程》图书一本，祝愿所有人都能不断收获用自己的勤奋浇灌的“果实”。
春节加码，专属权益：
让阅读官拥有一本印有自己名字的数据库图书。
电子版：在文档版块附上“阅读官”的名字
纸质版：将在在纸质图书上面署上“阅读官”的名字
第六章
6.3 如何跑 SYSBENCH 测试
常见安装问题
您在安装过程中可能遇到的报错如下：
automake 1.10.x (aclocal) wasn’t found, exiting
原因：操作系统没有安装 automake。
解决办法：运行命令 yum install automake.noarch，即可安装 automake。
libtoolize 1.4+ wasn’t found, exiting
原因：操作系统没有安装 libtool。
解决办法：运行命令 yum install libtool，即可安装 libtool。
drv_mysql.c:35:19: fatal error: mysql.h: No such file or directory
原因：操作系统没有安装 MySQL 的开发 lib 库。
解决办法：运行命令 yum install mysql-devel.x86_64，即可安装 MySQL 的开发 lib 库。 ----------------
####################################################################################################
yum install mysql-devel 不带后边儿的.x86_64
加上了会找不到的。
####################################################################################################
error while loading shared libraries: libmysqlclient_r.so.16
该错误通常在直接下载编译好的文件的情况下碰到。
解决办法：将下载文件中的 libmysqlclient_r.so.16.0.0 复制到目录 /usr/lib64/mysql 中，并做一个软链接。
第六章
6.3 如何跑 SYSBENCH 测试
数据准备
准备数据库账户
create database sysbenchdb;
grant all privileges on sysbenchdb.* to u_sysbench identified by '123456';
（可选）修改建表语句
#############################################################
建表语句存放在 share/sysbench/oltp_common.lua 中。
#############################################################
建表语句存放在 /usr/sysbench/share/sysbench/oltp_common.lua 中。
1 个赞
飘逸
#7
教程5.1 如何管理 OceanBase 集群 - 如何管理 OceanBase 数据库内存 -进程总内存
OceanBase 进程启动后会从主机那里拿到绝大部分资源（CPU/内存/空间）应修改为 OceanBase observer进程启动后会从主机那里拿到绝大部分资源（CPU/内存/空间）
飘逸
#8
7.1 性能诊断调优概述 - SQL 引擎简介
OBSERVER 进程包含 SQL 引擎、事务引擎和存储引擎。其中，SQL 引擎的设计跟 ORACLE SQL 引擎设计理念一致。都有 SQL 语法解析、执行计划缓存、软解析、大纲等技术
中的大纲 应该修改成outline,翻译太生硬
老O
#9
1）说明具体章节
2.1 部署准备 > 软件介绍
2）说明具体问题
本课程则是通过 RPM 包方式安装。
名词使用不统一。大多数地方用的是“教程”，但有几处使用的是“课程”。
3）建议修改的点
建议将“课程”统一修改为“教程”。
1 个赞
老O
#10
1）说明具体章节
2.1 部署准备 > 软件介绍
https://open.oceanbase.com/docs/tutorials/quickstart/V1.0.0/2-1-deployment-preparation
2）说明具体问题
yum -y install ob-deploy oceanbase obclient
oceanbase -- rpm包名错误。
3）建议修改的点
yum -y install ob-deploy oceanbase obclient
改为：
yum -y install ob-deploy oceanbase-ce obclient obproxy
1 个赞
老O
#11
1）说明具体章节
2.2 如何快速体验 OceanBase 数据库
常用 Docker 命令参考
https://open.oceanbase.com/docs/tutorials/quickstart/V1.0.0/2-2-how-to-quickly-experience-oceanbase
2）说明具体问题
docker logs这个命令需要加参数，不能直接执行，且与下面的 查看容器日志 重复。
# 日志信息
docker logs
# 查看容器日志
docker logs -f <容器名 or ID>
3）建议修改的点
建议将这条命令删除，
# 日志信息
docker logs
或可替换为查看正在运行的容器命令：
# 查看当前正在运行的容器
docker ps
老O
#12
1）说明具体章节
2.2 如何快速体验 OceanBase 数据库
https://open.oceanbase.com/docs/tutorials/quickstart/V1.0.0/2-2-how-to-quickly-experience-oceanbase
下载镜像并启动
2）说明具体问题
页面排版问题，命令和结果都混在一个代码块里，复制代码不方便，复制功能无法直接使用。
3）建议修改的点
把示例命令和命令的结果拆分成两个代码块，比如像这样：
docker run -p 2881:2881 --name obce-mini -d -e OB_HOME_PATH="/root/obce/" -e OB_TENANT_NAME="obmysql" oceanbase/obce-mini
输出：
➜ ~ docker run -p 2881:2881 --name obce-mini -d -e OB_HOME_PATH="/root/obce/" -e OB_TENANT_NAME="obmysql" oceanbase/obce-mini
45180d71f504981ed588b7de0e5abf952511f2c2f9ee5eac0446b6cf0d4dc02c
➜ ~ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
45180d71f504 oceanbase/obce-mini "/bin/sh -c _boot" 4 seconds ago Up 2 seconds 0.0.0.0:2881->2881/tcp, :::2881->2881/tcp obce-mini
➜ ~
老O
#14
1）说明具体章节
2.2 如何快速体验 OceanBase 数据库
分析 OceanBase 数据库进程特点
https://open.oceanbase.com/docs/tutorials/quickstart/V1.0.0/2-2-how-to-quickly-experience-oceanbase
2）说明具体问题
错误命令建议删除，只保留正确的演示命令。
3）建议修改的点
yum -y install tree
tree /root/ob
改为：
yum -y install tree
tree /root/obce
输出：
[root@45180d71f504 obce]
/root/obce
|-- admin
|-- etc
| |-- observer.config.bin
| `-- observer.config.bin.history
|-- etc2
| |-- observer.conf.bin
| `-- observer.conf.bin.history
|-- etc3
| |-- observer.conf.bin
| `-- observer.conf.bin.history
|-- log
| |-- election.log
| |-- election.log.wf
| |-- observer.log
| |-- observer.log.wf
| |-- rootservice.log
| `-- rootservice.log.wf
|-- run
| |-- mysql.sock
| `-- observer.pid
`-- store
|-- clog
| `-- 1
|-- clog_shm
|-- ilog
| `-- 1
|-- ilog_shm
|-- slog
| `-- 1
`-- sstable
`-- block_file
11 directories, 20 files
1 个赞
老O
#15
1）说明具体章节
2.1 部署准备
软件介绍
表：软件包名 / 进程名 / 软件用途
https://open.oceanbase.com/docs/tutorials/quickstart/V1.0.0/2-1-deployment-preparation
2）说明具体问题
软件包名均为rpm包，obd少了rpm后缀
3）建议修改的点
ob-deploy-1.1.1-1.el7.x86_64
改为：
ob-deploy-1.1.1-1.el7.x86_64.rpm
1 个赞
老O
#16
追加，关于软件包这个表格，
2.1 部署准备
软件介绍
表：软件包名 / 进程名 / 软件用途
少了一个软件包：
libobclient-2.0.0-2.el7.x86_64.rpm
这是obclient的依赖，不然安装obclient时会报错：
[root@centos7 data]# rpm -ivh rpm/*
warning: rpm/obclient-2.0.0-2.el7.x86_64.rpm: Header V4 RSA/SHA1 Signature, key ID e9b4a7aa: NOKEY
error: Failed dependencies:
libobclient >= 2.0.0 is needed by obclient-2.0.0-2.el7.x86_64
DB4U
#17
不针对具体章节：
1，shell提示部分不统一，比如有obce00，obce02，oceanbase-ce等等，如果都都是用admin用户操作，都在最前面部分做统一说明，提示符可写为shell>或者其他。
2，文章有/home/admin，也有~，不统一。
3，4.8节使用root操作，是否必要。如，[root@obce00 ob-loader-dumper-2.1.13-SNAPSHOT]# 。
坤易
#18
1：错误位置：第7章节第7.5节，--》常见算子--》NESTED-LOOP JOIN。第三点。
错误部分：“留意 1 和 2 里的 is_index_back=false”，应该是“留意2 和 3 里的 is_index_back=false ”
坤易
#19
2：建议位置：第7章节第7.5节，--》常见算子--》EXCHANGE IN|OUT REMOTE.
建议部分：可否标注下是怎么制作出来的远程执行计划。能否详细的说明一下。同时“/*+ test20210405 */”这部分能否讲解下是什么含义以及作用？没在具体的文档中看到这么一个hint？
坤易
#20
3: 建议位置：7.4 章节 --》SQL 审计视图概述
建议部分："功能的开启和数据大小是通过下面的 OceanBase 集群参数控制的"是不是应该改成"功能的开启和数据大小是通过下面的 OceanBase 集群变量控制的"
这里的参数应该指定的是变量吧？
夏克
#21
【笔误】 7.1 性能诊断调优概述 ---> SQL HINTS
