Skip to content

feat(lakebase): add deploy-first workflow and schema permission docs#46

Open
pkosiec wants to merge 4 commits intomainfrom
pkosiec/impr-lakebase
Open

feat(lakebase): add deploy-first workflow and schema permission docs#46
pkosiec wants to merge 4 commits intomainfrom
pkosiec/impr-lakebase

Conversation

@pkosiec
Copy link
Copy Markdown
Member

@pkosiec pkosiec commented Apr 2, 2026

Summary

  • Add Deploy-First Workflow section to the Lakebase AppKit reference explaining schema ownership and the correct order of operations (deploy → grant databricks_superuser → develop locally)
  • Strengthen Schema Initialization wording: SP "cannot access any existing schemas or tables", not just public
  • Add Schema Permissions for Deployed Apps subsection to the Lakebase CLI skill with cross-reference
  • Expand troubleshooting tables in both skills with permission denied for schema <name> and "works locally but fails after deploy" scenarios

This pull request was AI-assisted by Isaac.

pkosiec added 4 commits April 2, 2026 17:50
…ion docs

Document the deploy-first workflow to prevent the common permission error
when running a Lakebase app locally before deploying. The SP has
CONNECT_AND_CREATE permission and cannot access schemas created by other
roles — deploying first ensures the SP owns the schema.

Co-authored-by: Isaac
The deploy-first workflow and schema permission docs are fundamentally
about Lakebase's permission model, not AppKit specifically. Move the
canonical content to databricks-lakebase/SKILL.md so it applies
regardless of which app framework is used, and have the AppKit
lakebase reference point there instead.

Co-authored-by: Isaac
…reference

Add deploy-first callout before Schema Initialization and strengthen
Local Development warning to CRITICAL to prevent schema ownership issues.

Co-authored-by: Isaac
…oject-creators

Project creators already have sufficient access to SP-owned schemas;
only other team members need the databricks_superuser role assignment.

Co-authored-by: Isaac
@pkosiec pkosiec marked this pull request as ready for review April 2, 2026 18:31
@pkosiec pkosiec requested review from a team and lennartkats-db as code owners April 2, 2026 18:31
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