Skip to content

docs: Document Databricks U2M (User-to-Machine) OAuth authentication#1680

Merged
lukekim merged 2 commits into
trunkfrom
fix/1661-databricks-u2m-auth
May 7, 2026
Merged

docs: Document Databricks U2M (User-to-Machine) OAuth authentication#1680
lukekim merged 2 commits into
trunkfrom
fix/1661-databricks-u2m-auth

Conversation

@claudespice
Copy link
Copy Markdown
Collaborator

Summary

Fixes #1661

Adds documentation for the Databricks connector's third authentication method — User-to-Machine (U2M) OAuth — which is triggered when only databricks_client_id is supplied (without databricks_token or databricks_client_secret).

Changes

  • website/docs/components/data-connectors/databricks/index.md
    • New User-to-Machine (U2M) OAuth section documenting the interactive browser-based auth flow, the deferred (OnTrigger) initialization, and the Spark Connect mode limitation.
    • Refined the parameter table descriptions for databricks_client_id and databricks_client_secret so the M2M-vs-U2M distinction is clear at a glance.

Reference

Verified against spiceai/spiceai at origin/trunk:

  • crates/data-connectors/connector-databricks/src/lib.rsbuild_auth_credentials selects AuthCredentials::U2M when only client_id is set; ComponentInitialization::OnTrigger for U2M; the Spark Connect path does not implement U2M and uses default() initialization.

Test plan

  • cd website && npm run build passes locally
  • No broken-link-checker failures
  • Addition is in the unversioned website/docs/ only (per skill rule for new content)

Fixes #1661

Adds a third authentication section for the Databricks connector
covering U2M OAuth — triggered by supplying only databricks_client_id
without databricks_token or databricks_client_secret. Notes the
deferred (on-trigger) initialization and that Spark Connect mode does
not support U2M.

Verified against spiceai/spiceai trunk
(crates/data-connectors/connector-databricks/src/lib.rs).
@claudespice claudespice added enhancement New feature or request area/docs labels May 7, 2026
@claudespice claudespice self-assigned this May 7, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

✅ Pull with Spice Passed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected
  • ✅ Has at least one assignee: claudespice

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

🚀 deployed to https://494f0cb3.spiceai-org-website.pages.dev

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

🚀 deployed to https://2b4b778e.spiceai-org-website.pages.dev

@lukekim lukekim merged commit 9f261b6 into trunk May 7, 2026
6 checks passed
@lukekim lukekim deleted the fix/1661-databricks-u2m-auth branch May 7, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Document Databricks U2M (User-to-Machine) OAuth authentication

2 participants