Skip to content

docs(aibi-dashboards): add custom Vega-Lite visualization guide - #239

Closed
alexott wants to merge 1 commit into
databricks:mainfrom
alexott:aibi-custom-visualizations
Closed

docs(aibi-dashboards): add custom Vega-Lite visualization guide#239
alexott wants to merge 1 commit into
databricks:mainfrom
alexott:aibi-custom-visualizations

Conversation

@alexott

@alexott alexott commented Aug 11, 2026

Copy link
Copy Markdown

What

Adds guidance for building custom visualizations (Vega-Lite / custom-vega-viz) in AI/BI dashboards — a widget type the skill did not previously cover.

  • New reference: skills/databricks-aibi-dashboards/references/6-custom-visualizations.md
  • Wired into SKILL.md: a custom-vega-viz row in the Widget Index (version 1) and a Reference Files entry
  • Regenerated the plugins/databricks/** bundles + manifest.json via scripts/skills.py

What the reference covers

  • The serialized custom-vega-viz widget envelope (the part the public docs omit): version: 1, jsonSpec.spec as a stringified Vega-Lite JSON, encodings.fields as a flat column list, data.queryName, disaggregated: true, and the data.name: "databricks_query" literal.
  • Responsive container sizing.
  • The SQL-precompute pattern for grids / matrices / networks (Vega-Lite doesn't compute those layouts itself).
  • Verified limitation: databricks_mark_selection cross-filtering breaks layered specs (blank canvas, no error) — single-view only.
  • Treemap / image-mark limits and theme-aware signals.

All content was verified by building and deploying a working custom-viz dashboard (an ATT&CK coverage matrix over a Delta table).

Testing

  • python3 scripts/skills.py validate → "Everything is up to date" (drift check)
  • python3 -m unittest discover -s tests -p '*_test.py' → 119 passed

This pull request and its description were written by Isaac.

Add references/6-custom-visualizations.md documenting the custom-vega-viz widget (Vega-Lite): the serialized widget envelope (stringified jsonSpec, encodings.fields, data.queryName, disaggregated:true, databricks_query data name), container sizing, the SQL-precompute pattern for grids/matrices, and the verified limitation that databricks_mark_selection cross-filtering breaks layered specs. Wire it into the SKILL.md Widget Index and Reference Files tables, and regenerate the plugin bundles.

Co-authored-by: Isaac
Signed-off-by: Alex Ott <alexey.ott@databricks.com>
@alexott

alexott commented Aug 11, 2026

Copy link
Copy Markdown
Author

Closing it - will resubmit via universe

@alexott alexott closed this Aug 11, 2026
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