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:9aSQL语句
安装License且集群正常运行后,可使用PolarDB PostgreSQL轻量版内核二进制包内置的客户端连接集群执行以下操作查看License状态:
创建监控插件。
CREATE EXTENSION polar_monitor IF NOT EXISTS;查询License状态。
SELECT * FROM polar_license_state();返回字段如下:
字段名称
描述
time_limit证书到期时间。
sysidsystem identifier(数据库系统识别码)。mac服务器主机MAC地址。

