Skip to content

Test coverage: on-disk (PGCN v1) and extension-version compatibility across builds #240

Description

@ChronicallyJD

Gap

Nothing tests that a columnar table written by one build of the extension is readable by a later build, and there is no CREATE / ALTER EXTENSION UPDATE / downgrade / DROP EXTENSION round-trip test. Only pgcolumnar--1.0.sql exists (fine at a single version), but the on-disk format (PGCN v1) has no automated compatibility guard across builds, and the on-disk encoding descriptor is host-endian (columnar.h:56).

Why this blocks a public release

Alpha data that a later version silently cannot read is a data-loss trap. Users need either a tested format-stability guarantee or an explicit "no format stability yet, reload from source across upgrades" notice backed by a test that the current format at least round-trips within a version.

Suggested acceptance criteria

  • A suite that writes a table with an older extension build/format and reads it with the current build, asserting identical query results (or a clean, documented rejection with a version error rather than a crash or wrong answer).
  • An ALTER EXTENSION pgcolumnar UPDATE path test once a second version script exists.
  • Document the format-stability policy (stable vs reload-required) in docs/limitations.md.

Found in a release-readiness review; sibling of the pg_upgrade and physical-replication coverage issues.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions