下载与安装

pg_mooncake（内嵌 moonlink 实时摄取引擎与 duckdb_mooncake DuckDB 扩展）已面向 16 个 Linux 发行版与 CPU 架构目标（el8、el9、el10、d12、d13、u22、u24、u26 × x86_64 / aarch64）以及 PostgreSQL 14、15、16、17、18 五个大版本构建并发布原生 RPM 与 DEB 软件包（共计 80 个预编译二进制包）。

快速安装指南

1 · 使用 PIG 包管理器安装（推荐）

我们强烈推荐使用由 PGSTY 社区维护的 PostgreSQL 专属包管理器 pig 安装 pg_mooncake 及其依赖的 pg_duckdb。pig 能够自动识别当前 Linux 发行版与 CPU 架构、一键配置 PGDG 与 Pigsty 软件源（内置中国大陆镜像加速），并自动处理扩展依赖关系。

# 1. 使用中国大陆镜像安装 pig 命令行包管理器
curl -fsSL https://repo.pigsty.cc/pig | bash

# 2. 添加 PGDG + Pigsty PGSQL 软件仓库（自动启用中国大陆 CDN 镜像）并刷新缓存
pig repo add pgsql -u -r china

# 3. 安装 pg_duckdb 与 pg_mooncake（自动匹配当前 PG 版本，或通过 -v 18 指定）
pig install pg_duckdb pg_mooncake

# 1. 安装 pig 命令行包管理器
curl -fsSL https://repo.pigsty.io/pig | bash

# 2. 添加 PGDG + Pigsty PGSQL 软件仓库并刷新缓存
pig repo add pgsql -u

# 3. 安装 pg_duckdb 与 pg_mooncake（可通过 -v 18 显式指定 PostgreSQL 大版本）
pig install pg_duckdb pg_mooncake

# 配置好 Pigsty APT 软件源后，按 PostgreSQL 大版本直接安装（以 PG 18 为例）：
sudo apt-get update
sudo apt-get install -y \
  postgresql-18-pg-duckdb \
  postgresql-18-pg-mooncake

# 配置好 Pigsty YUM 软件源后，按 PostgreSQL 大版本直接安装（以 PG 18 为例）：
sudo dnf install -y \
  pg_duckdb_18 \
  pg_mooncake_18

2 · 配置 postgresql.conf 并启用扩展

pg_mooncake 需要开启逻辑复制（wal_level = logical），并在 shared_preload_libraries 中同时预加载 pg_duckdb 与 pg_mooncake：

-- 1. 配置逻辑复制、预加载动态库以及 DuckDB 本地扩展加载权限
ALTER SYSTEM SET wal_level = 'logical';
ALTER SYSTEM SET shared_preload_libraries = 'pg_duckdb,pg_mooncake';
ALTER SYSTEM SET duckdb.allow_community_extensions = 'true';
ALTER SYSTEM SET duckdb.allow_unsigned_extensions = 'true';

重启 PostgreSQL 实例（例如 sudo systemctl restart postgresql-18 或 pig pg restart），随后连接目标数据库启用扩展：

-- 2. 在目标数据库中创建扩展（CASCADE 会自动启用 pg_duckdb 1.2.0 依赖）
CREATE EXTENSION IF NOT EXISTS pg_mooncake CASCADE;

3 · Docker 容器镜像（Obsolete）

# 上游历史容器镜像（PostgreSQL 17 + 旧版 pg_mooncake）
docker run --name mooncake-demo \
  -e POSTGRES_HOST_AUTH_METHOD=trust \
  -p 5432:5432 -d \
  mooncakelabs/pg_mooncake

4 · 组件仓库与 GitHub 发行版

pg_mooncake —— 实时列存与 Iceberg 湖仓扩展

pg_mooncake（v0.3.0）为 PostgreSQL 提供实时列存镜像表（USING mooncake），内嵌 moonlink v0.0.1 与 duckdb_mooncake v0.0.2，并依赖 pg_duckdb v1.2.0。

可用性矩阵 (pg_mooncake)

软件包下载列表 (pg_mooncake)

签名校验与构建仓库

Pigsty PGSQL 软件仓库中的所有 RPM 与 DEB 软件包均使用 GPG 密钥签名；通过 pig repo add pgsql 完成配置后，dnf 与 apt 会自动校验签名完整性。所有软件包均由开源构建规范透明构建：