License用于控制能否完全使用PolarDB PostgreSQL轻量版集群功能。本文介绍如何启用License以及检查License是否生效的方法。
注意事项
License通过宿主机的MAC地址、数据库系统识别码与使用时长进行授权验证。License过期后运行状态下的集群可继续使用但不可配置,关闭后无法重启。
未启用License的集群存在限流,直接影响生产环境中应用。启用License后解除限流。
对于一主一备、一主两备集群,启用License后,建议将
polarflex-${version}
目录拷贝到同一集群内每台服务器主机上,并安装集群管理工具pdbcli。当单台pdbcli
所在机器异常时,可使用其他机器的工具,只要各机器保持config.yaml
和License目录一致即可。
您可联系我们在未启用License情况下免费使用PolarDB PostgreSQL轻量版单节点版本30天,后续自动限流。
前提条件
获取License
支持通过以下两种方式申请License。
联系我们申请License。
使用订单号自行申请License。
您可选择以下任一方式申请License:
申请激活码:
添加相关信息:您需要填写激活码名称、、System Identifier(数据库系统识别码)和描述。
参数
说明
示例
名称
激活码名称。格式要求如下:
由大写字母与小写字母组成。
长度不超过64个字符。
PolarDBPostgreSQLLicenseOne
MAC地址
PolarDB PostgreSQL轻量版集群所在环境的MAC地址。
说明请在您安装部署的环境中执行
pdbcli license info
获取。例如:msg: 'mac_info: 00:16:3e:xx:xx:xx'
00:16:3e:xx:xx:xx
System Identifier
PolarDB PostgreSQL轻量版集群所在环境的数据库系统识别码。
说明请在您安装部署的环境中执行
pdbcli license info
获取。例如:msg: 'system_identifier: 75669741013xxxxxxxx'
75669741013xxxxxxxx
描述
用于备注该激活码的相关信息,便于后续管理激活码。要求如下:
不能以
http://
或https://
开头。长度为2~256个字符。
LicenseInfo
启用License
将License文件放置于
polarflex-${version}/license
目录。以一主两备集群为例,将各节点(如
host01
、host02
、host03
)的license.lic
文件分别放置于polarflex-${version}/license/1
、polarflex-${version}/license/2
、polarflex-${version}/license/3
目录下。License文件命名须为license.lic
,且顺序与host01
、host02
、host03
对应。执行
pdbcli restart cluster
重启集群。说明启动集群时将检测
license.lic
文件中信息,如果License文件不正确将导致启动失败。若未启用License文件将导致集群限流,无法用于生产环境。
查看License状态
启用License后,可通过以下任一方式查看License状态,包括是否生效、是否到期、system identifier
(数据库系统识别码)和MAC地址。
pdbcli(推荐)
最简单的方式是直接使用pdbcli工具。您可以执行以下命令查看License状态,正常返回各个节点的License到期时间且无其他报错即表示License安装成功。
pdbcli license info
内置工具psql
使用PolarDB PostgreSQL轻量版内核二进制包的内置客户端查看License证书状态:
/u01/polardb_pg/bin/polar_tools parse-license --path='/<license文件路径>/license.lic' --result
返回结果如下:
time: 2025-10-11 14:21:32, sysid: 3832234804xxxxxx, mac: a2:xx:xx:xx:53:9a
SQL语句
安装License且集群正常运行后,可使用PolarDB PostgreSQL轻量版内核二进制包内置的客户端连接集群执行以下操作查看License状态:
创建监控插件。
CREATE EXTENSION polar_monitor IF NOT EXISTS;
查询License状态。
SELECT * FROM polar_license_state();
返回字段如下:
字段名称
描述
time_limit
证书到期时间。
sysid
system identifier
(数据库系统识别码)。mac
服务器主机MAC地址。