documentdb_extended_rum

概览

版本

构建

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

pig build pkg documentdb         # 构建 RPM / DEB 包

安装

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

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

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

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

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

dnf install -y documentdb_18       # PG 18
dnf install -y documentdb_17       # PG 17
dnf install -y documentdb_16       # PG 16
dnf install -y documentdb_15       # PG 15

apt install -y postgresql-18-documentdb   # PG 18
apt install -y postgresql-17-documentdb   # PG 17
apt install -y postgresql-16-documentdb   # PG 16
apt install -y postgresql-15-documentdb   # PG 15

预加载配置：

shared_preload_libraries = 'pg_documentdb, pg_documentdb_core, pg_documentdb_extended_rum';

创建扩展：

CREATE EXTENSION documentdb_extended_rum CASCADE;  -- 依赖: documentdb

用法

来源：

• DocumentDB Extended RUM README
• documentdb_extended_rum 控制文件
• 访问方法SQL定义
• DocumentDB v0.117-0变更日志

documentdb_extended_rum 是DocumentDB的扩展RUM索引访问方法。它是由DocumentDB索引层选择的实现组件，而不是通用的应用程序索引或替代安装 documentdb。

配置与安装

该库只能从 shared_preload_libraries 初始化。在基础DocumentDB库之后预加载它并重启PostgreSQL：

shared_preload_libraries = 'pg_cron, pg_documentdb_core, pg_documentdb, pg_documentdb_extended_rum'
documentdb.rum_library_load_option = 'require_documentdb_extended_rum'

然后使用相同的版本安装扩展，就像安装基础堆栈一样：

CREATE EXTENSION documentdb CASCADE;
CREATE EXTENSION documentdb_extended_rum;

DocumentDB部署工具通常会管理此配置。现有数据库应遵循特定于版本的升级程序而不是随意切换索引处理器。

重要对象

• documentdb_extended_rum 是该扩展注册的索引访问方法。
• documentdb_extended_rum_catalog 包含用于DocumentDB的BSON操作符家族和类。
• documentdb.rum_library_load_option = 'require_documentdb_extended_rum' 指示DocumentDB索引层使用适配器。
• 实现是一个RUM分支，其磁盘布局和内容设计保持与上游RUM向后兼容的同时，改变查询和易变路径以适应文档工作负载。

运行边界

安装和升级此组件时，请确保与 documentdb 和 documentdb_core 二进制文件版本匹配。除非遵循上游开发指导，否则不要直接使用其内部操作符类构建索引；通过DocumentDB API创建和管理索引以保持元数据的一致性。

在 0.117-0 中，所有受支持 PostgreSQL 主版本的 documentdb.rum_library_load_option 默认均为 require_documentdb_extended_rum。本版本改进了空倒排页回收，并保护清理期间尚未完成的页分裂。更新日志中注明受开关控制的性能功能仍取决于各自配置，不应直接套用其他版本的配置。