Skip to content

v0.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 May 03:19
· 245 commits to main since this release
v0.3.0
282fe38

pgRDF v0.3.0

The first official pgRDF release: a Rust-native PostgreSQL extension for RDF, SPARQL, OWL 2 RL inference, and SHACL.

What's in this release

  • Storage engine — dictionary-encoded terms, LIST-partitioned quads on graph_id, SPO/POS/OSP hexastore covering indexes. UDFs: pgrdf.{add_graph, count_quads, put_term, get_term, put_quad}.
  • Turtle ingest — pgrdf.{load_turtle, parse_turtle, load_turtle_verbose, parse_turtle_verbose} with shmem dict cache + prepared bulk-INSERT.
  • SPARQL SELECT/ASK — N-pattern BGPs; FILTER (identity, boolean, REGEX, IN, BOUND, term-type, numeric ordering, string funcs); DISTINCT/LIMIT/OFFSET/ORDER BY; OPTIONAL/UNION/MINUS; aggregates with type-aware MIN/MAX, HAVING (alias + inline), GROUP_CONCAT, SAMPLE; BIND projection.
  • OWL 2 RL inference — pgrdf.materialize(graph_id) via reasonable 0.4. Idempotent.
  • SHACL validation — pgrdf.validate(data, shapes) stub with stable JSONB schema (real integration blocked by ERRATA E-009; see Known issues).
  • Performance — shmem dict cache (< 1 µs hit), prepared-plan cache, prepared bulk-INSERT.

Test bar

158 automated tests (93 pgrx + 39 pg_regress + 23 W3C-shape + 3 LUBM-shape) plus 24-ontology / 17,134-triple manual smoke. CI green on PG 14–17 × {amd64, arm64}.

Install

Drop-in (any Postgres 14–17)

# Download the matching tarball:
curl -L -O https://github.com/styk-tv/pgRDF/releases/download/v0.3.0/pgrdf-0.3.0-pg17-glibc-amd64.tar.gz
# Verify the checksum:
sha256sum pgrdf-0.3.0-pg17-glibc-amd64.tar.gz
# (compare against the aggregate SHA256SUMS on the release page)
tar -xzf pgrdf-0.3.0-pg17-glibc-amd64.tar.gz
cd pgrdf-0.3.0-pg17-glibc-amd64
sudo cp lib/pgrdf.so $(pg_config --pkglibdir)/
sudo cp share/extension/* $(pg_config --sharedir)/extension/

Then in psql:

CREATE EXTENSION pgrdf;
SELECT pgrdf.version();   -- → 0.3.0

Requires shared_preload_libraries = 'pgrdf' in postgresql.conf (see INSTALL spec §6).

Docker compose

See guide/01-install.md for the compose-based local development path.

Supported Postgres

PG 14, 15, 16, 17 across {amd64, arm64} = 8 prebuilt tarballs. PG 18 deferred per ERRATA E-006.

Known issues

  • E-006 — pgrx 0.18 / Postgres 18 deferred to v0.4.
  • E-007 — INSTALL §7's extension_control_path GUC forward
    path is blocked by E-006; v0.3 ships via per-file bind mounts at
    canonical $libdir/$sharedir/extension paths instead.
  • E-009 — SHACL real integration blocked by upstream dep conflict.
  • E-010 — cargo audit advisories — all informational, no security impact.

See specs/ERRATA.v0.2.md for the full text.

Deferred to v0.4

Named-graph GRAPH { … } with IRI ↔ graph_id mapping, SPARQL UPDATE (including graph-scoped variants), graph-level lifecycle UDFs, CONSTRUCT, property paths (* / + / ? / ^), multi-triple OPTIONAL, VALUES, BIND-downstream, aggregates over UNION, DESCRIBE, heap_multi_insert (2× ingest target). See specs/SPEC.pgRDF.LLD.v0.4-FUTURE.md §2.

Upgrading

pgRDF v0.x reserves the right to break schema between minor releases. There is no in-place upgrade path; ALTER EXTENSION pgrdf UPDATE is not supported in v0.x. The supported flow is: dump your data via SQL (decode _pgrdf_quads against _pgrdf_dictionary per graph and serialise to Turtle externally), DROP EXTENSION pgrdf CASCADE, install the new version, then CREATE EXTENSION pgrdf and re-load. v1.0 will introduce proper ALTER EXTENSION pgrdf UPDATE migrations alongside a frozen on-disk schema. See docs/06-installation.md § Upgrade between v0.x versions for the full procedure.

License

Apache 2.0. Copyright 2026 Peter Styk <peter@styk.tv>.

Full changelog: CHANGELOG.md.

Full Changelog: https://github.com/styk-tv/pgRDF/commits/v0.3.0

Assets 11
Loading