lakebase-setup

Configure and validate Lakebase persistence for Databricks deployments with PostgreSQL permissions.

4|Updated May 9, 2026
One-click install
npx skills add https://github.com/victorlou/housing-assistant --skill lakebase-setup-victorlou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lakebase-setup
Source: https://github.com/victorlou/housing-assistant/tree/main/app/app-templates/.claude/skills/lakebase-setup
Command: npx skills add https://github.com/victorlou/housing-assistant --skill lakebase-setup-victorlou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Lakebase-backed agent memory can fail or become unavailable due to missing dependencies, misconfigured Databricks bundle resources, missing environment variables, or insufficient Postgres permissions for the app service principal.

Core Features & Use Cases

  • Instance-aware Lakebase provisioning: Guides configuration for both provisioned Lakebase instances and autoscaling (project/branch/database ID) setups.
  • Databricks bundle configuration: Shows how to add the correct database (provisioned) or postgres (autoscaling) resource in databricks.yml and wire required env vars for embedding.
  • Service principal permission grants: Provides a critical post-deploy permission grant workflow to prevent table/schema migration errors and checkpoint/store access failures.
  • Troubleshooting for common errors: Covers “Failed to connect to Lakebase”, missing embedding_dims, unresolved instance values, and permission denied errors.

Quick Start

Ask the agent to set up Lakebase for agent long-term memory by configuring the correct Databricks bundle resources for your Lakebase type and ensuring the service principal permissions are granted for the required schemas and tables.

Frequently Asked Questions about lakebase-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Lakebase connection failures for Databricks agent memory?

Resolve Lakebase connection failures by verifying that your Databricks bundle includes the correct database or postgres resource in databricks.yml and that all required LAKEBASE environment variables are properly configured for your deployment type.

Why does my Databricks agent fail with Postgres permission denied errors?

Postgres permission denied errors occur when the app service principal lacks explicit schema and table grants, which you can resolve by running the provided post-deploy permission grant script to prevent migration and checkpoint access failures.

How do I configure Databricks bundle resources for an autoscaling Lakebase instance?

Configure autoscaling Lakebase instances by adding the postgres resource to your databricks.yml file and wiring the required project, branch, and database ID environment variables to enable dynamic agent memory storage provisioning.

What causes missing embedding_dims errors when setting up Lakebase agent memory?

Missing embedding_dims errors arise from incomplete Lakebase environment variable configuration, requiring you to properly map the embedding dimensions in your Databricks bundle deployment to align with your long-term and short-term memory templates.

Do I need a provisioned or autoscaling Lakebase setup for Databricks agent chat history?

You can use either a provisioned Lakebase instance with a database resource or an autoscaling setup using a postgres resource in databricks.yml, depending on whether your agent chat history requires fixed capacity or dynamic project and branch scaling.

What is the best way to prevent table schema migration errors in Lakebase-backed agent memory?

Prevent table schema migration errors by executing a critical post-deploy workflow that grants the Databricks app service principal explicit Postgres permissions for required schemas and tables before the agent begins writing long-term memory.