SQL 接口、视图与配置参数参考手册 on Mooncake

创建列存镜像表

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

在 pg_mooncake 中，列存表通过 mooncake.create_table 存储过程创建，作为现有 PostgreSQL 行存表（普通堆表或分区表）的**实时同步镜像（Columnstore Mirror）**运行。

存储过程签名

CALL mooncake.create_table(
    dst text,
    src text,
    src_uri text DEFAULT NULL,
    table_config json DEFAULT NULL
);

参数名称	类型	默认值	参数说明
`dst`	`text`	（必填）	要创建的目标列存镜像表名称（支持 `schema.table` 格式，未指定 Schema 时默认为 `public`）。
`src`	`text`	（必填）	作为复制源的 PostgreSQL 行存表或分区父表名称（支持 `schema.table` 格式）。
`src_uri`	`text`	`NULL`	当从外部远程 PostgreSQL 实例复制时，指定远程连接串（`postgresql://user:pass@host:port/dbname`）。为 `NULL` 时默认从当前本地数据库复制。
`table_config`	`json`	`NULL`	可选的 JSON 配置对象，用于定制 Moonlink 表级摄取与存储参数（例如 `write_buffer_size`）。

参数名勘误说明：请使用 src_uri（而非 source_uri）

上游早期 v0.2 文档中存在一处笔误，将远程连接参数写成了 source_uri => 'postgresql://...'。在 pg_mooncake 的真实 SQL 定义（src/functions.rs）中，该参数的准确名称为 src_uri。使用命名参数调用时请务必传入 src_uri => 'postgresql://...'。

查询列存表与支持的查询形态

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

通过 CALL mooncake.create_table(dst, src) 创建的列存镜像表可以直接使用标准 PostgreSQL SELECT 语法进行查询。在底层，pg_mooncake 与 pg_duckdb 1.2.0 会将分析型查询自动转换并下推至内嵌的 DuckDB v2.0.0 向量化执行引擎。

Apache Iceberg v2 与对象存储配置

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

pg_mooncake（v0.3.0）中的每一张列存镜像表均由 moonlink 驱动，底层数据存储为标准的 Parquet 文件，并自动维护 Apache Iceberg v2 表元数据。

默认情况下，Moonlink 将文件保存在本地数据目录 $PGDATA/pg_mooncake/ 下。你可以配置 pg_mooncake 直接将数据写入 Amazon S3、Cloudflare R2、MinIO 或 Google Cloud Storage (GCS)，从而让外部数据湖计算引擎（DuckDB、Apache Spark、Trino、Snowflake、PyIceberg）直接从对象存储读取你的 PostgreSQL 表数据。

在 Postgres 中直接查询外部数据湖

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

由于 pg_mooncake（v0.3.0）通过 pg_duckdb 1.2.0 内嵌了 DuckDB v2.0.0 引擎，你可以在不将数据事先导入本地堆表的情况下，直接从 PostgreSQL 查询外部数据湖（本地磁盘、AWS S3、Cloudflare R2、GCS、HTTP 或 HuggingFace hf:// 数据集）中的文件。