pg_liquid 0.1.0

This Release
pg_liquid 0.1.0
Date
Status
Stable
Latest Stable
pg_liquid 0.1.7 —
Other Releases
Abstract
LIquid-inspired Datalog graph query extension for PostgreSQL
Description
pg_liquid brings LIquid-style graph querying, assertions, recursive closure, compounds, and row normalizers to PostgreSQL as a native extension.
Released By
michaelgolfi
License
PostgreSQL
Resources
Special Files
Tags

Extensions

pg_liquid 0.1.0
LIquid-inspired Datalog graph query extension for PostgreSQL

Documentation

GAPS
LIquid Blog Parity Status
00_INDEX
pg_liquid Documentation
06_TESTING
6. Testing
03_EXECUTION
3. Execution
05_SECURITY
5. Security
Changes
Changes
._bench_guard_baseline
._bench_guard_baseline
07_ROADMAP
7. Roadmap
02_DATA_MODEL
2. Data Model
08_OPERATIONS
8. Operations
04_STORAGE
4. Storage
LIQUID_BLOG
LIQUID_BLOG
bench_guard_baseline
bench_guard_baseline
README
Vitalis Food + Goal + Lifestyle Ontology (Modular Layout)
01_OVERVIEW
1. Overview

README

pg_liquid

pg_liquid is a PostgreSQL extension that maps the LIquid blog language and data model onto native PostgreSQL storage and execution.

It ships:

  • liquid.query(program text)
  • liquid.query_as(principal text, program text)
  • liquid.read_as(principal text, program text)
  • row normalizer management functions for projecting relational rows into LIquid compounds

Supported LIquid program features include:

  • % comments
  • .-terminated assertions and rule definitions
  • one terminal ? query
  • Edge(...)
  • named compounds via Type@(cid=..., role=...)
  • query-local recursive rules
  • CLS-aware reads through liquid.read_as(...) and liquid.query_as(...)

Version

This PGXN package is version 0.1.0.

Build And Install

Build and install against the target PostgreSQL instance:

cd libs/pg_liquid
make
make install

Then create the extension in the target database:

create extension pg_liquid;

Upgrade

The shipped upgrade path covers the legacy internal versions 1.0.0, 1.1.0, and 1.2.0 to the public release 0.1.0:

alter extension pg_liquid update to '0.1.0';

Alias scripts are also included for the legacy non-semver version names 1.0, 1.1, and 1.2.

Validation

Useful local checks:

make -C libs/pg_liquid package-check
make -C libs/pg_liquid installcheck
make -C libs/pg_liquid bench-check
make -C libs/pg_liquid pgxn-package

package-check validates META.json, the control file, and the referenced SQL install script. pgxn-package builds a release tarball under release/.

Repository Layout

The operational rollout details live in docs/08_OPERATIONS.md.