OceanBase v4.2 解读：tenant=all 语义优化，提拔易用性

1 配景

1.1 租户类型及特点

OceanBase中有三种类型的租户：

• sys租户：集群默认创建，生命周期与集群相一致，管理集群和其他租户，具有较高的地位。
  
• 用户租户：用户创建的业务租户或普通租户，用于运行用户业务并提供完备的数据库功能。
  
• meta租户：与用户租户对应的内部租户，用于存储和管理用户租户的集群私有数据。
  

可见，sys租户和meta租户都具有“角色关键，但不跑业务”的特点，因此，用户在运维中也往往不会刻意关注这些租户，而是将重点放在用户租户上。
1.2 tenant=all 的已知题目

目前，租户级配置项修改下令支持tenant=all语法，即alter system set xxx=yyy tenant=all，语义是对全部租户，包括sys、meta租户，都见效。这种设计存在两个题目。
一是易用性题目，即可能使用户做出不符合自己意愿的误操纵。当用户使用tenant=all时，可能仅仅是想对全部用户租户见效，也没有清楚而深刻地认识到“我这个动作，已经顺带把sys租户和meta租户的配置项一起改了，这可能会有题目，我需要特别把稳这一点”。
二是稳固性题目，即可能会引发observer故障。如果有些配置项对sys租户很紧张，不可轻易修改，那么，一旦这些配置项被tenant=all“顺带”修改了，就可能引发ObServer的故障，并增加题目排查的难度。
以cpu_quota_concurrency为例说明，sys租户默认配置成10，别的租户默认值为4，如果用户执行了alter system set cpu_quota_concurrency=5 tenant=all;，可能导致sys租户出现题目。而用户很可能仅仅是想改跑业务的用户租户的配置项，sys、meta被连带修改，非用户本意。
1.3 解决方案

变更tenant=all的语义，彻底杜绝用户误操纵的风险，同时新增语法兼容旧语义，详见下文变更细节。

2 tenant=all语义变更

2.1 变更细节

起首，修改tenant=all语义，改为“仅包括全部用户租户，排除sys和meta租户”，以彻底杜绝用户误操纵风险，提拔产物稳固性。
除了配置项修改语法，别的使用tenant=all的语法，如归并转储相关语法，也要一起修改，为了保持产物行为同一，制止用户疑惑。
其次，新增语法，tenant=all_user，tenant=all_meta，分别对应全部用户租户和全部meta租户。理由是兼容原有语义，提供更细粒度的控制，在保证操纵安全的条件下尽量方便用户使用。如果用户想使操纵对全部用户租户见效，可以使用tenant=all_user，而不必一一列举租户名称；如果用户确实想要使操纵对全部租户都见效，可以依次使用tenant=all_user，tenant=all_meta，tenant=sys，详见使用说明。
修改后，tenant=all和tenant=all_user的语义完全相同，背面会在适其时机废弃tenant=all。
2.2 影响到的模块和下令

模块	下令
配置项修改	alter system set xxx=yyy tenant=all
归并转储	alter system {major|minor} freeze tenant=allalter system {suspend|resume} merge tenant=allalter system clear merge error tenant=all

2.3 性能影响

无影响。本特性只是缩小了tenant=all的见效范围，同时新增了两个与tenant=all雷同的下令，即（tanant=all_user和tenant=all_meta），且实现上没有新增开销大的操纵，因此不会增加额外的运行负担，对数据库性能无影响。
3 使用说明及特性限定

• 仅支持在sys租户下使用tenant=sys，tenant=all_user，tenant=all_meta。
  
• 对配置项修改语法和归并转储语法，均不建议再使用tenant=all。
  
• 如果只想对sys租户见效，使用tenant=sys；如果只想对全部的用户租户见效，使用tenant=all_user；如果只想对全部的meta租户见效，使用tenant=all_meta。
  
• 如果确实想对全部的租户见效，则需依次使用tenant=sys，tenant=all_user，tenant=all_meta。
  
• 对于配置项设置语法，tenant后不支持list情势；对于归并转储语法，all_user和all_meta只能单独使用，别的名称可以组合成list情势使用。
  
• sys不能大写，因为sys是租户名，是区分大小写的。而all_user和all_meta是关键字，不区分大小写。
  

1. # 配置项设置示例
2. # 以下三句实现原有all语义
3. alter system set ob_compaction_schedule_interval = '10s' tenant = sys; # sys不能大写
4. alter system set ob_compaction_schedule_interval = '10s' tenant = all_user;
5. alter system set ob_compaction_schedule_interval = '10s' tenant = all_meta;
7. # 以下示例不可以，tenant后只能是单个名称，不能是list
8. obclient> alter system set ob_compaction_schedule_interval = '10s' tenant = mysql,sys;
9. ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your OceanBase version for the right syntax to use near 'sys' at line 1
11. obclient> alter system set ob_compaction_schedule_interval = '10s' tenant = all_user,all_meta;
12. ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your OceanBase version for the right syntax to use near 'all_meta' at line 1
14. obclient> alter system set ob_compaction_schedule_interval = '10s' tenant = mysql,all_user;
15. ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your OceanBase version for the right syntax to use near 'all_user' at line 1
17. obclient> alter system set ob_compaction_schedule_interval = '10s' tenant = mysql,all_meta;
18. ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your OceanBase version for the right syntax to use near 'all_meta' at line 1
21. # 合并转储示例
22. # 以下三句实现原有all语义
23. alter system major freeze tenant = sys; # sys不能大写
24. alter system major freeze tenant = all_user;
25. alter system major freeze tenant = all_meta;
27. # 以下示例不可以,all_user/all_meta只能单独使用
28. obclient> alter system major freeze tenant = all_user,all_meta;
29. ERROR 1235 (0A000): all/all_user/all_meta in combination with other names is not supported
31. obclient> alter system major freeze tenant = mysql,all_user;
32. ERROR 1235 (0A000): all/all_user/all_meta in combination with other names is not supported
34. obclient> alter system major freeze tenant = mysql,all_meta;
35. ERROR 1235 (0A000): all/all_user/all_meta in combination with other names is not supported
37. # 以下示例是可以的，all_user/all_meta外的名称可以组合使用
38. alter system major freeze tenant = tt1,sys;

复制代码

在使用该特性的过程中，存在一些限定。
第一，不能再创建名为all_user或者all_meta（不区分大小写）的租户，因为all_user和all_meta变成保留字了。
第二，低版本升级4.2.1版本前，需要先查抄集群中是否有名为all_user或者all_meta（不区分大小写）的租户，如有，需要先重命名租户再升级。
第三，因为没有现实风险，故以下语法中tenant=all语义暂未变更，且暂无计划在将来版本做变更，会维持原有语义稳定，且不支持tenant=all_user或tenant=all_meta。

1. # 升级相关命令，不显示指定TENANT，或指定TENANT = ALL，都会对所有租户生效，无风险
2. ALTER SYSTEM RUN UPGRADE JOB "CMD" [TENANT = ALL|tenant_list];
3. # 这里TENANT = ALL只包含用户租户，sys租户和meta租户没有对应功能
4. ALTER SYSTEM ARCHIVELOG|NOARCHIVELOG TENANT = ALL;

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。