databricks-unity-catalog

Query Unity Catalog system tables and manage volume file operations on Databricks.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/AarushiShah/coding-agents-databricks-apps --skill databricks-unity-catalog-aarushishah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-unity-catalog
Source: https://github.com/AarushiShah/coding-agents-databricks-apps/tree/main/.claude/skills/databricks-unity-catalog
Command: npx skills add https://github.com/AarushiShah/coding-agents-databricks-apps --skill databricks-unity-catalog-aarushishah

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires databricks-sdk.

What problem does it solve? It removes the guesswork from Databricks governance and file management by providing ready-to-use SQL queries for system tables (audit, lineage, billing, jobs, query history) and step-by-step guidance for Unity Catalog volume file operations. ## Core Features & Use Cases - System Table Queries: Pre-built SQL for audit logs, table and column lineage, billing/DBU usage, cluster and warehouse metrics, job run history, and query performance analysis. - Volume File Operations: Upload, download, list, create directories, and delete files in /Volumes/ paths using MCP tools, the Python SDK, or SQL. - Governance & Permissions: Grant and audit READ/WRITE VOLUME privileges, enable system schemas, and track external lineage to sources like Salesforce. - Use Case: A platform admin needs to find who accessed a sensitive table last week and how much each workspace spent on compute. This Skill provides the exact audit and billing queries to answer both questions immediately. ## Quick Start Ask the agent to show the upstream lineage for a specific table or to upload a local CSV file into a Unity Catalog volume.

Frequently Asked Questions about databricks-unity-catalog

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

FAQPage Schema
How do I query table lineage in Databricks Unity Catalog?

Query the system.access.table_lineage table filtering by target_table_full_name to find upstream sources, or by source_table_full_name to find downstream consumers. Always filter on event_date or event_time to limit the scan, since lineage data is retained for 365 days.

How to upload files to a Unity Catalog volume?

Use the upload_to_volume MCP tool with a local path and a /Volumes/catalog/schema/volume/ destination, or the Python SDK's w.files.upload_from method with use_parallel=True for large files. You need WRITE VOLUME privilege plus USE CATALOG and USE SCHEMA on the parents.

How do I analyze Databricks billing and DBU usage?

Query system.billing.usage grouped by usage_date, sku_name, or workspace_id to compute DBU consumption. Join with system.billing.list_prices on sku_name and cloud to estimate costs, filtering price_end_time IS NULL for current prices.

Why do I get PERMISSION_DENIED when accessing a volume?

PERMISSION_DENIED means you lack READ VOLUME or WRITE VOLUME on the volume, or USE CATALOG/USE SCHEMA on its parents. Ask an admin to grant the required privilege, for example GRANT READ VOLUME ON VOLUME main.default.my_volume TO your_group.

What is the retention period for Databricks system tables?

Audit logs, billing usage, and lineage data are retained for 365 days, while query history and compute events are retained for 30 days. Plan scheduled aggregation jobs if you need longer retention for compliance or trending.

How do I enable Unity Catalog system tables?

System schemas must be enabled per metastore before querying. Use the Python SDK w.system_schemas.enable with your metastore ID and schema name such as access or billing, or run databricks system-schemas enable from the CLI.