Skip to main content

Release Notes

This page summarizes coordinated SchemaX releases across:

  • Python SDK/CLI (schemaxpy)
  • VS Code extension (schemax-vscode)
  • Documentation site (docs/schemax)

0.2.11 (2026-03-11)

Highlights

  • v5 multi-target architecture — Projects now support multiple provider targets (e.g., multiple Unity Catalog catalogs or mixed providers) via a targets dict in project.json. Existing v4 projects auto-migrate on first load.
  • --scope CLI parameter — New flag on sql, validate, apply, and workspace-state. Currently plumbed through CLI and interfaces; target-scoped state loading will be enabled in a follow-up release.
  • Provider-specific settings UI — Project Settings in the VS Code extension now renders per-provider configuration with target tabs for multi-target projects.
  • Renamed target_name to scope — Eliminated naming confusion between environment target (--target dev) and provider scope (--scope analytics).

Package versions

  • Python SDK/CLI: 0.2.11
  • VS Code extension: 0.2.11
  • Docs site package: 0.2.11

Changelogs

0.2.10 (2026-03-10)

Highlights

  • View tags — Full support for ALTER VIEW SET TAGS and ALTER VIEW UNSET TAGS (Databricks DBR 13.3+). Add, update, and remove tags on views through the Designer, bulk operations, or state files. Tracked in changelog, SQL generation, and deployment.
  • Multi-principal bulk grants — Enter multiple principals (comma-separated) in the bulk operations panel to grant privileges to several users, groups, or service principals at once.
  • Python environment detection — The VS Code extension now finds schemax and Python in conda, miniconda, venv, uv, pyenv, and poetry environments. Reads the VS Code Python interpreter setting first, then falls back to PATH.
  • State differ refactored — Split the monolithic differ into focused modules (operation builders, grant differ, metadata differ, bulk operations) for maintainability. Public API unchanged.
  • Faster live integration tests — Existence checks use single information_schema queries instead of full catalog discovery (~7x faster on large metastores).

Package versions

  • Python SDK/CLI: 0.2.10
  • VS Code extension: 0.2.10
  • Docs site package: 0.2.10

Changelogs

0.2.9 (2026-03-06)

Highlights

  • Databricks Asset Bundles integration — New schemax bundle command generates DAB-compatible resource YAML and deploy script. Deploy SchemaX migrations as a serverless Python task in your existing DAB project, with environment resolution via ${bundle.target}. Validated end-to-end on Databricks serverless.
  • Serverless runtime authschemax apply no longer requires --profile. In DAB serverless jobs, authentication is handled by the Databricks runtime automatically.
  • VS Code sidebar — Added "Import Existing Assets" and "Generate DAB Resources" buttons to the extension sidebar. New schemax.generateBundle command invokes schemax bundle directly from the editor.
  • Warehouse cold start resilience — Statement execution now polls PENDING/RUNNING states up to 120s, handling SQL warehouse cold starts gracefully instead of failing immediately.
  • Documentation — New Databricks Asset Bundles guide with setup, CI/CD integration, and architecture overview.
  • Expanded test coverage — 56+ new integration tests covering rollback helpers, SQL generation edge cases, constraint variants, column/table operations, and DAB compatibility regressions.

Package versions

  • Python SDK/CLI: 0.2.9
  • VS Code extension: 0.2.9
  • Docs site package: 0.2.9

Changelogs

0.2.8 (2026-02-27)

Highlights

  • Open VSX publishing — Extension is now published to Open VSX (namespace schemax) for Cursor, Antigravity, and other Open VSX consumers.
  • Dedicated publish workflows — Separate GitHub Actions: VS Code Marketplace (publish-vscode-extension.yml) and Open VSX (publish-openvsx.yml). Both support tag push and manual workflow dispatch.
  • Publishing docs — Extension README documents CI-only publishing and Open VSX setup for maintainers.

Package versions

  • Python SDK/CLI: 0.2.8
  • VS Code extension: 0.2.8
  • Docs site package: 0.2.8

Changelogs

0.2.7 (2026-03-02)

Highlights

  • Unity hard cutover to explicit multi-catalog model.
  • Legacy implicit workspaces now fail fast with deterministic error code LEGACY_SINGLE_CATALOG_UNSUPPORTED.
  • CLI/extension alignment for explicit multi-catalog workflows and clear legacy error surfacing in VS Code.
  • Release automation hardening: fixed version bump script corruption for semantic versions starting with 0.

Package versions

  • Python SDK/CLI: 0.2.7
  • VS Code extension: 0.2.7
  • Docs site package: 0.2.7

Changelogs

0.2.6 (2026-03-02)

Highlights

  • Python-first architecture cutover for schema semantics and command workflows.
  • Multi-provider foundation with Hive MVP provider modules.
  • Standardized CLI JSON envelopes for extension/runtime integration.
  • Cross-platform reliability fixes (including Windows profile/config resolution).
  • Expanded contract, integration, and architecture fitness test coverage.
  • Unity moved to explicit multi-catalog as the default model (legacy implicit workspaces now fail fast).

Package versions

  • Python SDK/CLI: 0.2.6
  • VS Code extension: 0.2.6
  • Docs site package: 0.2.6

Changelogs