Skip to content

docs(readme): add Known limitations section for retention#38

Merged
rrreeeyyy merged 1 commit into
mainfrom
phase-9/readme-known-limitations
May 6, 2026
Merged

docs(readme): add Known limitations section for retention#38
rrreeeyyy merged 1 commit into
mainfrom
phase-9/readme-known-limitations

Conversation

@rrreeeyyy
Copy link
Copy Markdown
Owner

Summary

Captures the conclusion of the 2026-05 retention discussion: skaldberg has no row-level retention story today and the right move is to wait for either upstream path to open rather than ship an external Athena DELETE workaround.

The new "Known limitations" section names two paths and which one(s) we wait for:

  1. iceberg-rust gaining row-level DELETE / RowDelta. PRs in flight as of 2026-05: apache/iceberg-rust#2185 (CoW OverwriteAction), #2203 (RowDelta for MoR), #2367 (delete-files in snapshot producer). Realistic landing window 0.10 or 0.11 (~mid-2026 if the cadence holds).
  2. AWS extending PutTableRecordExpirationConfiguration from AWS-managed tables (S3 Storage Lens / SageMaker Catalog) to customer-created S3 Tables. The mechanism, IAM, and console UI exist; no roadmap signal on the coverage extension.

Storage cost growth is documented (~9 GB/year per 100 samples/s sustained at $0.025/GB-month) so the trade-off of deferring is explicit. External Athena DELETE is mentioned as the escape hatch for users who can't wait, with the caveat that it adds an ops piece outside skaldberg's "operation-less" surface.

Folded in alongside:

Test plan

  • N/A — docs only. Read through the rendered output.

🤖 Generated with Claude Code

Captures the conclusion of the 2026-05 retention discussion: skaldberg
has no row-level retention story today and the right move is to wait
for either upstream path to open rather than ship an external Athena
DELETE workaround.

  - iceberg-rust gaining row-level DELETE / RowDelta. PRs in flight:
    apache/iceberg-rust#2185 (CoW OverwriteAction), #2203 (RowDelta
    for MoR), #2367 (delete-files in snapshot producer). Realistic
    landing window 0.10 / 0.11 (~mid-2026).
  - AWS extending PutTableRecordExpirationConfiguration from
    AWS-managed tables (S3 Storage Lens / SageMaker Catalog) to
    customer-created S3 Tables. Mechanism exists, no roadmap signal.

Storage cost growth is documented (~9 GB/year per 100 samples/s
sustained, $0.025/GB-month) so the "what does deferring cost"
trade-off is explicit. External Athena DELETE is mentioned as the
escape hatch for users who can't wait, with the caveat that it
adds an ops piece outside skaldberg's "operation-less" surface.

Also folded:
  - `without (...)` modifier moved from the fallback list into the
    pushdown table (PR #37 made it SQL-pushed).
  - Roadmap "Open" replaced with "In progress" pointing at the
    Phase 9 dogfood scenario (the actual current activity).
  - Phase 8 "Done" entry now lists `without (...)` so the status
    line matches what's in the tree.
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