pg_mooncake

pg_mooncake

Columnstore Table in Postgres

Overview

IDExtensionPackageVersionCategoryLicenseLanguage
2440
pg_mooncake
pg_mooncake
0.2.0
OLAP
MIT
Rust
AttributeHas BinaryHas LibraryNeed LoadHas DDLRelocatableTrusted
----d--
No
No
No
Yes
no
no
Relationships
Requires
pg_duckdb
See Also
pg_duckdb
duckdb_fdw
pg_analytics
columnar
citus_columnar
pg_parquet
orioledb
timescaledb

unpublished release

Packages

TypeRepoVersionPG Major AvailabilityPackage PatternDependencies
EL
PIGSTY
0.2.0
18
17
16
15
14
13
pg_mooncake_$v*-
Debian
PIGSTY
0.2.0
18
17
16
15
14
13
postgresql-$v-pg-mooncake-
Linux / PGPG18PG17PG16PG15PG14PG13
el8.x86_64
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
MISS
el8.aarch64
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
MISS
el9.x86_64
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
MISS
el9.aarch64
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
MISS
el10.x86_64
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
MISS
el10.aarch64
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
PIGSTY 0.2.0
MISS
d12.x86_64
MISS
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
MISS
d12.aarch64
MISS
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
MISS
d13.x86_64
MISS
MISS
MISS
MISS
MISS
MISS
d13.aarch64
MISS
MISS
MISS
MISS
MISS
MISS
u22.x86_64
MISS
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
MISS
u22.aarch64
MISS
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
MISS
u24.x86_64
MISS
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
MISS
u24.aarch64
MISS
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
PIGSTY 0.1.2
MISS
PackageVersionOSORGSIZEFile URL
pg_mooncake_180.2.0el8.x86_64pigsty11.1 MiBpg_mooncake_18-0.2.0-1PIGSTY.el8.x86_64.rpm
pg_mooncake_180.2.0el8.aarch64pigsty9.8 MiBpg_mooncake_18-0.2.0-1PIGSTY.el8.aarch64.rpm
pg_mooncake_180.2.0el9.x86_64pigsty10.5 MiBpg_mooncake_18-0.2.0-1PIGSTY.el9.x86_64.rpm
pg_mooncake_180.2.0el9.aarch64pigsty10.2 MiBpg_mooncake_18-0.2.0-1PIGSTY.el9.aarch64.rpm
pg_mooncake_180.2.0el10.x86_64pigsty10.3 MiBpg_mooncake_18-0.2.0-1PIGSTY.el10.x86_64.rpm
pg_mooncake_180.2.0el10.aarch64pigsty10.0 MiBpg_mooncake_18-0.2.0-1PIGSTY.el10.aarch64.rpm
PackageVersionOSORGSIZEFile URL
pg_mooncake_170.2.0el8.x86_64pigsty11.1 MiBpg_mooncake_17-0.2.0-1PIGSTY.el8.x86_64.rpm
pg_mooncake_170.2.0el8.aarch64pigsty9.8 MiBpg_mooncake_17-0.2.0-1PIGSTY.el8.aarch64.rpm
pg_mooncake_170.2.0el9.x86_64pigsty10.5 MiBpg_mooncake_17-0.2.0-1PIGSTY.el9.x86_64.rpm
pg_mooncake_170.2.0el9.aarch64pigsty10.2 MiBpg_mooncake_17-0.2.0-1PIGSTY.el9.aarch64.rpm
pg_mooncake_170.2.0el10.x86_64pigsty10.3 MiBpg_mooncake_17-0.2.0-1PIGSTY.el10.x86_64.rpm
pg_mooncake_170.2.0el10.aarch64pigsty10.0 MiBpg_mooncake_17-0.2.0-1PIGSTY.el10.aarch64.rpm
postgresql-17-pg-mooncake0.1.2d12.x86_64pigsty23.6 MiBpostgresql-17-pg-mooncake_0.1.2-1PIGSTY~bookworm_amd64.deb
postgresql-17-pg-mooncake0.1.2d12.aarch64pigsty20.7 MiBpostgresql-17-pg-mooncake_0.1.2-1PIGSTY~bookworm_arm64.deb
postgresql-17-pg-mooncake0.1.2u22.x86_64pigsty25.1 MiBpostgresql-17-pg-mooncake_0.1.2-1PIGSTY~jammy_amd64.deb
postgresql-17-pg-mooncake0.1.2u22.aarch64pigsty23.1 MiBpostgresql-17-pg-mooncake_0.1.2-1PIGSTY~jammy_arm64.deb
postgresql-17-pg-mooncake0.1.2u24.x86_64pigsty25.1 MiBpostgresql-17-pg-mooncake_0.1.2-1PIGSTY~noble_amd64.deb
postgresql-17-pg-mooncake0.1.2u24.aarch64pigsty23.3 MiBpostgresql-17-pg-mooncake_0.1.2-1PIGSTY~noble_arm64.deb
PackageVersionOSORGSIZEFile URL
pg_mooncake_160.2.0el8.x86_64pigsty11.1 MiBpg_mooncake_16-0.2.0-1PIGSTY.el8.x86_64.rpm
pg_mooncake_160.2.0el8.aarch64pigsty9.8 MiBpg_mooncake_16-0.2.0-1PIGSTY.el8.aarch64.rpm
pg_mooncake_160.2.0el9.x86_64pigsty10.5 MiBpg_mooncake_16-0.2.0-1PIGSTY.el9.x86_64.rpm
pg_mooncake_160.2.0el9.aarch64pigsty10.2 MiBpg_mooncake_16-0.2.0-1PIGSTY.el9.aarch64.rpm
pg_mooncake_160.1.1el9.aarch64pigsty27.7 MiBpg_mooncake_16-0.1.1-1PIGSTY.el9.aarch64.rpm
pg_mooncake_160.2.0el10.x86_64pigsty10.3 MiBpg_mooncake_16-0.2.0-1PIGSTY.el10.x86_64.rpm
pg_mooncake_160.2.0el10.aarch64pigsty10.0 MiBpg_mooncake_16-0.2.0-1PIGSTY.el10.aarch64.rpm
postgresql-16-pg-mooncake0.1.2d12.x86_64pigsty23.6 MiBpostgresql-16-pg-mooncake_0.1.2-1PIGSTY~bookworm_amd64.deb
postgresql-16-pg-mooncake0.1.2d12.aarch64pigsty20.7 MiBpostgresql-16-pg-mooncake_0.1.2-1PIGSTY~bookworm_arm64.deb
postgresql-16-pg-mooncake0.1.2u22.x86_64pigsty25.1 MiBpostgresql-16-pg-mooncake_0.1.2-1PIGSTY~jammy_amd64.deb
postgresql-16-pg-mooncake0.1.2u22.aarch64pigsty23.1 MiBpostgresql-16-pg-mooncake_0.1.2-1PIGSTY~jammy_arm64.deb
postgresql-16-pg-mooncake0.1.2u24.x86_64pigsty25.1 MiBpostgresql-16-pg-mooncake_0.1.2-1PIGSTY~noble_amd64.deb
postgresql-16-pg-mooncake0.1.2u24.aarch64pigsty23.3 MiBpostgresql-16-pg-mooncake_0.1.2-1PIGSTY~noble_arm64.deb
PackageVersionOSORGSIZEFile URL
pg_mooncake_150.2.0el8.x86_64pigsty11.1 MiBpg_mooncake_15-0.2.0-1PIGSTY.el8.x86_64.rpm
pg_mooncake_150.2.0el8.aarch64pigsty9.8 MiBpg_mooncake_15-0.2.0-1PIGSTY.el8.aarch64.rpm
pg_mooncake_150.2.0el9.x86_64pigsty10.5 MiBpg_mooncake_15-0.2.0-1PIGSTY.el9.x86_64.rpm
pg_mooncake_150.2.0el9.aarch64pigsty10.2 MiBpg_mooncake_15-0.2.0-1PIGSTY.el9.aarch64.rpm
pg_mooncake_150.1.1el9.aarch64pigsty27.7 MiBpg_mooncake_15-0.1.1-1PIGSTY.el9.aarch64.rpm
pg_mooncake_150.2.0el10.x86_64pigsty10.3 MiBpg_mooncake_15-0.2.0-1PIGSTY.el10.x86_64.rpm
pg_mooncake_150.2.0el10.aarch64pigsty10.0 MiBpg_mooncake_15-0.2.0-1PIGSTY.el10.aarch64.rpm
postgresql-15-pg-mooncake0.1.2d12.x86_64pigsty23.6 MiBpostgresql-15-pg-mooncake_0.1.2-1PIGSTY~bookworm_amd64.deb
postgresql-15-pg-mooncake0.1.2d12.aarch64pigsty20.7 MiBpostgresql-15-pg-mooncake_0.1.2-1PIGSTY~bookworm_arm64.deb
postgresql-15-pg-mooncake0.1.2u22.x86_64pigsty25.1 MiBpostgresql-15-pg-mooncake_0.1.2-1PIGSTY~jammy_amd64.deb
postgresql-15-pg-mooncake0.1.2u22.aarch64pigsty23.1 MiBpostgresql-15-pg-mooncake_0.1.2-1PIGSTY~jammy_arm64.deb
postgresql-15-pg-mooncake0.1.2u24.x86_64pigsty25.2 MiBpostgresql-15-pg-mooncake_0.1.2-1PIGSTY~noble_amd64.deb
postgresql-15-pg-mooncake0.1.2u24.aarch64pigsty23.3 MiBpostgresql-15-pg-mooncake_0.1.2-1PIGSTY~noble_arm64.deb
PackageVersionOSORGSIZEFile URL
pg_mooncake_140.2.0el8.x86_64pigsty11.1 MiBpg_mooncake_14-0.2.0-1PIGSTY.el8.x86_64.rpm
pg_mooncake_140.2.0el8.aarch64pigsty9.8 MiBpg_mooncake_14-0.2.0-1PIGSTY.el8.aarch64.rpm
pg_mooncake_140.2.0el9.x86_64pigsty10.5 MiBpg_mooncake_14-0.2.0-1PIGSTY.el9.x86_64.rpm
pg_mooncake_140.2.0el9.aarch64pigsty10.2 MiBpg_mooncake_14-0.2.0-1PIGSTY.el9.aarch64.rpm
pg_mooncake_140.1.1el9.aarch64pigsty27.7 MiBpg_mooncake_14-0.1.1-1PIGSTY.el9.aarch64.rpm
pg_mooncake_140.2.0el10.x86_64pigsty10.3 MiBpg_mooncake_14-0.2.0-1PIGSTY.el10.x86_64.rpm
pg_mooncake_140.2.0el10.aarch64pigsty10.0 MiBpg_mooncake_14-0.2.0-1PIGSTY.el10.aarch64.rpm
postgresql-14-pg-mooncake0.1.2d12.x86_64pigsty23.6 MiBpostgresql-14-pg-mooncake_0.1.2-1PIGSTY~bookworm_amd64.deb
postgresql-14-pg-mooncake0.1.2d12.aarch64pigsty20.7 MiBpostgresql-14-pg-mooncake_0.1.2-1PIGSTY~bookworm_arm64.deb
postgresql-14-pg-mooncake0.1.2u22.x86_64pigsty25.1 MiBpostgresql-14-pg-mooncake_0.1.2-1PIGSTY~jammy_amd64.deb
postgresql-14-pg-mooncake0.1.2u22.aarch64pigsty23.1 MiBpostgresql-14-pg-mooncake_0.1.2-1PIGSTY~jammy_arm64.deb
postgresql-14-pg-mooncake0.1.2u24.x86_64pigsty25.2 MiBpostgresql-14-pg-mooncake_0.1.2-1PIGSTY~noble_amd64.deb
postgresql-14-pg-mooncake0.1.2u24.aarch64pigsty23.4 MiBpostgresql-14-pg-mooncake_0.1.2-1PIGSTY~noble_arm64.deb

Source

pig build get pg_mooncake; # get pg_mooncake source code
pig build dep pg_mooncake; # install build dependencies
pig build pkg pg_mooncake; # build extension rpm or deb
pig build ext pg_mooncake; # build extension rpms

Install

To add the required PGDG / PIGSTY upstream repository, use:

pig repo add pgsql -u   # add PGDG + Pigsty repo and update cache (leave existing repos)

Install this extension with:

pig ext install pg_mooncake; # install by extension name, for the current active PG version
pig ext install pg_mooncake; # install via package alias, for the active PG version
pig ext install pg_mooncake -v 18;   # install for PG 18
pig ext install pg_mooncake -v 17;   # install for PG 17
pig ext install pg_mooncake -v 16;   # install for PG 16
pig ext install pg_mooncake -v 15;   # install for PG 15
pig ext install pg_mooncake -v 14;   # install for PG 14

Create this extension with:

CREATE EXTENSION pg_mooncake;

Usage

pg_mooncake 0.2.0 (unpublished yet) is rewritten in Rust and designed as a sub-extension of pg_duckdb.

Quick Setup

Install pg_duckdb and pg_mooncake with pig:

pig repo add pigsty -u
pig install pg_duckdb pg_mooncake

Edit postgresql.conf, then restart to take effect

shared_preload_libraries = 'pg_duckdb,pg_mooncake'
duckdb.allow_community_extensions = true
wal_level = logical

Hello Worlds

-- create the extension alone with pg_duckdb
CREATE EXTENSION pg_mooncake CASCADE;

-- Next, create a regular Postgres table trades:
CREATE TABLE trades(
  id bigint PRIMARY KEY,
  symbol text,
  time timestamp,
  price real
);

-- Then, create a columnstore mirror trades_iceberg that stays in sync with trades:
CALL mooncake.create_table('trades_iceberg', 'trades');

-- Now, insert some data into trades:
INSERT INTO trades VALUES
    (1,  'AMD', '2024-06-05 10:00:00', 119),
    (2, 'AMZN', '2024-06-05 10:05:00', 207),
    (3, 'AAPL', '2024-06-05 10:10:00', 203),
    (4, 'AMZN', '2024-06-05 10:15:00', 210);

-- Finally, query it with duckdb
EXPLAIN
    SELECT avg(price) FROM trades_iceberg WHERE symbol = 'AMZN';

You will see the DuckDBScan in the execution plan:

                         QUERY PLAN
------------------------------------------------------------
 Custom Scan (DuckDBScan)  (cost=0.00..0.00 rows=0 width=0)
   DuckDB Execution Plan:

 ┌───────────────────────────┐
 │    UNGROUPED_AGGREGATE    │
 │    ────────────────────   │
 │    Aggregates: avg(#0)    │
 └─────────────┬─────────────┘
 ┌─────────────┴─────────────┐
 │         PROJECTION        │
 │    ────────────────────   │
 │   CAST(price AS DOUBLE) │                           │
 │          ~0 rows          │
 └─────────────┬─────────────┘
 ┌─────────────┴─────────────┐
 │       MOONCAKE_SCAN       │
 │    ────────────────────   │
 │   Table: trades_iceberg   │
 │     Projections: price    │
 │                           │
 │          Filters:         │
 │       symbol='AMZN' │                           │
 │          ~0 rows          │
 └───────────────────────────┘
Last updated on