Release Notes for Starburst ODBC Driver v3.0
============================================

V3.0 is the new Starburst ODBC Driver.

3.0 is presently available only for Windows (Intel 32-bit and 64-bit). Additional platforms will be announced in the future.

Please use the Starburst support portal to submit questions and comments including defects.

Alternately, you can also direct the same to odbc.notify@starburstdata.com. 

Changelog:
---------
3.0.13: 
* [O30-677] Corrects SQLPrepare to not execute a query until either SQLExecute/SQLExecDirect.
* [O30-744/789/793] Corrects handling of SQL_NUMERIC_STRUCT to use client-specified precision/scale when specified.
* [O30-774] Deprecates MaxDefaultVarcharLength in favor of DefaultVarcharLength.
* [O30-796] Keeps DSN restore tool after driver uninstallation.
* [O30-799] Changes CacheOAuthToken defaults to on.
* [O30-800] Deprecates CacheAccessToken in favor of CacheOAuthToken.
* [O30-811] Changes X-Trino-Source header default from "starburst-odbc" to Windows host process name.
* [O30-825] Deprecates UseProxy/ProxyHost/ProxyPort in favor of HttpProxy.
* [O30-830] Renames NoProxy to NonProxyHosts.
* [O30-836] Fixes bug CacheAccessToken does not work if cache file is larger than 4096 bytes.

3.0.12: 
* [O30-802] Hardens cache access token creation

3.0.11: 
* [O30-741] Adds support for SQL Server Linked Server.
            Known issue: binary, time/timestamp with time zone and other complex data type, e.g. JSON, Map are not supported.

3.0.10: 
* [O30-696] Adds support for 12-digit timestamps.
* [O30-697] Fixes timestamp precision bug.
* [O30-708] Improves queries for deriving table metadata.
* [O30-737] Adds CacheAccessToken attribute for seamless OAuth2 authentication.
* [O30-770] Declares driver's implementation as ODBC 3.80.

3.0.9: 
* [O30-723] Adds check for credentials during DSN test
* [O30-756] Corrects DSN test's use of stale credentials

3.0.8: 
* [O30-364] Adds support for SQLExtendedFetch
*           Adds support for row-wise binding
* [O30-712] Adds additional log entries for spooled segments
*           Adds driver details and host details to log
* [O30-725] Corrects crash when driver is installed to non-default location
* [O30-726] Adds decimal preprocessing during spooled segment retrieval
* [O30-740] Adds OAuth flow log entries

3.0.7: 
* [O30-691] Upgrades bshoshany-thread-pool to 5.0.
* [O30-705] Adds SQLRowCount() API.
* [O30-712] Revises log entries for compactness and clarity at the INFO, DEBUG and TRACE levels .
* [O30-717] Reports error when segment data transfer fails.

3.0.6: 
* [O30-603] Adds support for ignoreBrokenCatalog to handle misconfigured catalogs.

3.0.5: 
* [O30-678] Adds new NoProxy feature to selectively bypass proxy for specified domains/IPs.
* [O30-680] Removes spurious error entry from log file for X-Trino-Query-Data-Encoding.

3.0.4: 
* [O30-92]  Adds support for OIDC/OAuth2 authentication.
* [O30-624] Adds support for "Database" as an alias for the Catalog connection attribute.
* [O30-629] Adds support for Tableau's generic ODBC connector without requiring a DSN; please refer to the Known Issues for additional instruction.

3.0.3: 
* [O30-584] Adds support for Trino's new spooling extension for improved data transfer performance.
* [O30-594] Adds support for Tableau's generic ODBC connector.

Known Limitations:
-----------------
1. None