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
• dnf
• apt

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.114-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.alternate_index_handler_name = 'extended_rum'

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

CREATE EXTENSION documentdb CASCADE;
CREATE EXTENSION documentdb_extended_rum;

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

重要对象

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

运行边界

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

v0.114-0变更日志描述了RUM WAL页面重用标记和目标发布树修剪功能，但它们是受控特性的，默认情况下未启用。这些特性不是此版本的默认用户可见功能。