Skip to content

Docs: Add Write-Audit-Publish (WAP) documentation to spark-writes#15807

Open
jackylee-ch wants to merge 1 commit intoapache:mainfrom
jackylee-ch:document-wap-behavior-11528
Open

Docs: Add Write-Audit-Publish (WAP) documentation to spark-writes#15807
jackylee-ch wants to merge 1 commit intoapache:mainfrom
jackylee-ch:document-wap-behavior-11528

Conversation

@jackylee-ch
Copy link
Copy Markdown
Contributor

@jackylee-ch jackylee-ch commented Mar 28, 2026

  • Add a dedicated "Write-Audit-Publish (WAP)" section to spark-writes.md documenting both WAP ID mode (spark.wap.id) and WAP Branch mode (spark.wap.branch), including a comparison table and constraints
  • Cross-link write.wap.enabled in configuration.md to the new WAP section
  • Cross-link the Audit Branch section in branching.md to the new WAP reference

All SQL examples were verified against Spark 3.5.5 + Iceberg 1.11.0-SNAPSHOT:

  • WAP ID mode: Set spark.wap.id, INSERT, verify staged snapshot is invisible on main, then publish_changes makes it visible
  • WAP Branch mode: Set spark.wap.branch, INSERT, verify data visible on branch but not main, then fast_forward promotes to main
  • Mutual exclusion: Set both spark.wap.id and spark.wap.branch, confirm ValidationException: Cannot set both WAP ID and branch

Closes #11528

…ache#11528)

Add a dedicated WAP section to spark-writes.md documenting both WAP modes
(WAP ID and WAP Branch), their differences, requirements, and constraints.
Cross-link from configuration.md and branching.md.

Closes apache#11528
@github-actions github-actions bot added the docs label Mar 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

write.wap.enabled / spark.wap.branch / spark.wap.id behavior isn't really documented

1 participant