databricks-unity-catalog

Manage Unity Catalog governance, access control, system tables, and volume file operations.

4|1|Updated May 22, 2026
One-click install
npx skills add https://github.com/ThomazRossito/ai-data-agents --skill databricks-unity-catalog-thomazrossito
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: databricks-unity-catalog
Source: https://github.com/ThomazRossito/ai-data-agents/tree/main/plugins/ai-data-agents/skills/databricks-unity-catalog
Command: npx skills add https://github.com/ThomazRossito/ai-data-agents --skill databricks-unity-catalog-thomazrossito

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing who can access what data in Databricks Unity Catalog is complex: grants require traversal privileges, external locations need storage credentials, and answering questions like "who can read this table" or "what did this query cost" requires knowing the privilege model and system table schemas. This Skill provides the operational guidance to perform these governance and observability tasks correctly. ## Core Features & Use Cases - Access Control & Privileges: Grant and revoke access with GRANT/REVOKE, transfer ownership, inspect effective grants with SHOW GRANTS, and reason about the securable hierarchy and privilege inheritance. - Fine-Grained Security: Implement row filters, column masks, and dynamic views using current_user() and is_account_group_member() to restrict which rows and column values users see. - Observability via System Tables: Query system.access audit logs and lineage, system.billing usage, system.query history, and system.lakeflow job runs for security monitoring, cost analysis, and impact analysis. - Use Case: A platform admin needs to give an analytics team read-only access to a gold schema while masking PII columns, then verify access via audit logs. This Skill walks through the GRANT statements, the column mask UDF, and the system.access.audit query to confirm. ## Quick Start Ask the AI to grant the data_readers group SELECT access on the analytics.gold schema in Unity Catalog and show who currently has access to a specific table.

Frequently Asked Questions about databricks-unity-catalog

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

FAQPage Schema
How do I grant read access to a table in Unity Catalog?▼

Grant read access with three statements: GRANT USE CATALOG on the catalog, GRANT USE SCHEMA on the schema, and GRANT SELECT on the table or schema. Data access requires traversal privileges on all ancestors plus the action privilege on the object itself.

How to find out who can access a table in Databricks Unity Catalog?▼

Run SHOW GRANTS ON TABLE catalog.schema.table to see direct grants, or query system.information_schema.table_privileges to include inherited grants via the inherited_from column. The Python SDK w.grants.get_effective returns the full effective permission set.

What is the difference between row filters, column masks, and dynamic views?▼

Row filters and column masks are UDFs attached directly to the base table and enforced for every reader, while dynamic views self-censor using current_user() and only govern readers who query through the view. Prefer filters and masks when the base table itself must be protected.

Why does GRANT SELECT still give PERMISSION_DENIED in Unity Catalog?▼

The grantee is missing traversal privileges: SELECT alone is not enough without USE CATALOG on the catalog and USE SCHEMA on the schema. Grant both traversal privileges alongside SELECT so the principal can reach the object.

Why does my system table query return zero rows?▼

The most common cause is querying beyond the retention window, since system tables retain bounded history (typically 365 days). Probe the available range with SELECT min(event_date), max(event_date) to distinguish no data in window from no data at all.

Does databricks fs work with Unity Catalog volume paths?▼

Yes, but databricks fs requires the dbfs: scheme prefix even for UC volume paths, such as dbfs:/Volumes/catalog/schema/volume/path. Without the prefix the CLI treats the path as local filesystem and fails with a no such directory error.