pg_kazsearch

概览

Upstream release/package version is 2.0.0; extension control version is 0.1.0.

版本

构建

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

pig build pkg pg_kazsearch         # 构建 RPM / DEB 包

安装

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

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

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

• 安装
• pig
• dnf
• apt

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

pig ext install -y pg_kazsearch -v 18  # PG 18
pig ext install -y pg_kazsearch -v 17  # PG 17
pig ext install -y pg_kazsearch -v 16  # PG 16

dnf install -y pg_kazsearch_18       # PG 18
dnf install -y pg_kazsearch_17       # PG 17
dnf install -y pg_kazsearch_16       # PG 16

apt install -y postgresql-18-pg-kazsearch   # PG 18
apt install -y postgresql-17-pg-kazsearch   # PG 17
apt install -y postgresql-16-pg-kazsearch   # PG 16

创建扩展：

CREATE EXTENSION pg_kazsearch;

用法

来源：README, v2.0.0 release, v2.1.0 release

pg_kazsearch 是面向哈萨克语的 PostgreSQL full-text search 扩展。README 说明它支持 PostgreSQL 16-18，并创建可直接使用的 text search configuration kazakh_cfg 和 dictionary pg_kazsearch_dict。

快速开始

CREATE EXTENSION pg_kazsearch;

SELECT ts_lexize('pg_kazsearch_dict', 'алмаларымыздағы');
-- {алма}

SELECT to_tsvector('kazakh_cfg', 'президенттің жарлығы');
-- 'жарлық':2 'президент':1

将哈萨克语 FTS 添加到表

ALTER TABLE articles ADD COLUMN fts tsvector
    GENERATED ALWAYS AS (
        setweight(to_tsvector('kazakh_cfg', title), 'A') ||
        setweight(to_tsvector('kazakh_cfg', body), 'B')
    ) STORED;

CREATE INDEX idx_fts ON articles USING GIN (fts);

SELECT title
FROM articles
WHERE fts @@ websearch_to_tsquery('kazakh_cfg', 'президенттің жарлығы')
ORDER BY ts_rank_cd(fts, websearch_to_tsquery('kazakh_cfg', 'президенттің жарлығы')) DESC
LIMIT 10;

调优

README 记录了无需重启的运行时 dictionary 调优：

ALTER TEXT SEARCH DICTIONARY pg_kazsearch_dict
  (w_deriv = 3.5, w_short_char = 100.0);

Release 与打包说明

• 本项目 CSV 跟踪 extension control version 0.1.0、package/source version 2.0.0、pgrx 0.17.0，以及 PostgreSQL versions 16-18。
• 上游 release v2.0.0 引入了当前 Rust / pgrx PostgreSQL extension 打包。
• 上游 release v2.1.0 在 PostgreSQL extension 之外增加了 Elasticsearch plugin；README 中的 PostgreSQL SQL 用法未改变。

注意事项

面向 PostgreSQL 的文档很简洁，重点是 stemming 和 FTS 用法。此 stub 避免推断除 kazakh_cfg、pg_kazsearch_dict 以及上面文档化示例以外的 SQL 对象。