opencc

概览

UTF8; bundled OpenCC 1.4.2.

版本

构建

您可以使用 pig build 命令构建 pg_opencc 扩展的 RPM / DEB 包：

pig build pkg pg_opencc         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_opencc 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

pig install pg_opencc;          # 当前活跃 PG 版本安装

pig ext install -y pg_opencc -v 18  # PG 18
pig ext install -y pg_opencc -v 17  # PG 17
pig ext install -y pg_opencc -v 16  # PG 16
pig ext install -y pg_opencc -v 15  # PG 15
pig ext install -y pg_opencc -v 14  # PG 14

dnf install -y pg_opencc_18       # PG 18
dnf install -y pg_opencc_17       # PG 17
dnf install -y pg_opencc_16       # PG 16
dnf install -y pg_opencc_15       # PG 15
dnf install -y pg_opencc_14       # PG 14

apt install -y postgresql-18-opencc   # PG 18
apt install -y postgresql-17-opencc   # PG 17
apt install -y postgresql-16-opencc   # PG 16
apt install -y postgresql-15-opencc   # PG 15
apt install -y postgresql-14-opencc   # PG 14

创建扩展：

CREATE EXTENSION opencc;

用法

来源：

• pg_opencc 0.1.0 README
• 扩展控制文件
• SQL API
• 发布说明

opencc 由 pg_opencc 项目提供，用于简体中文、繁体中文、台湾与香港用语以及日文新字体之间的转换。0.1.0 版本将 OpenCC 1.4.2 及其词典嵌入共享库，运行时无需系统 OpenCC 或外部词典文件。

启用与转换

支持 PostgreSQL 14–18，要求数据库使用 UTF8 编码。这是受信任扩展，拥有数据库 CREATE 权限的用户即可安装。对象位于固定的 opencc 模式中，扩展不可迁移模式。基本使用无需预加载或重启服务器。

CREATE EXTENSION opencc;

SELECT opencc.s2twp('鼠标里面的硅二极管坏了，导致光标分辨率降低。');
SELECT opencc.convert('繁體中文', 't2s');
SELECT * FROM opencc.configs;

opencc.convert(input, config) 用于明确指定转换配置。opencc.s2t()、opencc.t2s() 等快捷函数与各个配置一一对应：

地区转换与结果检查

opencc.localize(input, target, source) 接受 zh-Hans、zh-Hant、zh-CN、zh-TW、zh-HK 和 ja。默认的 source => 'auto' 可以判断文字类别，但无法区分台湾和香港词汇。需要准确转换地区用语时，应明确指定来源地区。

SELECT opencc.localize('滑鼠裡面的矽二極體壞了', 'zh-CN', source => 'zh-TW');
SELECT opencc.detect('中文'), opencc.script_stats('中文');
SELECT * FROM opencc.routes;
SELECT * FROM opencc.ambiguities('大战文丑的时候，他的头发很干燥', 's2t');
SELECT opencc.candidates('发', 's2t');
SELECT * FROM opencc.explain('数据库连接池', 's2twp');

运行与升级

转换函数在同一扩展版本内具有 IMMUTABLE STRICT PARALLEL SAFE 属性，可用于表达式索引和存储生成列。PostgreSQL 18 的生成列若调用自定义转换函数，必须明确指定 STORED。

未来扩展版本更新词典时，转换结果可能变化。升级时应检查 opencc.version()，并审阅 opencc.dependents() 返回的语句。依赖检查无法发现封装在其他自定义函数中的调用。

SELECT * FROM opencc.version();
SELECT * FROM opencc.dependents();

每个后端按需初始化转换器。也可选择在服务器启动时预加载，使后端共享相关内存；修改 shared_preload_libraries 需要重启：

shared_preload_libraries = 'opencc'
opencc.preload = 's2t,t2s,s2twp,tw2sp'

若已有预加载列表，将 opencc 加入其中。opencc.preload 也接受 all。删除扩展后会保留空模式。