License授权

License用于控制能否完全使用PolarDB PostgreSQL轻量版集群功能。本文介绍如何启用License以及检查License是否生效的方法。

注意事项

  • License通过宿主机的MAC地址、数据库系统识别码与使用时长进行授权验证。License过期后运行状态下的集群可继续使用但不可配置,关闭后无法重启。

  • 未启用License的集群存在限流,直接影响生产环境中应用。启用License后解除限流。

  • 对于一主一备、一主两备集群,启用License后,建议将polarflex-${version}目录拷贝到同一集群内每台服务器主机上,并安装集群管理工具pdbcli。当单台pdbcli所在机器异常时,可使用其他机器的工具,只要各机器保持config.yamlLicense目录一致即可。

说明

您可联系我们在未启用License情况下免费使用PolarDB PostgreSQL轻量版单节点版本30天,后续自动限流。

前提条件

获取License

支持通过以下两种方式申请License。

  • 联系我们申请License。

  • 使用订单号自行申请License。

    您可选择以下任一方式申请License:

    1. 申请激活码:

    2. 添加相关信息:您需要填写激活码名称、、System Identifier(数据库系统识别码)和描述。

      image

      参数

      说明

      示例

      名称

      激活码名称。格式要求如下:

      • 由大写字母与小写字母组成。

      • 长度不超过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

  1. License文件放置于polarflex-${version}/license目录。

    以一主两备集群为例,将各节点(如host01host02host03)的license.lic文件分别放置于polarflex-${version}/license/1polarflex-${version}/license/2polarflex-${version}/license/3目录下。License文件命名须为license.lic,且顺序与host01host02host03对应。

  2. 执行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状态:

  1. 创建监控插件。

    CREATE EXTENSION polar_monitor IF NOT EXISTS;
  2. 查询License状态。

    SELECT * FROM polar_license_state();

    返回字段如下:

    字段名称

    描述

    time_limit

    证书到期时间。

    sysid

    system identifier(数据库系统识别码)。

    mac

    服务器主机MAC地址。