Skip to content

CXP-1162: docs: add Databricks match_baton_id formats to developer ID tables - #576

Open
luisina-santos wants to merge 1 commit into
ConductorOne:mainfrom
luisina-santos:luisinasantos/databricks-match-baton-id-formats
Open

luisina-santos wants to merge 1 commit into
ConductorOne:mainfrom
luisina-santos:luisinasantos/databricks-match-baton-id-formats

Conversation

@luisina-santos

Copy link
Copy Markdown
Contributor

Summary

Since v0.1.16, baton-databricks sets a RawId on every resource, so objects pre-created with match_baton_id merge on sync. But the developer ID tables left out Databricks. Databricks also breaks their "use the native ID" rule: a group's value is a compound resource ID, not the Databricks group ID.

  • developer/recipes-id: adds a Databricks row, a key point, and a new Databricks resource IDs subsection with the value for each resource type (group, workspace, workspace role, account role, user, service principal)
  • developer/debugging: adds Databricks group and workspace rows to the "Check what ID the connector uses" table, with a link to the full table
  • developer/syncing: adds a Databricks row to the RawId table
  • developer/terraform-best-practices and developer/terraform: add a warning after the Okta examples. For Databricks groups, a bare group ID in match_baton_id produces a duplicate resource instead of a merge

I checked the values against the baton-databricks source (pkg/connector/groups.go, roles.go, workspaces.go, raw_id_test.go). The account-group, workspace and workspace-role merges were measured on a sandbox tenant. The workspace-scoped group format (workspace/<deployment-name>/group/<group-id>) comes from the source and was not tested live.

Linear: CXP-1162

🤖 Generated with Claude Code

baton-databricks sets RawId to its resource ID, which for groups is a
compound path rather than the native Databricks group ID. Document the
per-resource-type values and warn about the bare-ID mismatch in the
Terraform guides.

Refs CXP-1162

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@luisina-santos

Copy link
Copy Markdown
Contributor Author

@mindymo docs updates needs to be merged when v0.1.16 reaches stable channel

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant