首批通过分布式安全可靠测评,为关键业务系统打造
License 管理
更新时间:2026-06-30 17:23:06
OceanBase 通过 License 来约定用户可以如何使用 OceanBase 集中式数据库的条款和条件,包括使用期限、功能范围等。部署 OceanBase 集群之后,建议您及时联系 OceanBase 获取商业版 License 并完成 License 导入,避免 License 过期对您的数据库使用造成影响。
License 概述
集中式版 License 的载体是一个加密文件 OceanBase.lic。License 主要限制了集中式版的使用有效期限以及可使用的功能组件。
OceanBase 集中式数据库主要包含 OceanBase 集中式版基础功能、多租户选件、集群间复制选件、OLAP 选件四个选件,其中 OceanBase 集中式版基础功能必选,多租户选件、集群间复制选件、OLAP 选件为可选。选择不同的选件,对应的 License 是不同的。如果您在购买后需要增加新的选件,需要联系 OceanBase 获取新的 License。拿到新的 License 之后,再次进行加载覆盖之前的 License 即可。
目前,OceanBase 集中式数据库提供商业版 License 和试用版 License,您可以根据需要获取。
商业版 License 的许可范围和有效期由购买合同约定。
单机集群在启动后未导入 License 之前默认持有试用版 License,有效期为 180 天,试用版 License 无功能限制,可体验所有功能。为了确保您的业务可以正常运行,需要确保及时联系 OceanBase 获取商业版 License。
加载 License
获取 License 文件之后,您可以通过 obd、OCP、或者 ALTER SYSTEM LOAD LICENSE 语句加载 License。 有关 obd 加载 License 的详细操作,请参见 obd 常用命令 - 加载许可证。 有关 OCP 加载 License 的详细操作,请参见 导入 License。
以下介绍通过 ALTER SYSTEM LOAD LICENSE 语句加载 License。
获取 License 文件并上传至集中式版部署服务器。
给部署及运行 OBServer 集中式版的用户授予 License 文件的可读权限。如果该用户没有 License 的可读权限,会导致加载失败。
使用 sys 租户登录数据库。
obclient -hxxx.xxx.xxx.xxx -P2881 -uroot -p****** -Doceanbase -A查看 License 信息。
您可以查询
DBA_OB_LICENSE查看当前 License 详细内容。obclient> select * from DBA_OB_LICENSE;加载 license。
obclient> ALTER SYSTEM LOAD LICENSE <license_file_path>;说明
license_file_path必填项,代表 License 文件的路径。示例如下。
obclient(root@(none))[oceanbase]> alter system load license "/data/OceanBase.lic"; Query OK, 0 rows affected (0.012 sec)查看 license 信息。
obclient> select * from DBA_OB_LICENSE;
License 过期的影响
License 过期主要分为试用版 License 过期和商业版 License 过期两种场景。
试用版 License 过期
试用版 License 一旦过期,不论是否重启过 OceanBase 数据库进程,均会有如下使用限制:
禁止用户租户执行所有的 DML 操作,包括 SELECT、INSERT、UPDATE、MERGE、DELETE、EXPLAIN。
禁止用户租户执行 create table 语句,不可新建表。
禁止使用多租户能力,即不能创建新的租户。
禁止使用主备库相关命令:创建备租户、recovery standby、设置 log restore source 的能力。
禁止使用 OLAP 能力,包括列存、外表、物化视图等功能。
当执行被禁止的操作时,均会报错 license is expired,错误码为 4406。
商业版 License 过期
为了保证用户业务的连续性,如果用户在商业版 License 过期后未重启过 OceanBase 数据库进程,则仅限制用户租户不可执行 create table 语句,即不可新建表。如果 OceanBase 数据库进程在商业版 License 过期后进行了重启,则重启后使用限制如下:
禁止用户租户执行所有的 DML 操作,包括 SELECT、INSERT、UPDATE、MERGE、DELETE、EXPLAIN。
禁止用户租户执行 create table 语句,不可新建表。
禁止使用多租户能力,即不能创建新的租户。
禁止使用主备库相关命令:创建备租户、recovery standby、设置 log restore source 的能力。
禁止使用 OLAP 能力,包括列存、外表、物化视图等功能。
当执行被禁止的操作时,均会报错 license is expired,错误码为 4406。
License 到期提醒
当 License 有效期小于 30 天时,在通过 OBClient 等方式登录或连接后,显示如下告警信息,并按天为周期打印 ERROR 日志。
WARNING: License will expire in xxx days.
License 到期处理
推荐在试用版 License 到期之前即申请商业版 License,并及时加载到集群中。试用版 License 到期后,功能使用会受限,一旦加载有效的商业版 License,集群即可恢复正常使用。
DBA_OB_LICENSE 视图
该视图展示用户当前加载的 License 信息。
| 字段 | 类型 | 是否为 NULL | 描述 |
|---|---|---|---|
| END_USER | varchar(512) | NO | 授权用户名。 |
| LICENSE_ID | varchar(128) | NO | License 的 ID。 |
| LICENSE_CODE | varchar(128) | NO | 合同号。 |
| LICENSE_TYPE | varchar(128) | NO | License 类型。
|
| PRODUCT_TYPE | varchar(128) | NO | 产品类型。
|
| ISSUANCE_DATE | timestamp(6) | NO | License 的颁发时间。 |
| ACTIVATION_TIME | timestamp(6) | NO | License 的激活时间。 |
| EXPIRED_TIME | timestamp(6) | NO | License 的过期时间。 |
| OPTIONS | varchar(1024) | NO | License 中所包含的功能选件。
|
| CORE_NUM | bigint(20) unsigned | NO | 授权使用的 CPU 核数。 |
| NODE_NUM | bigint(20) unsigned | NO | 授权节点数,集中式版固定为 1。 |
| CLUSTER_ULID | varchar(30) | NO | 集群启动时自动产生。 |
License 相关报错
ERROR 4405:license is invalid because: xxx
报错原因:导入了一个非法的 License。
详细描述:任意 License 非法的场景下都可能遇到。
解决方法:检查您使用的 License 是否匹配。
ERROR 4406:license is expired
报错原因:License 过期。
详细描述:License 已经过期,数据库授权到期。
解决方法:请及时联系 OceanBase 进行 License 延期。
ERROR 4407:The current license does not include this feature module: xxx
报错原因: 当前使用的功能超出了 License 的授权范围。
详细描述:当前使用的功能超出了 License 的授权范围。比如当前试用版集群已经使用了多租户能力创建了多个用户租户,新导入的商业版 License 中未包含多租户选件,则 License 导入会报错 4407,提示当前使用的功能超出了 License 的授权范围。
解决方法:如果需要使用当前功能,需联系 OceanBase。