databricks-sql-connector 4.4.0__tar.gz → 4.5.0__tar.gz

{databricks_sql_connector-4.4.0 → databricks_sql_connector-4.5.0}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release History
 
+# 4.5.0 (2026-09-01)
+- Upgrade Databricks SQL Kernel to 1.0.0.
+- Add JWT private-key M2M and Azure Entra authentication for kernel connections.
+- Add `oauth_token_cache_enabled` for kernel U2M token caching.
+- Forward kernel telemetry, socket timeout, OAuth, identity-federation, and row-limit settings.
+- Preserve empty metadata filters and fix async statement telemetry.
+- Lazy-load Apache Thrift for kernel and SEA connections.
+- Deprecate SEA in favor of the kernel backend.
+
 # 4.4.0 (2026-07-22)
 - Raised the minimum supported Python version to 3.10, dropping the end-of-life 3.8/3.9, to update the lockfile and clear CVE-flagged dependencies in the repo (databricks/databricks-sql-python#798)
 - Fix: `REMOVE` staging operations no longer require `staging_allowed_local_path` to be set, since removing a remote file does not touch the local filesystem (databricks/databricks-sql-python#726)

{databricks_sql_connector-4.4.0 → databricks_sql_connector-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databricks-sql-connector
-Version: 4.4.0
+Version: 4.5.0
 Summary: Databricks SQL Connector for Python
 License: Apache-2.0
 License-File: LICENSE
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Provides-Extra: kernel
 Provides-Extra: pyarrow
-Requires-Dist: databricks-sql-kernel (>=0.2.0,<0.3.0) ; (python_version >= "3.10") and (extra == "kernel")
+Requires-Dist: databricks-sql-kernel (>=1.0.0,<2.0.0) ; (python_version >= "3.10") and (extra == "kernel")
 Requires-Dist: lz4 (>=4.0.2,<5.0.0) ; python_version >= "3.10" and python_version < "3.14"
 Requires-Dist: lz4 (>=4.4.5,<5.0.0) ; python_version >= "3.14"
 Requires-Dist: oauthlib (>=3.1.0,<4.0.0)
@@ -60,6 +60,10 @@ For the latest documentation, see
 - [Databricks](https://docs.databricks.com/dev-tools/python-sql-connector.html)
 - [Azure Databricks](https://docs.microsoft.com/en-us/azure/databricks/dev-tools/python-sql-connector)
 
+For a full reference of every `sql.connect(...)` keyword argument — type,
+default, per-backend support (Thrift vs Kernel), and meaning — see
+[`CONNECTION_PARAMETERS.md`](CONNECTION_PARAMETERS.md).
+
 ## Quickstart
 
 ### Installing the core library
@@ -90,7 +94,8 @@ Notes:
   `cp310-abi3`). On older interpreters the `[kernel]` extra installs
   nothing and `use_kernel=True` raises an `ImportError`.
 - The extra also pulls in PyArrow, which the kernel result path requires.
-- Authentication supports PAT (`access_token`), OAuth M2M, and OAuth U2M.
+- Authentication supports PAT (`access_token`), OAuth M2M/U2M, and SP-wide
+  workload identity federation (`identity_federation_client_id`).
 
 
 ```bash

{databricks_sql_connector-4.4.0 → databricks_sql_connector-4.5.0}/README.md

@@ -22,6 +22,10 @@ For the latest documentation, see
 - [Databricks](https://docs.databricks.com/dev-tools/python-sql-connector.html)
 - [Azure Databricks](https://docs.microsoft.com/en-us/azure/databricks/dev-tools/python-sql-connector)
 
+For a full reference of every `sql.connect(...)` keyword argument — type,
+default, per-backend support (Thrift vs Kernel), and meaning — see
+[`CONNECTION_PARAMETERS.md`](CONNECTION_PARAMETERS.md).
+
 ## Quickstart
 
 ### Installing the core library
@@ -52,7 +56,8 @@ Notes:
   `cp310-abi3`). On older interpreters the `[kernel]` extra installs
   nothing and `use_kernel=True` raises an `ImportError`.
 - The extra also pulls in PyArrow, which the kernel result path requires.
-- Authentication supports PAT (`access_token`), OAuth M2M, and OAuth U2M.
+- Authentication supports PAT (`access_token`), OAuth M2M/U2M, and SP-wide
+  workload identity federation (`identity_federation_client_id`).
 
 
 ```bash

{databricks_sql_connector-4.4.0 → databricks_sql_connector-4.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "databricks-sql-connector"
-version = "4.4.0"
+version = "4.5.0"
 description = "Databricks SQL Connector for Python"
 authors = ["Databricks <databricks-sql-connector-maintainers@databricks.com>"]
 license = "Apache-2.0"
@@ -48,26 +48,19 @@ pybreaker = "^1.0.0"
 requests-kerberos = {version = "^0.15.0", optional = true}
 # Optional Rust kernel backend for ``use_kernel=True`` (PyO3 wheel).
 # Pulled in only via the ``[kernel]`` extra below. The published wheel
-# is ``abi3`` with ``Requires-Python: >=3.10`` (built ``abi3-py310``),
-# so the dependency is gated to Python >= 3.10: on 3.8/3.9 the
-# ``[kernel]`` extra resolves to nothing and ``use_kernel=True`` raises
-# a clear ImportError at runtime (see backend/kernel/_errors.py).
+# is ``abi3`` with ``Requires-Python: >=3.9`` (built ``abi3-py39``); the
+# dependency remains gated to the connector's Python >= 3.10 support floor.
 #
-# Floor is 0.2.0 (``^0.2.0`` == ``>=0.2.0,<0.3.0``). The kernel is
-# pre-1.0, so each 0.x minor may carry breaking changes — the ``<0.3.0``
-# cap means we bump this deliberately when the kernel ships 0.3.0 rather
-# than letting a potentially-breaking minor flow in automatically. 0.2.0
-# keeps the same Requires-Python (>=3.10) and pyarrow (>=23.0.1,<24) pin
-# as 0.1.x, so the gating below is unchanged.
-databricks-sql-kernel = {version = "^0.2.0", optional = true, python = ">=3.10"}
+# Floor is 1.0.0 (``^1.0.0`` == ``>=1.0.0,<2.0.0``), allowing compatible
+# 1.x releases while keeping the next major upgrade deliberate. The kernel's
+# pyarrow constraint remains >=23.0.1,<24.
+databricks-sql-kernel = {version = "^1.0.0", optional = true, python = ">=3.10"}
 
 
 [tool.poetry.extras]
 pyarrow = ["pyarrow"]
 # ``pip install databricks-sql-connector[kernel]`` adds the Rust kernel
-# backend so ``use_kernel=True`` works. No-op on Python < 3.10 (the
-# wheel's floor) — those users get a runtime ImportError if they pass
-# ``use_kernel=True``.
+# backend so ``use_kernel=True`` works.
 #
 # The kernel result path (``backend/kernel/result_set.py``) needs
 # pyarrow, but it is NOT listed in this extra on purpose: the published
@@ -75,10 +68,8 @@ pyarrow = ["pyarrow"]
 # dependency, so ``pip install ...[kernel]`` already pulls a compatible
 # pyarrow transitively. Listing bare ``pyarrow`` here additionally
 # forces poetry to co-resolve an unconstrained pyarrow against the
-# kernel's ``>=23.0.1,<24`` (which itself requires Python >=3.10) across
-# the connector's full 3.8–3.14 support matrix, which is unsatisfiable
-# on 3.8/3.9 and breaks ``poetry lock``. The kernel's own dependency
-# metadata is the single source of truth for the pyarrow floor.
+# kernel's ``>=23.0.1,<24``. The kernel's own dependency metadata is the
+# single source of truth for the pyarrow floor.
 kernel = ["databricks-sql-kernel"]
 
 [tool.poetry.group.dev.dependencies]

{databricks_sql_connector-4.4.0 → databricks_sql_connector-4.5.0}/src/databricks/sql/__init__.py

@@ -71,7 +71,7 @@ DATETIME = DBAPITypeObject("timestamp")
 DATE = DBAPITypeObject("date")
 ROWID = DBAPITypeObject()
 
-__version__ = "4.4.0"
+__version__ = "4.5.0"
 USER_AGENT_NAME = "PyDatabricksSqlConnector"
 
 # These two functions are pyhive legacy

{databricks_sql_connector-4.4.0 → databricks_sql_connector-4.5.0}/src/databricks/sql/backend/databricks_client.py

@@ -7,7 +7,13 @@ if TYPE_CHECKING:
     from databricks.sql.client import Cursor
     from databricks.sql.result_set import ResultSet
 
-from databricks.sql.thrift_api.TCLIService import ttypes
+    # Type-annotation-only import (deferred by ``from __future__ import
+    # annotations``). ``execute_command`` is typed with ``TSparkParameter`` for
+    # backwards compatibility, but this abstract base -- and the SEA/kernel
+    # implementations of it -- never import the Apache Thrift ``thrift`` package
+    # at load time. See ``test_lazy_thrift_import``.
+    from databricks.sql.thrift_api.TCLIService import ttypes
+
 from databricks.sql.backend.types import SessionId, CommandId, CommandState