Skip to content

docs(databricks): document use_describe_as_json_for_relation_metadata flag#9176

Open
tejassp-db wants to merge 2 commits into
dbt-labs:currentfrom
tejassp-db:dbt-databricks-1.12.0
Open

docs(databricks): document use_describe_as_json_for_relation_metadata flag#9176
tejassp-db wants to merge 2 commits into
dbt-labs:currentfrom
tejassp-db:dbt-databricks-1.12.0

Conversation

@tejassp-db
Copy link
Copy Markdown

What are you changing in this pull request and why?

Documents the new use_describe_as_json_for_relation_metadata behavior flag introduced in dbt-databricks 1.12.0. The flag is registered in the adapter and called out in the dbt-databricks 1.12.0 CHANGELOG (PR databricks/dbt-databricks#1432) but was not yet documented on docs.getdbt.com.

Adds an entry on website/docs/reference/global-configs/databricks-changes.md covering:

  • What the flag controls (single DESCRIBE TABLE EXTENDED ... AS JSON call vs. multiple information_schema queries)
  • Behavior under false (default) vs true
  • Preconditions (Unity Catalog, non-foreign table, SQL warehouse or DBR 17.3+) and automatic per-relation fallback
  • How to enable in dbt_project.yml

Checklist

  • The changes in this PR meet the docs style guide/fundamentals required for all content.
  • Applied the proper versioning rules — N/A (uses the inline-row + section pattern already established on this page; the table carries the version)
  • The content in this PR requires a dbt release note — N/A for adapter behavior flags

… flag

Add an entry on the Databricks adapter behavior changes page for the
new flag introduced in dbt-databricks 1.12.0, including the false/true
behaviors, Unity Catalog / DBR 17.3+ requirements, per-relation
automatic fallback, and the dbt_project.yml enablement snippet.
@tejassp-db tejassp-db requested a review from a team as a code owner May 14, 2026 07:18
@vercel
Copy link
Copy Markdown

vercel Bot commented May 14, 2026

@tejassp-db is attempting to deploy a commit to the dbt-labs Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions Bot added the content Improvements or additions to content label May 14, 2026
@runleonarun runleonarun added the new contributor Label for first-time contributors label May 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content Improvements or additions to content new contributor Label for first-time contributors

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants