CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.12.0 - 2026-08-19

Upgrading from 0.11.x? See the migration guide.

Added

• Configurable retry/backoff via RetryPolicy (max_retries, min_delay, max_delay, jitter) and ClientBuilder::retry_policy. The default preserves the previous behaviour (3 retries, 1s→2s, no jitter). Retries are now idempotency-aware: idempotent page fetches (GET nextUri) retry on any transient failure (HTTP 502/503/504, connect/timeout), while query submission (POST /v1/statement) only retries when the request was definitely not processed (503, connection failures) so a non-idempotent statement (INSERT/DDL via execute) is never submitted twice. Query, decode, protocol and other errors fail fast
• Client::begin_transaction, Client::commit and Client::rollback for driving Trino transactions, plus Client::transaction_id / Client::set_transaction_id to inspect and set the session's transaction at runtime (previously only settable at build time via ClientBuilder::transaction_id). begin_transaction verifies that the coordinator actually returned a transaction id, so Ok(()) means a transaction is active — a START TRANSACTION that succeeds without a usable X-Trino-Started-Transaction-Id (a header-stripping proxy, or the NONE sentinel) is reported as Error::Transaction instead of silently leaving later statements outside any transaction
• Error::Transaction — returned when a transaction operation is attempted in a state that does not allow it (starting one while another is active, or committing/rolling back without one)
• TransactionId::is_active
• Interactive OAuth2 authentication (Auth::new_oauth2 / new_oauth2_with_handler). On a 401 Bearer challenge the client presents the login URL (browser + stderr by default, or a custom RedirectHandler), polls the Trino token endpoint, and retries with the bearer token. Token is cached in-memory for the process. Coordinators with several authentication types enabled (e.g. http-server.authentication.type=PASSWORD,OAUTH2) send one WWW-Authenticate header per type, so every challenge header is scanned for the Bearer one rather than only the first

Fixed

• Transactions were unusable. Trino returns a new transaction's identifier in X-Trino-Started-Transaction-Id, but the client parsed that header with a function that recognised only four fixed literals. A real identifier matched none of them and was silently discarded, so START TRANSACTION succeeded on the coordinator while every subsequent statement sent X-Trino-Transaction-Id: NONE and ran outside the transaction — and COMMIT/ROLLBACK could not address it. The identifier is now retained and sent on every subsequent request
• Unparseable X-Trino-Set-Role header values are now logged instead of being dropped silently

Changed

• Breaking: TransactionId now models what the X-Trino-Transaction-Id header actually carries: NoTransaction | Id(String). The StartTransaction, RollBack and Commit variants are removed — they are SQL statements, not header values, and sending them produced a header Trino does not accept. to_str is replaced by as_header_value(&self) -> &str and from_str by the infallible from_header_value(&str) -> Self. TransactionId is no longer Copy (it now owns a String); it is still Clone, and now also PartialEq and Eq. See the migration guide
• Breaking: Auth is now #[non_exhaustive] and has a new OAuth2 variant. Exhaustive match on Auth must add a wildcard arm
• Updated the base64 requirement from 0.22 to 0.23
• Raised the minimum supported Rust version (MSRV) from 1.86 to 1.88. The icu_* crates, pulled in transitively through url → idna, now require rustc 1.88; the CI job that enforces the MSRV was bumped to match

0.11.0 - 2026-07-19

Upgrading from 0.10.x? See the migration guide.

Added

• Client::get_all, Client::get and Client::execute now accept impl Into<String> for the SQL, so &str literals work without .to_string() (consistent with Client::stream). Existing String call sites are unaffected
• VarBinary type for Trino VARBINARY columns — decodes/encodes the base64 wire format into raw bytes (base64 is now a core dependency). Confirmed that Json (serde_json::Value) and TimestampWithTimeZone (chrono::DateTime<FixedOffset>) already decode, and added tests
• Crate-level documentation with a runnable quickstart, and doc comments on the core public API (Client, ClientBuilder, get_all/get/get_next/cancel, ExecuteResult). docs.rs now builds with all features
• QueryError::kind() returning a #[non_exhaustive] TrinoErrorKind enum, for ergonomic, discoverable matching on the common Trino error names (TableNotFound, SchemaNotFound, SyntaxError, …) without comparing raw strings; falls back to TrinoErrorKind::Other
• Client::stream — lazily stream query rows page by page without buffering the whole result set in memory (Direct and Spooled protocols). Returns a RowStream that resolves the result columns up front (RowStream::columns() -> &[Column]), implements futures::Stream, is Send/Unpin, and best-effort cancels the query on the coordinator if dropped before completion

Changed

• Declared a minimum supported Rust version (MSRV) of 1.86 and added a CI job that enforces it
• Unsupported Trino column types now fail with Error::UnsupportedType naming the type (e.g. unsupported Trino type: HyperLogLog) instead of a generic error
• Switched logging from the log crate to tracing: the same events are now emitted via tracing, and get_all / stream / execute are wrapped in a span carrying the query_id for per-query correlation. Install a tracing subscriber to see them
• The library now depends on tokio with only the rt and sync features instead of full, shrinking the dependency footprint and compile time for consumers (no longer pulls fs/process/signal/…). Tests and examples keep the fuller feature set via dev-dependencies
• Breaking: Restructured the Error enum for consistent, matchable errors. A Trino query failure is now a single Error::Query(Box<QueryError>) carrying the full structured error — match on error_code / error_name / error_type, or reach it via std::error::Error::source() (the top-level Display stays concise: query error [NAME]: message). Both the query and execute code paths now map failures identically (and error_code == 4 still maps to Error::Forbidden). Added typed Error::Decode, Error::Tls and Error::Protocol variants in place of many stringly InternalErrors. Error is now #[non_exhaustive] so future variants can be added without a breaking change
• Breaking: Unified the two Trino error representations — removed error::TrinoError/TrinoErrorLocation; TrinoRetryResult::error is now Option<models::QueryError>, and QueryError::failure_info is now Option<FailureInfo>

Removed

• Breaking: Removed the name-mapped Error variants (CatalogNotFound, SchemaNotFound, TableNotFound, TableAlreadyExists, InvalidCatalog, …) and the unused Error::EmptyData (no longer produced since zero-row queries return an empty result). Match on the structured Error::Query's error_name instead

0.10.0 - 2026-07-18

Security

• Updated dependencies to remediate 13 RustSec advisories in transitive crates, including aws-lc-sys (X.509/PKCS7 validation bypasses, timing side-channel), quinn-proto (DoS, memory exhaustion), rustls-webpki (CRL/name-constraint validation, parsing panic), bytes (integer overflow) and slab (out-of-bounds, yanked) #44

Changed

• Refreshed direct dependency versions (backon, chrono, futures, http, log, regex, reqwest, serde_json, tokio, tracing-subscriber, uuid) #44
• Replaced the unmaintained dotenv dev-dependency with the maintained dotenvy #44
• Bumped trino-rust-client-macros to 0.7.2 (adds #[trino(rename = "...")] support)

Removed

• Breaking: Removed the unused Trino feature #40
• Breaking: The optional spooling codec dependencies (base64, zstd, lz4, flate2) are no longer exposed as standalone public features; they are now declared via dep: and can only be enabled through the spooling feature #40

Added

• Support configuring the name of the result field when using the Trino derive macro #43
• Derive Serialize on the result, error, stat, warning and segment model types to allow serializing query results (credit to @sbernauer, originally #42)

0.9.3 - 2026-02-19

Added

• auth_http_insecure option to allow authentication over HTTP #34

Changed

• Boxed reqwest::Error and QueryError in error enum to reduce Result size #32
• Removed unnecessary clippy::result_large_err suppressions #32
• Masked JWT token in Auth::Jwt debug output #34
• Refreshed dependency versions #35

0.9.2 - 2025-11-20

Changed

• Bumped trino-rust-client-macros to 0.7.1
• Integration tests are no longer published to crates.io

0.9.1 - 2025-11-20

Added

• Spooling protocol support for efficient large result set handling #26
• New spooling_encoding configuration option (supports json+zstd, json+lz4, json+gzip)
• New max_concurrent_segments configuration for controlling concurrent downloads
• Spooling feature flag with compression support (zstd, lz4, gzip)

Changed

• Bumped trino-rust-client-macros to 0.7.0

0.8.0 - 2025-01-XX

Added

• Return execute result with operation type and counts #24

Fixed

• Fixed prepared statement header decoding #23
• Ensure finished prepared statement's results are parsed accordingly #22

0.5.1 - 2023-10-19

• Make Client::get and some functions public #29

0.5.0 - 2023-02-27

• v0.5.0 can be used with stable rust.
• Add SSL root certificate support #22
• Provide a feature flag for running as presto client #19

0.4.0 - 2022-02-07

• Use Rust 2021

0.3.0 - 2021-05-26

• Use Trino protocol
• Add execute to Client
• Add more session properties
• Fix deserialization of ClientTypeSignatureParameter

0.2.0 - 2021-01-06

• Add len, as_slice methods to DataSet<T>
• Update tokio stack to 1.0
• Use rustls instead of native-tls

0.1.2 - 2020-10-30

• Make QueryError::error_location optional

0.1.1 - 2020-10-09

• Add 'static bound to key and value types of map like types

0.1.0 - 2020-10-01

• Initial release