Skip to main content

How to connect Databricks to Coworker

Connect Databricks so Coworker can see your catalogs, tables and warehouse activity. Databricks is admin-connected using a service principal.

What Coworker can do with Databricks

  • Read Unity Catalog metadata and system tables for the connected workspace

  • Run read queries against your SQL warehouse to answer data questions

  • Mirror Unity Catalog grants into access policies, so people see the catalogs and schemas their UC permissions reach

Before you start

  • You must be a Coworker Network Admin

  • You need a Databricks service principal with OAuth machine-to-machine credentials (client ID and secret)

  • You need the workspace host, workspace ID and SQL warehouse ID

Connect as an admin

  1. Open Data Sources from the admin settings in Coworker and select Databricks.

  2. Enter the service principal client ID and secret.

  3. Enter the workspace host, workspace ID and SQL warehouse ID — all three must match the same workspace.

  4. Save.

Connect as a member

Databricks has no individual connection flow. This is not interactive user OAuth.

Good to know

  • The service principal needs access to the SQL warehouse, system tables and the relevant Unity Catalog metadata. A token can mint successfully while catalog or grant discovery stays incomplete.

  • For full-fidelity access mirroring, give the principal metastore-level visibility. When grants cannot be fully read, Coworker degrades to workspace-roster membership — a documented, surfaced over-share rather than a silent guess.

Did this answer your question?