documentdb_distributed

DocumentDB多节点模式的API层

概览

扩展包名版本分类许可证语言
documentdb0.109SIMMITC
ID扩展名BinLibLoadCreateTrustReloc模式
9000documentdb-
9010documentdb_core-
9020documentdb_distributed-
9030documentdb_extended_rum-
相关扩展citus documentdb_core documentdb citus mongo_fdw plproxy postgres_fdw rum pg_jsonschema jsquery

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY0.1091817161514documentdbcitus, documentdb_core, documentdb
RPMPIGSTY0.1091817161514documentdb_$vpostgresql$v-contrib, pg_cron_$v, pgvector_$v, rum_$v
DEBPIGSTY0.1091817161514postgresql-$v-documentdbpostgresql-$v-cron, postgresql-$v-pgvector, postgresql-$v-rum
OS / PGPG18PG17PG16PG15PG14
el8.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.107PIGSTY MISS
el8.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.107PIGSTY MISS
el9.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.107PIGSTY MISS
el9.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.107PIGSTY MISS
el10.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.107PIGSTY MISS
el10.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.107PIGSTY MISS
d12.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
d12.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
d13.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
d13.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
u22.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
u22.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
u24.x86_64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS
u24.aarch64PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY 0.109PIGSTY MISS

构建

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

pig build pkg documentdb         # 构建 RPM / DEB 包

安装

您可以直接安装 documentdb 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

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 = 'citus, pg_documentdb, pg_documentdb_core';

创建扩展

CREATE EXTENSION documentdb_distributed CASCADE;  -- 依赖: citus, documentdb_core, documentdb

用法

documentdb_distributed: DocumentDB 的多节点 API 接口

documentdb_distributed 扩展为 PostgreSQL 上的 DocumentDB 提供多节点分布式能力。它扩展了核心 DocumentDB 功能以支持跨多个 PostgreSQL 节点的水平扩展。

概述

该扩展与 documentdb_core 配合使用,提供分布式文档数据库操作。它支持:

  • 将文档集合分片到多个节点
  • 分布式查询执行,用于 MongoDB 兼容操作
  • 大规模文档工作负载的水平扩展

前置条件

documentdb_distributed 扩展需要:

  • 已安装并配置 documentdb_core 扩展
  • 多节点 PostgreSQL 集群(通常使用 Citus 进行分布)

启用

CREATE EXTENSION documentdb_distributed;

分布式层透明地将 CRUD 操作和聚合管道路由到集群节点,同时保持 MongoDB 线协议兼容性。


最后修改 2026-03-14: update extension metadata (953cbd0)