Skip to content

Update NEXT_CHANGELOG with detailed breaking changes for 3.4.1#1449

Merged
gopalldb merged 5 commits into
databricks:mainfrom
gopalldb:docs/update-changelog-breaking-changes
May 19, 2026
Merged

Update NEXT_CHANGELOG with detailed breaking changes for 3.4.1#1449
gopalldb merged 5 commits into
databricks:mainfrom
gopalldb:docs/update-changelog-breaking-changes

Conversation

@gopalldb
Copy link
Copy Markdown
Collaborator

@gopalldb gopalldb commented May 18, 2026

Summary

Expand the BREAKING CHANGES section in NEXT_CHANGELOG.md with full details of metadata JDBC spec compliance changes for 3.4.1.

Changes

  • Restructured from numbered list to detailed bullet points with migration guidance
  • Added missing breaking changes: empty types array, information_schema inclusion, getPrimaryKeys/getImportedKeys empty ResultSet, UPDATE_RULE/DELETE_RULE semantics
  • Added "Enhancements & New Features" section for the unified metadata backend
  • Moved geospatial default-enabled change into breaking changes section

This pull request was AI-assisted by Isaac.

gopalldb added 2 commits May 18, 2026 12:27
Expand BREAKING CHANGES section with full metadata JDBC spec compliance
details: catalog exact-match, empty types array, DECIMAL type name,
information_schema inclusion, empty ResultSet for non-existent objects,
and getImportedKeys NO_ACTION semantics.

Co-authored-by: Isaac
Signed-off-by: Gopal Lal <gopal.lal@databricks.com>
Co-authored-by: Isaac
Signed-off-by: Gopal Lal <gopal.lal@databricks.com>
Comment thread NEXT_CHANGELOG.md Outdated
instead of EWKT strings. Set `EnableGeoSpatialSupport=0` to restore the
previous behavior.

### Enhancements & New Features
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we not add a new section and move this under added / updated/ fixed?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

moved to added/updated

Comment thread NEXT_CHANGELOG.md
## [Unreleased]

### BREAKING CHANGES in 3.4.1
### BREAKING CHANGES in 3.4.1 — Metadata JDBC Spec Compliance
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

overall, i think we should stick to the added/updated/fixed structure that we have

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a major change, so we wanted to highlight this explicitly.

Comment thread NEXT_CHANGELOG.md Outdated
2. **`getColumnTypeName()`: DECIMAL columns now return `"DECIMAL"` without precision/scale** (e.g., `"DECIMAL"` not `"DECIMAL(10,2)"`). Use `getPrecision()` and `getScale()` for numeric constraints. JDBC spec: `getColumnTypeName()` returns the base type name only.
* **`getTables`/`getColumns`/`getSchemas`: Catalog parameter is now treated as
an exact-match identifier per JDBC spec.** Passing `%` or wildcard patterns as
catalog previously returned results across all catalogs; now returns zero rows.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

now returns zero rows is not always correct (e.g., catalog name containing underscore). Shall we remove it ?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rephrased

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated

Comment thread NEXT_CHANGELOG.md Outdated
return all types.

4. **Native geospatial type support (`GEOMETRY` and `GEOGRAPHY`) is now enabled by default.** `getObject()` now returns `IGeometry`/`IGeography` instances instead of EWKT strings. Set `EnableGeoSpatialSupport=0` to restore the previous behavior.
* **`getColumnTypeName()` for DECIMAL: Now returns `"DECIMAL"` without
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

DECIMAL columns now preserve precision/scale suffix right ?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed

Comment thread NEXT_CHANGELOG.md Outdated

3. **For DBSQL warehouses, metadata operations are now powered by SHOW SQL commands.** SQL Exec API mode already was powered by SHOW commands, now the same is true for Thrift server mode as well. To revert to native Thrift metadata RPCs, set `UseQueryForMetadata` to `0`.
* **`getTables` with empty types array: Now returns zero rows per JDBC spec.**
Previously ignored the empty array and returned all table types. Use `null` to
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think previously thrift didn't return all types for empty types array, only SEA did. Shall we remove previous behaviour from the changelog ?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed

gopalldb added 2 commits May 19, 2026 09:41
- Removed "Enhancements & New Features" section, moved SHOW commands
  entry under "Added" per existing structure (vikrantpuppala)
- Removed "now returns zero rows" from catalog param description —
  not always correct for names containing underscore (sreekanth-db)
- Removed incorrect DECIMAL getColumnTypeName breaking change —
  DECIMAL preserves precision/scale suffix (sreekanth-db)
- Removed "Previously ignored empty array" from getTables — behavior
  was inconsistent across Thrift/SEA (sreekanth-db)

Co-authored-by: Isaac
Signed-off-by: Gopal Lal <gopal.lal@databricks.com>
Co-authored-by: Isaac
Signed-off-by: Gopal Lal <gopal.lal@databricks.com>
@gopalldb gopalldb enabled auto-merge (squash) May 19, 2026 06:49
@gopalldb gopalldb merged commit 9a366d3 into databricks:main May 19, 2026
15 checks passed
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.

3 participants