常用操作

创建租户

方法一：OCP 创建

1. 确认可分配资源

具体可以分配多少内存，可以通过【资源管理】查看各节点的剩余资源 2. 新建租户

3. 填写租户信息

zone 优先级主要是 primary_zone 设置 leader优先级，如果优先级全部相同，那么 leader 会打散到所有节点上。

方法二：手动创建

1. 确认可分配资源

新租户可以分配的内存大小为 memory_limit - system_memory - sys 租户内存，CPU 数量为 cpu_count - sys 租户 cpu。

# 查询参数
show parameters where name in ('memory_limit','system_memory','cpu_count');
# 查询 sys 租户资源
select * from DBA_OB_UNIT_CONFIGS;

2. 创建租户

# 创建资源规格，5C14G，日志40G，IOPS 10000000。
create resource unit unit_1 max_cpu 5, min_cpu 5, memory_size '15G', log_disk_size '50G', max_iops 10000000;
# 创建资源池，指定 资源规格以及 zone_list。
create resource pool pool_1 unit = 'unit_1', unit_num = 1, zone_list = ('zone1','zone2','zone3');
# 创建租户，指定副本数量3，primary_zone，以及资源池和白名单。
create tenant perf replica_num = 3,primary_zone='RANDOM', resource_pool_list=('pool_1') set ob_tcp_invited_nodes='%';

3. 修改 root 用户密码

创建完租户，默认的 root 密码为空，如果需要可以修改密码。

# 租户的 root 用户登陆后执行修改 sql
set password for root=password('xxx');

连接数据库

主要有两种连接方式：

1. 通过 OBServer 直连（默认端口 2881）

mysql -h xxx.xxx.xxx.xxx -uroot@sys -P2881 -p -c -A oceanbase

2. 通过 OBProxy 连接（默认端口2883）

mysql -h xxx.xxx.xxx.xxx -uroot@sys#obdemo -P2883 -p -c -A oceanbase

使用 OBProxy 连接时，用户信息需要包括【用户名@租户名#集群名】；如果是 OBServer 连接，那么只需要包括【用户名@租户名】。

参数和变量

区别：

参数（parameter）可以控制集群的负载均衡、合并时间、合并方式、资源分配和模块开关等功能，主要针对集群、Zone、OBServer 和 租户级别进行配置。

变量（variable）可以控制数据库系统的各种行为，如缓存大小、并发连接数等，主要是针对租户级别内 Global 和 Session 级别进行设置。

查看参数和变量

OBServer 参数 ：

# 方法一
show parameters like '%enable_rebalance%';
# 方法二
show parameters where name in ('memstore_limit_percentage','freeze_trigger_percentage','writing_throttling_trigger_percentage');
# 方法三
select * from oceanbase.GV$OB_PARAMETERS where NAME in ('memstore_limit_percentage','freeze_trigger_percentage','writing_throttling_trigger_percentage');

OBProxy 参数：

show proxyconfig like '%query_digest_time_threshold%';

查看变量

show variables like '%timeout%';

修改参数和变量

要注意，这里的参数修改会自动变更到安装目录的 etc 下的配置文件，但是如果是 OBD 创建的集群，不会自动同步到 OBD 的配置文件中，如果后续需要使用 OBD 重启，那么需要手动修改 OBD 的配置，防止启动后配置有差异影响业务。

OBServer 参数 ：

alter system set enable_rebalance=False;

OBProxy 参数：

alter proxyconfig set query_digest_time_threshold='101ms';

修改变量：

# 设置全局级别变量，当前 session 不生效，新 session 生效。
set global ob_query_timeout=10000000;
# 设置会话级别变量，当前 session 生效，其他 session 不生效。
set session ob_query_timeout=10000000;

RootService 切主

-- 操作
ALTER SYSTEM SWITCH REPLICA leader LS=1 SERVER='目标ip:rpc_port' TENANT ='sys';
-- 实例
ALTER SYSTEM SWITCH REPLICA leader LS=1 SERVER ='x.x.x.x:2882' TENANT ='sys'

清理租户并释放空间

通过清理租户释放空间时需先执行 drop tenant xxx force; 命令删除租户，再执行 drop resource pool xxx; 命令删除对应的资源池，两条命令均成功执行才算释放空间。

注意

该操作会清理租户下的所有数据。

普通用户租户查看自己租户下所有的表

您可通过如下命令查询表类型，之后根据表类型查询表名。

-- 查询表类型
select distinct(OBJECT_TYPE) from DBA_OBJECTS;  
-- 根据表类型查表名
select OBJECT_NAME from DBA_OBJECTS where OBJECT_TYPE='table' ;

清理 OBD 管理的集群信息

当 OBD 管理的集群被销毁后，直接删除 OBD 中该集群的存储信息即可彻底清理该集群，有如下两种方法。

• 方法一：您可执行 obd cluster list 命令查看集群所在的目录，通过 rm 命令清理目录即可，示例如下。

  [admin@obtest ~]$ obd cluster list
  +----------------------------------------------------------------------+
  |                             Cluster List                             |
  +-------------+--------------------------------------+-----------------+
  | Name        | Configuration Path                   | Status (Cached) |
  +-------------+--------------------------------------+-----------------+
  | test1       | /home/admin/.obd/cluster/test1       | destroyed       |
  | myoceanbase | /home/admin/.obd/cluster/myoceanbase | running         |
  +-------------+--------------------------------------+-----------------+
  
  [admin@obtest ~]$ rm -rf /home/admin/.obd/cluster/test1

• 方法二：您可通过 cd ~/.obd/cluster 命令进入到 OBD 的集群信息目录下，删除对应的 Name 目录，示例如下。

  [admin@obtest ~]$ cd ~/.obd/cluster/
  [admin@obtest cluster]$ ll
  total 12
  drwxr-xr-x 2 admin admin 4096 Jun  1 12:04 myoceanbase
  drwxr-xr-x 2 admin admin 4096 May 26 14:22 test1
  
  [admin@obtest ~]$ rm -rf test1

日志打印相关

调整日志文件以及记录数量

-- 开启日志回收
alter system set enable_syslog_recycle=true
-- 关闭 wf 日志打印
alter system set enable_syslog_wf=false
-- 限制日志个数，按需调整（单个日志 256M）
alter system set max_syslog_file_count=10
-- 设置系统日志级别
syslog_level (DEBUG/TRACE/INFO/WARN/USER_ERR/ERROR)

调整慢查询日志记录配置

SQL 执行时间默认情况下超过 1s 就会记录到 observer.log 日志或者在 OCP 白屏监控有记录。

该配置受租户参数 trace_log_slow_query_watermark 控制，可通过如下命令修改配置。

-- 查看参数配置
show parameters like '%trace_log_slow_query_watermark%';
-- 修改参数
alter system set trace_log_slow_query_watermark='2s';

OBProxy 日志打印

您可通过系统租户（root@sys）或者 root@proxysys 连接集群修改 OBProxy 日志打印相关配置。

-- 查询参数
show proxyconfig like '%log_file_percentage%';
-- 修改参数
alter proxyconfig set log_file_percentage=75;

OBProxy 日志相关参数如下表所示。

参数	默认值	取值范围	解释
log_file_percentage	80	[0, 100]	OBProxy 日志百分比阈值，超过阈值即进行日志清理。
log_dir_size_threshold	64GB	[256MB, 1T]	OBProxy 日志大小阈值。超过阈值即进行日志清理。
max_log_file_size	256MB	[1MB, 1G]	单个日志文件的最大尺寸。
syslog_level	INFO	DEBUG, TRACE, INFO, WARN, USER_ERR, ERROR	日志级别。

SQL 并行执行

您可通过增加并行加快索引创建，具体命令如下所示。

-- 增加 SQL 执行内存百分比
SET GLOBAL OB_SQL_WORK_AREA_PERCENTAGE = 30; 
-- 设置 DDL 并行度
SET SESSION _FORCE_PARALLEL_DDL_DOP = 32;
-- 并行度增加需要设置该参数，比所有并行度和大即可
SET GLOBAL PARALLEL_SERVERS_TARGET = 64;

说明

持续更新中，敬请期待...