Skip to content

docs: update pg_ivm comparison for IMMEDIATE mode completion#61

Merged
grove merged 1 commit intomainfrom
gap-pg-ivm-comparision-update
Mar 3, 2026
Merged

docs: update pg_ivm comparison for IMMEDIATE mode completion#61
grove merged 1 commit intomainfrom
gap-pg-ivm-comparision-update

Conversation

@grove
Copy link
Owner

@grove grove commented Mar 3, 2026

Update GAP_PG_IVM_COMPARISON.md to reflect that Transactional IVM Phase 1 + 3 are fully implemented.

Changes

  • Executive summary: IMMEDIATE mode marked as implemented (not planned); pg_ivm compat layer noted as postponed; remaining gap narrowed to PG version support only
  • Project overview: release 0.1.2 → 0.1.3
  • Maintenance model §3: 'Planned' → 'Implemented' with Phase 1–4 status and usage example
  • SQL feature summary §4: Maintenance timing winner changed from pg_ivm to pg_trickle (offers both models)
  • Known limitations §13: staleness caveat updated to mention IMMEDIATE mode; added recursive CTE restriction; migration scripts deferred to v0.3.0+
  • Unique features §15: 24 → 27 items (added IMMEDIATE+deferred, TopK, Diamond consistency)
  • pg_ivm gaps §15: Bump docker/build-push-action from 5 to 6 #1 (immediate maintenance) and Bump postgres from 18.1 to 18.2 in /tests #3 (TRUNCATE) marked ✅ Closed
  • Use-case fit §16: zero-staleness scenarios now recommend 'Either' instead of pg_ivm only
  • Coexistence §17: updated to reflect pg_trickle handles both deferred and immediate use-cases
  • Recommendations §18: IMMEDIATE mode + extended SQL marked Done; compat layer marked Postponed
  • Conclusion §19: 'two remaining structural gaps' → 'one remaining gap' (PG version support only)
  • API §6: Added IMMEDIATE mode example alongside existing DIFFERENTIAL example

Reflect that Transactional IVM Phase 1 + 3 are implemented:
- Executive summary: IMMEDIATE mode implemented, not planned
- Maintenance model: 'Planned' → 'Implemented' with usage example
- SQL feature summary: pg_trickle now wins maintenance timing dimension
- Unique features: 24 → 27 (IMMEDIATE, TopK, Diamond consistency)
- pg_ivm gaps: #1 (immediate) and #3 (TRUNCATE) marked closed
- Use-case fit: zero-staleness scenarios now recommend either extension
- Recommendations: IMMEDIATE + extended SQL marked done, compat postponed
- Conclusion: one remaining gap (PG version support) instead of two
- Coexistence: pg_trickle IMMEDIATE replaces pg_ivm for most use-cases
@grove grove merged commit 40db77c into main Mar 3, 2026
@grove grove deleted the gap-pg-ivm-comparision-update branch March 3, 2026 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant