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- 证书到期时间。 - sysid- system identifier(数据库系统识别码)。- mac- 服务器主机MAC地址。 

