# v0.1 历史归档：欢迎使用 pg_mooncake (Delta Lake)

> pg_mooncake v0.1（USING columnstore + Delta Lake 存储引擎）完整历史技术文档归档。

---

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

---

> [!WARNING] `pg_mooncake v0.1` 历史归档文档（Delta Lake 引擎）
> 本页归档的是早期 **`pg_mooncake v0.1`** 版本文档（采用直接 `CREATE TABLE ... USING columnstore` DDL 与 Delta Lake 存储）。从 `v0.2` 及 PGSTY 维护的 **`v0.3.0`** 版本起，`pg_mooncake` 已全面转向基于 [`moonlink`](/zh/docs/intro/moonlink/) 的实时列存镜像架构（`CALL mooncake.create_table` + `USING mooncake`）与 Apache Iceberg v2。最新文档请参阅[简介](/zh/docs/intro/)与 [v0.1 与 v0.2 / v0.3 架构演进对比](/zh/docs/intro/0.1-vs-0.2/)。

`pg_mooncake v0.1` 是第一代 PostgreSQL 列存扩展，通过 `USING columnstore` 表访问方法与底层的 Delta Lake + DuckDB（`pg_duckdb`）提供分析加速。

![pg_mooncake 定位图](/img/mooncake/pg_mooncake_intro.jpg)

## `v0.1` 版本核心特性

1. 支持直接在 `USING columnstore` 表上执行事务型 `INSERT`、`UPDATE` 与 `DELETE`
2. 数据以 Parquet + Delta Lake 元数据格式存储在本地磁盘或 S3 / R2 对象存储上
3. 通过内嵌 DuckDB 提供向量化查询执行
4. 支持普通 PostgreSQL 堆表与 `USING columnstore` 表之间的直接关联查询

## `v0.1` 历史归档目录

| 章节 | 包含页面 |
|:---|:---|
| **架构简介** | [v0.1 架构说明](/zh/docs/v0.1/architecture/) |
| **快速开始** | [安装与启动](/zh/docs/v0.1/get-started/) · [Hello World](/zh/docs/v0.1/hello-world/) · [对象存储配置](/zh/docs/v0.1/cloud-storage/) · [在 Neon 上运行](/zh/docs/v0.1/neon-postgres/) |
| **参考手册** | [参考总览](/zh/docs/v0.1/reference/) · [列存 DDL](/zh/docs/v0.1/columnstore-ddl/) · [外部引擎查询元数据](/zh/docs/v0.1/columnstore-metadata/) · [GUC 配置参数](/zh/docs/v0.1/configurations/) · [数据导入](/zh/docs/v0.1/load-data/) · [查询外部文件](/zh/docs/v0.1/query-external-files/) · [支持的查询形态](/zh/docs/v0.1/query-shapes/) |
| **应用场景** | [数据归档](/zh/docs/v0.1/archiving/) · [操作型分析](/zh/docs/v0.1/operational-analytics/) · [数据仓库与 dbt](/zh/docs/v0.1/warehousing/) |
{.wide .expand}

---

本节页面：

- [v0.1 架构说明 (Delta Lake 与 USING columnstore)](/zh/docs/v0.1/architecture/): pg_mooncake v0.1 架构解析：USING columnstore 表访问方法、Parquet + Delta Lake 元数据以及 DuckDB 读写路径。
- [v0.1 快速开始](/zh/docs/v0.1/get-started/): pg_mooncake v0.1 历史安装指南（Docker 容器与源码构建）。
- [v0.1 Hello World (USING columnstore)](/zh/docs/v0.1/hello-world/): pg_mooncake v0.1 USING columnstore 表的基础操作：建表、增删改、事务回滚与关联查询。
- [v0.1 云端对象存储配置 (mooncake.create_secret)](/zh/docs/v0.1/cloud-storage/): 在 pg_mooncake v0.1 中使用 mooncake.create_secret 与 mooncake.default_bucket 配置 S3 与 Cloudflare R2 存储桶。
- [v0.1 在 Neon Postgres 上使用](/zh/docs/v0.1/neon-postgres/): 在 Neon Serverless PostgreSQL 上启用 pg_mooncake v0.1 的历史配置说明。
- [v0.1 参考手册总览](/zh/docs/v0.1/reference/): pg_mooncake v0.1 DDL 语法、Delta Lake 元数据表、GUC 配置参数、数据导入与外部文件查询参考索引。
- [v0.1 列存表 DDL (USING columnstore)](/zh/docs/v0.1/columnstore-ddl/): 在 pg_mooncake v0.1 中使用 USING columnstore 创建与删除列存表、支持的数据类型与约束说明。
- [v0.1 在 Postgres 外部查询列存表](/zh/docs/v0.1/columnstore-metadata/): 在 pg_mooncake v0.1 中查看 mooncake.columnstore_tables 与 mooncake.data_files，并通过 Python Polars 读取 Delta Lake 表。
- [v0.1 GUC 配置参数](/zh/docs/v0.1/configurations/): pg_mooncake v0.1 历史 GUC 配置变量（mooncake.default_bucket、maximum_memory、maximum_threads 等）。
- [v0.1 数据导入指南](/zh/docs/v0.1/load-data/): 在 pg_mooncake v0.1 中从 PostgreSQL 表、Parquet/CSV/JSON 文件、Iceberg/Delta 表及 HuggingFace 导入数据。
- [v0.1 查询外部数据文件](/zh/docs/v0.1/query-external-files/): 在 pg_mooncake v0.1 中使用 mooncake.read_parquet、mooncake.read_csv 与 mooncake.read_json 直接查询外部数据文件。
- [v0.1 支持的查询形态](/zh/docs/v0.1/query-shapes/): pg_mooncake v0.1 中的分析型查询模式、不支持的 PostgreSQL 函数及 DuckDB 占位函数说明。
- [v0.1 数据归档方案](/zh/docs/v0.1/archiving/): pg_mooncake v0.1 中将历史数据从行存表迁移至 USING columnstore 归档表的历史方案。
- [v0.1 操作型分析（触发器 + pg_cron 暂存表方案）](/zh/docs/v0.1/operational-analytics/): 在 Moonlink 推出之前，pg_mooncake v0.1 使用触发器、暂存表与 pg_cron 定时批处理实现准实时分析的历史方案。
- [v0.1 数据仓库与 dbt 集成](/zh/docs/v0.1/warehousing/): pg_mooncake v0.1 每日聚合流水线与通过 default_table_access_method = 'columnstore' 集成 dbt 的历史指南。

---

反链：

- [v0.1 vs v0.2 & v0.3](/zh/docs/intro/0.1-vs-0.2/)