feat: add tip on multi-table transactions in Unity Catalog - #5
Merged
Merged
Conversation
Covers the July 2026 GA of transactions on Unity Catalog managed Delta tables. Explains BEGIN ATOMIC ... END, the catalog commits prerequisite, and validating early with SIGNAL. The working example is a two-table funds transfer with an audit log: one transaction that commits, and one that trips a CHECK constraint on its last statement so the reader can verify the earlier writes were undone. Also adds the /s/transactions short link. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015Uwq9jFS44D6MAbNNeM82d
There was a problem hiding this comment.
🟢 Approval recommended
The changes are self-contained documentation + a redirect entry, and the added content/config appears structurally correct and consistent with existing tips.
Pull request overview
Adds a new tip page documenting how to use multi-table transactions with Unity Catalog managed Delta tables, including an end-to-end rollback demonstration and guidance on choosing transaction modes. It also adds a short-link redirect so the tip can be referenced via a stable /s/transactions URL.
Changes:
- Add a new Quarto tip explaining
BEGIN ATOMIC ... END;multi-statement transactions on UC-managed Delta tables, with examples for rollback andSIGNAL. - Add a Static Web Apps redirect for
/s/transactionsto the rendered tip page.
File summaries
| File | Description |
|---|---|
| site/tips/Unity Catalog/Transactions.qmd | New tip covering UC-managed Delta transactions, including setup, rollback demo, and mode selection guidance. |
| site/staticwebapp.config.json | Adds /s/transactions short-link redirect to the Transactions tip. |
Review details
- Files reviewed: 2/2 changed files
- Comments generated: 0
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Six slides built on the existing carousel design system (CarouselLayout,
CarouselCodeBlock, CAROUSEL_COLORS, Oswald/Poppins/JetBrains Mono):
1. Title - "All or nothing", the BEGIN ATOMIC syntax pill
2. Problem - three statements committing separately, one failing midway
3. Fix - the same transfer wrapped in BEGIN ATOMIC ... END
4. Proof - a transaction whose last statement trips a CHECK constraint,
with the verified aftermath showing the earlier writes undone
5. Rules - catalog commits, no DDL, mode choice, retries, snapshots, limits
6. CTA - dailydatabricks.tips/s/transactions
Registers the TransactionsCarousel composition and adds the
render:transactions script alongside the existing per-carousel scripts.
Includes the rendered slides at 3840x2160 and the assembled PDF.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015Uwq9jFS44D6MAbNNeM82d
- Retitle slide 2 to "Problem: 3 statements, 3 separate commits". - Replace the consequence banner with the coupling point: 3 commits with different outcomes that belong to one business transaction. - Refer to accounts by id instead of by personal names, on the problem slide notes and the balance stat tile on the proof slide. - Re-render the slides and rebuild the PDF. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015Uwq9jFS44D6MAbNNeM82d
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a short explainer for transactions on Unity Catalog managed Delta tables, which went GA on 22 July 2026. Nothing in
site/tips/covers it yet.Source: July 2026 platform release notes.
What's in it
site/tips/Unity Catalog/Transactions.qmdcatalogManagedon every write target.delta.feature.catalogManaged, add aCHECK (balance >= 0)constraint, seed two accounts.BEGIN ATOMIC ... END;and read back the committed balances.SIGNALinstead of doing work and discarding it.DROP SCHEMA ... CASCADE.BEGIN ATOMIC(row-level conflicts, automatic rollback) vsBEGIN TRANSACTION(table-level, manual commit), with a recommendation rather than a survey.Every claim is checked against the Transactions, Catalog commits, and SIGNAL reference pages, all linked from the tip.
Also
site/staticwebapp.config.json: adds the/s/transactionsshort link, following the existing/s/dml-privilegespattern.Notes
Generated by Claude Code