# Mooncake 技术文档

> PostgreSQL 实时列存与 Apache Iceberg v2 湖仓套件统一技术文档中心：涵盖 pg_mooncake (v0.3.0)、moonlink (v0.0.1) 与 duckdb_mooncake (v0.0.2)。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

## 核心文档导航


- [简介与核心架构](/zh/docs/intro/) (v0\.3\.0) — 全面了解 Mooncake 架构：解析 `pg_mooncake`、`moonlink`、`duckdb_mooncake` 与 `pg_duckdb 1.2.0` 的协同机制，以及从 `v0.1` 到 `v0.2` / `v0.3` 的演进。
- [快速开始与安装](/zh/docs/getting-started/) (PG 14–18) — 通过 Pigsty 软件包或从源码安装 `pg_mooncake` 与 `pg_duckdb`，跟随 Hello World 教程创建第一张列存镜像表，并了解当前已知限制。
- [SQL 与配置参考手册](/zh/docs/reference/) (API) — 完整查阅 `mooncake.create_table`、`create_snapshot`、`optimize_table`、`list_tables` 存储过程、支持的查询形态、Iceberg S3/R2 配置与外部数据湖扫描。
- [应用场景与架构模式](/zh/docs/use-cases/) — 实时操作分析（HTAP）、时间分区大表冷热归档、零 ETL Postgres 湖仓一体以及 OpenTelemetry 日志分析的架构与 SQL 实践。
- [v0\.1 历史归档 \(Delta Lake\)](/zh/docs/v0.1/) (Deprecated) — 完整保留 `pg_mooncake v0.1`（`USING columnstore` + Delta Lake 存储）历史技术文档，供旧版存量部署参考并兼容 Wayback 历史链接。
- [关于、开源许可与 SBOM](/zh/docs/about/) (PGSTY) — PGSTY 社区维护说明、`MIT` 与 `BSL-1.1` 链接豁免许可证条款、Wayback Machine 历史文档恢复来源以及 Cargo 依赖安全审计报告。


## 核心组件与专题深入


- [系统架构剖析](/zh/docs/intro/architecture/) — 深入解析写入路径（`Logical WAL` -> `Moonlink`）、读取路径（`pg_duckdb` -> `duckdb_mooncake`）以及双层列存格式（内存 Arrow + Parquet + Apache Iceberg v2）。
- [Moonlink 实时摄取引擎](/zh/docs/intro/moonlink/) — 实时逻辑复制 CDC、Arrow 内存写缓冲、Roaring Bitmap 删除向量、LSN 快照一致性屏障，以及独立 `moonlink_service` REST/RPC 服务部署。
- [duckdb\_mooncake 与 DuckDB 2\.0](/zh/docs/intro/duckdb-mooncake/) — 了解 `duckdb_mooncake v0.0.2` 如何连接 DuckDB 2.0 与 Moonlink 元数据，并利用多文件 Parquet 统计信息接口实现高效分段跳过。
- [创建列存镜像表](/zh/docs/reference/create-columnstore/) — 使用 `CALL mooncake.create_table(...)` 将本地或远程（`src_uri`）PostgreSQL 普通表及分区表复制为 `USING mooncake` 实时列存镜像表。
- [Apache Iceberg 与对象存储](/zh/docs/reference/iceberg/) — 配置 `mooncake.default_bucket` 指向 AWS S3 或 Cloudflare R2，调用 `mooncake.create_snapshot` 物化快照，并通过外部引擎直接读取。
- [在 Postgres 中查询外部数据湖](/zh/docs/reference/query-data-lake/) — 在 PostgreSQL 内直接查询外部 Parquet、CSV、JSON、Apache Iceberg、Delta Lake 及 HuggingFace 数据集，并与本地行存表直接关联。

---

本节页面：

- [欢迎使用 pg_mooncake](/zh/docs/intro/): pg_mooncake (v0.3.0) 概览：在 PostgreSQL 内提供实时列存镜像表、Moonlink CDC 逻辑复制摄取、DuckDB 2.0 向量化执行与 Apache Iceberg v2 湖仓表。
- [快速开始与安装指南](/zh/docs/getting-started/): 在 PostgreSQL 14–18 上通过 Pigsty 软件包或从源码编译安装 pg_mooncake (v0.3.0) 与 pg_duckdb (1.2.0)，配置 postgresql.conf 并启用扩展。
- [SQL 接口、视图与配置参数参考手册](/zh/docs/reference/): pg_mooncake (v0.3.0) 完整 SQL 存储过程、元数据函数与 GUC 配置参数参考手册，涵盖 mooncake.create_table、create_snapshot、optimize_table、list_tables 与 DuckDB 参数。
- [应用场景与架构模式](/zh/docs/use-cases/): pg_mooncake (v0.3.0) 四大核心生产架构模式：实时操作分析（HTAP）、时间分区大表冷热归档、零 ETL Postgres 湖仓一体以及 OpenTelemetry 日志分析。
- [v0.1 历史归档：欢迎使用 pg_mooncake (Delta Lake)](/zh/docs/v0.1/): pg_mooncake v0.1（USING columnstore + Delta Lake 存储引擎）完整历史技术文档归档。
- [关于](/zh/docs/about/): PGSTY Mooncake 生态的项目维护说明、历史路线图、许可证、上游致谢、商标政策与软件物料清单（SBOM）。

---

反链：

- [页面未找到](/zh/404/)