欢迎使用 pg_mooncake on Mooncake

系统架构

Mon, 01 Jan 0001 00:00:00 +0000

pg_mooncake（v0.3.0）在单个 PostgreSQL 实例内部深度融合了三个核心组件：

pg_duckdb（v1.2.0）：在 PostgreSQL 进程内嵌入 DuckDB v2.0.0 向量化分析执行引擎，并将涉及非堆表访问方法的分析查询路由至 DuckDB 执行。
moonlink（v0.0.1）：内嵌于 pg_mooncake 后台工作进程中的 Rust 实时列存引擎，负责消费 PostgreSQL 逻辑复制流、维护内存 Apache Arrow 写缓冲区与 Roaring Bitmap 删除向量、刷写 Parquet 数据文件，并生成 Apache Iceberg v2 表元数据。
duckdb_mooncake（v0.0.2）：随 pg_mooncake 打包至本地扩展目录（mooncake.extension_repository）并自动加载的 DuckDB 2.0 C++/Rust 存储扩展。它通过本地 Unix 域套接字 RPC（pg_mooncake/moonlink.sock）与 Moonlink 通信，融合扫描磁盘 Parquet 文件与内存 Arrow 批次。

三者共同向 PostgreSQL 暴露了原生的 USING mooncake 表访问方法（Table Access Method），并通过 CALL mooncake.create_table(dst, src) 进行统一管理。

Moonlink 实时摄取引擎

Mon, 01 Jan 0001 00:00:00 +0000

Moonlink（pgsty/moonlink，当前正式版本 v0.0.1）是一个使用 Rust 编写的高性能实时列存摄取库与独立服务，旨在无需引入 Apache Spark 或 Kafka 的前提下，面向在线业务系统与事件流实时构建并维护 Apache Iceberg v2 与 Delta Lake 表。

duckdb_mooncake 与 DuckDB 2.0 集成

Mon, 01 Jan 0001 00:00:00 +0000

duckdb_mooncake（pgsty/duckdb_mooncake，当前正式版本 v0.0.2，MIT 许可证）是面向 DuckDB v2.0.0 的 C++ 与 Rust FFI 存储扩展。它使 DuckDB（无论是独立运行还是通过 pg_duckdb 1.2.0 内嵌在 PostgreSQL 中）能够直接挂载 moonlink 元数据目录，并对 Moonlink 表执行高性能向量化扫描。

v0.1 与 v0.2 / v0.3 架构演进对比

Mon, 01 Jan 0001 00:00:00 +0000

pg_mooncake 的技术架构经历了三个关键演进阶段：

v0.1（早期 Delta Lake 架构）：引入直接通过 CREATE TABLE ... USING columnstore 创建的列存表，底层基于 Delta Lake 与早期 pg_duckdb 实现读写。
v0.2（Moonlink 与 Apache Iceberg 架构重设计）：废弃对列存表的直接写入，改用由 moonlink 逻辑复制驱动的**实时列存镜像（Columnstore Mirror）**架构（CALL mooncake.create_table(dst, src) + USING mooncake），引入内存 Arrow 写缓冲、Roaring 删除向量与 Apache Iceberg v2 元数据。
v0.3.0（PGSTY 社区维护正式版）：将 pg_mooncake 升级至 pgrx 0.19.3（全面支持 PostgreSQL 14–18），将 duckdb_mooncake v0.0.2 移植适配至 pg_duckdb 1.2.0 与 DuckDB v2.0.0，修复了 Moonlink（v0.0.1）在无关表推进 WAL 时的快照挂起问题与分区表复制标识设置，并修复了 20 余项 RustSec 依赖安全漏洞。

寻找 v0.1 历史版本文档？

早期 v0.1 版本（USING columnstore、mooncake.create_secret、mooncake.columnstore_tables、mooncake.read_parquet）的完整文档已归档保留在 v0.1 历史文档 (Delta Lake) 中。