NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #3322 most downloaded on crates.io
Async CQL driver for Rust, optimized for ScyllaDB, fully compatible with Apache Cassandra™
Latest stable
1.10.0
Last release 16 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 43 of 45 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
46 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Deprecations and necessary code adjustments
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.10.0,
an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible with Apache Cassandra!
Some interesting statistics:
ClusterState::get_token_endpointsClusterState::get_token_endpoints was deprecated in favour of the new ClusterState::try_get_token_endpoints. If you don't call get_token_endpoints, you are not affected.
For a keyspace missing from the driver's metadata, get_token_endpoints used to guess LocalStrategy, and returned replicas unrelated to the real ones. It now returns an empty list, which can't be told apart from an empty replica set. try_get_token_endpoints returns ClusterStateTokenError::UnknownTable in this case. Replace your calls with try_get_token_endpoints and handle the error.
As in 1.9.0, this release bumps the major version of scylla-cql, our internal protocol implementation crate, without breaking the API of scylla. We used the opportunity to remove legacy items: for example, the V2 types replace the types they were added next to, and lose the suffix (Execute, Request, Event...) (#2026, #2028).
If you only have the scylla crate in your Cargo.toml (as you typically should), you do not need to do anything.
If you have scylla-cql in your Cargo.toml, your code will keep compiling and working, with a different version of scylla-cql than the one the driver uses. In general you should have no need to depend on scylla-cql directly, so try to remove this dependency. If you can't, update to 3.0 to keep in sync with the driver and avoid code bloat.
serde feature, which derives serde's Serialize and Deserialize for the driver's CQL value types (CqlDate, CqlTimestamp, CqlVarint...), so you can use them in your serde-serialized structures. Their serde representations are not covered by semver guarantees, but any change will be announced in the release notes (#1912).Session or on DefaultPolicy, is not present in the cluster, or all of its nodes are disabled by the HostFilter. Previously such a misconfiguration led to confusing behaviour, like empty query plans. Warnings that load balancing policies may emit on every request are now rate limited (#2008).TABLETS_ROUTING_V2_EXPERIMENTAL_V2, so it no longer uses TABLETS_ROUTING_V2 with ScyllaDB versions that only support the old one (#1999, #2032).Node::is_scylladb, which tells whether a node is ScyllaDB, even when it runs with shard awareness disabled (#1971).ColumnType, NativeType and CollectionType now implement Display, printing the type in CQL syntax, e.g. map<text, frozen<map<text, text>>> (#1960).SessionConfig::client_routes_config public (behind unstable-client-routes) (#1990).INSERT now makes 2 allocations instead of 8, an unpaged SELECT 3 instead of 8, and the futures returned by Session methods are up to 70% smaller. In our benchmark of prepared INSERTs, the driver uses about 35% less CPU per request (#1978, #1979, #1980, #1981, #1982, #1983, #1984, #1985).connect_timeout) before handling more feedback. Now it waits only in the very rare edge cases (#1925).vector<float, 1536> into a Vec<f32> is about 9 times faster (#1924).CqlDuration no longer allocate, and a CqlValue UDT with fields in schema order no longer builds a HashMap (#2006).Session::use_keyspace returns, all existing and new connections now use the new keyspace. Previously concurrent calls, or a failed or timed out keyspace switch, could leave the session permanently with connections to different keyspaces. Setting the keyspace on a new connection now also has a timeout (#1909).STARTUP message, visible in system.clients. Driver 1.9.0 reported 2.0.0, the version of scylla-cql (#2026).RoutingInfo::is_confirmed_lwt is set), like the statement itself would be. Previously batches were never routed as LWTs (#1944).varint now fails, as it already did for decimal; use MaybeEmpty<T> to accept empty values. Previously CqlVarint accepted it, and num-bigint's BigInt turned it into 0. Decimals with an empty unscaled value are now rejected, an empty CqlVarint no longer equals 0, and a CqlVarint with redundant leading 0xff bytes now equals its normalized form (#2004).ClusterState::get_token_endpoints no longer guesses LocalStrategy for keyspaces missing from metadata. It is deprecated in favour of the new ClusterState::try_get_token_endpoints (see above) (#1913, #2027).org.apache.cassandra.db.marshal.Int32Type) now rejects trailing characters instead of ignoring them (#1911).Session::use_keyspace, and added a warning about using prepared statements together with USE KEYSPACE (#1909).Node::sharder, which said that a node without a sharder is not ScyllaDB. ScyllaDB with shard awareness disabled has no sharder either (#1970).CachingSession (#1897, #1898, #1900, #1901).scylla-proxy instead of a real cluster, and other tests now wait for the state they need (#1915, #1919, #1938, #1943, #1955, #1966, #2001).scylla-proxy in dry mode, or moved to integration tests. make unit-test runs them without starting the cluster (#1967).scylla-proxy no longer slows down connections, because it now disables Nagle's algorithm. This cut the test suite time by about 19%. Also fixed several proxy bugs (#1949).CONTRIBUTING.md, and N/A boxes and ownership points to the PR checklist (#1945, #1972).Congrats to all contributors and thanks to everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 283 | Karol Baryła |
| 24 | renovate[bot] |
| 18 | Wojciech Przytuła |
| 9 | Dawid Mędrek |
| 6 | sylwiaszunejko |
| 4 | Dawid Pawlik |
| 2 | Alexey Kartashov |
| 1 | Claude |
| 1 | Dmitriy Kruglov |
| 1 | Dmitry Kropachev |
| 1 | Photon101 |
| 1 | Wojciech Bączkowski |
| 1 | boulea7 |
| 1 | dependabot[bot] |
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This is what we do in this release, because of a breaking change we had to make in scylla-cql .
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.9.0,
an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible with Apache Cassandra!
Some interesting statistics:
TlsContext::OpenSsl010TlsContext::OpenSsl010 was deprecated, and replaced with TlsContext::OpenSsl010Config. The new variant allows the driver to use TLS tickets in order to lessen the server load when establishing new connections.
TlsContext::OpenSsl010 stored a bare openssl::ssl::SslContext. This is not enough for the driver to support tickets, so the new variant can only be constructed from a builder, not a ready context. Two ways to do that:
SslConnectorBuilder. You can just pass Option<SslConnectorBuilder> to SessionBuilder::tls_context, because there is impl From<SslConnectorBuilder> for TlsContext. If you wish to disable TLS tickets (or do other configuration that might get introduced in the future), then first convert your SslConnectorBuilder to our OpenSsl010Config, either with OpenSsl010Config::new or impl From<SslConnectorBuilder> for OpenSsl010Config.SslContextBuilder. This is easier to migrate to, but not recommended: SslContextBuilder defaults are less safe than SslConnectorBuilder. Use OpenSsl010Config::from_dangerous_builder to do that.The driver consists of 4 main crates, which until now were always released in sync with the same version number: scylla (main crate), scylla-cql (protocol implementation), scylla-cql-core (recently extracted from scylla-cql, consisting of the parts of the protocol implementation that are public in scylla), scylla-macros (derive macros for our ser / deser traits).
The scylla-cql-core extraction made scylla-cql a fully internal crate: we can bump its major version number without having to do the same for scylla. This is what we do in this release, because of a breaking change we had to make in scylla-cql.
If you only have the scylla crate in your Cargo.toml (as you typically should), you do not need to do anything.
If for some reason you have scylla-cql in your Cargo.toml, your code will keep compiling and working. You will be using a different version (1.x) of scylla-cql than the driver uses (2.x). Everything works, because all the common parts are extracted to scylla-cql-core.
In general you should have no need to depend on scylla-cql directly, so try to remove this dependency. If you can't, update to 2.0 to keep in sync with the driver and avoid code bloat.
BoundStatement. It allows you to pre-serialize request parameters, move them around together with the statement in its owned form, and calculate a token based on that (#1862, #1866, #1883).STARTUP message of a control connection. This data can be seen in the system.clients table and is intended for debugging / diagnostic purposes. You can disable it with SessionBuilder::driver_config_reporting(false) (#1905).SESSION_ID in the STARTUP frame. This is visible in the system.clients table and can be used to associate different connections of a single driver session (#1882).error! will now be logged (on recent Scylla versions only) (#1872).ClusterState for the whole request (previously some tracing logs could use a different one) (#1885).Pager now only computes replicas for tracing purposes when the trace they are used in is actually enabled (#1904).scylla-proxy used in tests now selects its address from the address family of the real node address (#1902).VectorSerializationErrorKind is now re-exported in the scylla crate (#1899).cargo-deny to our CI (#1848).SELECT without FROM (new Scylla feature) (#1879).Congrats to all contributors and thanks to everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 66 | Karol Baryła |
| 29 | Wojciech Przytuła |
| 17 | Dawid Mędrek |
| 15 | renovate[bot] |
| 5 | Piotr Dulikowski |
| 4 | Guflly |
| 3 | w3lld1 |
| 1 | ColumbusLabs |
| 1 | Israel Fruchter |
| 1 | Roy Dahan |
| 1 | 송은우 |
Connection: changed #[expect(deprecated)] to #[allow(deprecated)] on set_linger because older Tokio verions don't mark is as deprecated ( #1787 ).
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.8.0,
an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
QueryPager (used by Session::execute_iter and Session::query_iter) was optimized for single-page queries. Now it only starts a tokio::task if there is more than one page (#1739).QueryPager now treats each page as a fully separate request: new execution plan is produced for each page, downgraded consistency is reset. Driver still tries to stick to the same coordinator for subsequent pages: the first element of the plan for the next page will be the coordinator of the previous page (#1739).QueryPager (used by Session::execute_iter and Session::query_iter) now supports Speculative Execution (#1783).Client Routes feature now choose an IP randomly for each connection if DNS resolves to multiple IPs (#1805).CqlTimestamp with more functionalities: trait derives, useful constants and operations against std::time::Duration (#1776, #1834).scylla-ccm-bridge is extracted for reuse in different projects (#1810).Keyspace struct now has a new tablets field, indicating if the keyspace is vnode- or tablet-based. This info fetched from system tables and used by the driver for more precise routing (#1720).RetrySession is now created lazily when needed, to save an allocation on the hot path (#1833).Bug fixes:
Metrics::get_latency_percentile_ms that caused it to return completely wrong value (#1749).enable_shard_aware_drivers: false is now recognized as Scylla, not Cassandra (#1719).Client Routes: non-sticky routes are now correctly overwritten on updates (#1822).RequestInfo passed to RetrySession now gets current (so potentially downgraded) consistency, instead of the original consistency (#1758, #1770).IgnoreWriteError decision (#1761).Internal refactors:
cfg sprawl from metrics feature across the codebase (#1750).scylla-proxy (#1744).CqlTimeuuid::lsb_signed is now properly documented. Timeuuid ordering test is hardened (#1766).Documentation:
CI / tests / developer tool improvements:
Client Routes test utils (#1795).#[expect(deprecated)] to #[allow(deprecated)] on set_linger because older Tokio verions don't mark is as deprecated (#1787).Dependencies:
Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 116 | Karol Baryła |
| 112 | Wojciech Przytuła |
| 25 | renovate[bot] |
| 19 | Patrycja Ziemkiewicz |
| 2 | Dawid Pawlik |
| 2 | Floze |
| 2 | phalat |
| 2 | Paulina Czajkowska |
| 1 | Anna Stuchlik |
| 1 | Photon101 |
| 1 | Vismay |
| 1 | dependabot[bot] |
…of scylla-cql . This allows us to make breaking changes in scylla-cql from now on, without affecting the scylla crate's public API. ( #1604 , #1609 ,…
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.7.0,
an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
Session directly (#1658).ClusterState to get node by host id (#1646).ClusterState (#1666).scylla crate VectorIterator and other Vector-related types (#1650).get_tracing_info now waits for the request duration to be available (#1652).size_hint) and traits (ExactSizeIterator) for our iterators (#1664).CqlValue::Vector (#1705).Bug fixes:
SERIAL/LOCAL_SERIAL consistency are now treated as LWT for routing, reducing Paxos contention (#1647).metadata/reader occurring on runtime shutdown (#1644).HostFilter (#1654).REUSEADDR is used (#1622).read_inet port conversion (#1649).first_tablet < last_tablet when parsing tablet hint from the server (#1660).system_traces.sessions (#1698).RequiredHostAbsent error, which always displayed host id 0 (#1700).Internal refactors:
scylla-cql crate that is exposed in scylla crate's public API into a new scylla-cql-core crate, which is now a dependency of scylla-cql. This allows us to make breaking changes in scylla-cql from now on, without affecting the scylla crate's public API. (#1604, #1609, #1593).scylla crate's dependencies (scylla-cql-core, scylla-cql) to specific versions, to prevent resolving incompatible dependencies. Now users will no longer suffer from incompability of scylla with scylla-cql[-core] (#1715).Documentation:
DefaultRetryPolicy decision matrix (#1633).connection_address semantics in Coordinator (#1651).CI / developer tool improvements:
many_connections test to prevent file descriptor exhaustion (#1621).test_schema_await_required_host_absent (#1709).Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 155 | Karol Baryła |
| 26 | Wojciech Przytuła |
| 5 | Copilot |
| 4 | Stanisław Czech |
| 2 | copilot-swe-agent[bot] |
| 1 | David Garcia |
| 1 | Lukasz Sojka |
| 1 | Matt Van Horn |
| 1 | Photon101 |
| 1 | Sai Asish Y |
| 1 | conorbros |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.6.0, an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.6.0,
an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
durable_writes field was added to Keyspace struct (#1578).Warning: Removal of the above workaround may break some misconfigured setups.
Driver uses rpc_address column from system.peers / system.local tables to get addresses it uses to connect to nodes. This column is populated using broadcast-rpc-address configuration (or rpc-address if the former is not present).
If addresses retrieved from those tables are not reachable by the driver, it won't be able to establish a session.
The workaround that was removed made driver ignore the address from system.local, and instead use the address that we used to open the control connection (which initially happens to be one of the provided contact points). In the misconfigured setup it would allow the driver to connect to only a single node, resulting is severely deficient session. Such setup won't work at all now.
Bug fixes:
Session::query_iter / Session::execute_iter now correctly refresh driver metadata (if enabled in session config) after a DDL statement is executed using those APIs (#1579).LIST ROLES of) if they were executed as prepared statements (#1581).Documentation:
total_connections metric docstring (#1586).CI / developer tool improvements:
mdbook test (#1591).examples/ folder (#1594).cassandra:cassandra, which broke our tests. Fixed that by using flags to explicitly create the superuser (#1601).wait_for_connection and inject_event_to_cc methods to our testing proxy (#1610).Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 61 | Wojciech Przytuła |
| 13 | Karol Baryła |
| 4 | Hanna Marszałek |
| 3 | Dmitry Kropachev |
| 3 | Jakub Janowski |
| 2 | copilot-swe-agent[bot] |
| 2 | dependabot[bot] |
| 1 | Dani Tweig |
| 1 | David Garcia |
| 1 | Dawid Pawlik |
| 1 | Copilot |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.5.0, an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.5.0,
an asynchronous CQL driver for Rust, optimized for ScyllaDB, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
⚠️ Enabled hostname verification for OpenSSL. This is an important security improvement, and brings our OpenSSL usage to parity with Rustls (which doesn't even allow disabling verification in any easy way). Warning: it may cause the driver to be unable to connect to your cluster if you use OpenSSL and your node certs don't have node IP in SAN (#1491).
Introduced configurable DNS resolution timeout. Check out hostname_resolution_timeout method on SessionBuilder (#1113).
Internal requests performed by the driver that fetch schema and topology are now prepared. It may slightly lower the load on cluster in some scenarios, especially when there is a great amount of driver sessions existing at the same time. (#1530).
Schema agreement wait (performed by Session::await_schema_agreement and automatically after DDL requests unless disabled) no longer fails immediately after any error. Instead, it retries when the error is classified as non-permanent (#1473, #1479).
Implemented Debug for ColumnSpecsGuard (#1522).
Added support for secrecy 0.10, including SecretString and SecretSlice (#1523).
Implemented SerializeValue for MaybeEmpty (#1525).
Allowed (de)serialization of Cow<'_, T> values (#1545).
Introduced scylla_unstable cfg flag to gate all unstable features (#1505).
Implemented unstable HostListener mechanism for CPP-RS Driver (#1496).
⚠️ Removed "unstable cloud" feature, as it was abandoned long time ago. The removed feature was marked as unstable, so this is not a semver-major change, but it may cause compilation error if your code used this feature (#1487).
Bug fixes:
Session::execute_iter and Session::query_iter now correctly handle USE keyspace requests (by switching keyspace on all connections) and DDL requests (by awaiting schema agreement unless disabled). (#1548).frozen flag is no longer considered when type checking upon (de)serialization (#1500).MetadataError::FetchError now has correct message when printed. Before this fix, it was accidentally hardcoded to "transparent" (#1539).vector of collections - extremely niche use case (#1567).Internal cleanups/refactors:
collect_array in custom_type_parser (#1494).value_tests.rs (#1511).&String with &str where possible (#1529).Documentation:
data-types.md (#1474).permit_dc_failover (#1489).duration.md (#1516).CI / developer tool improvements:
cargo test is now discouraged in favor of using nextest. Behaviors of the two may diverge, and cargo test could possibly even break in the future (#1568).test_schema_await_with_unreachable_node (#1471).RequiredHostAbsent error (#1475).test_pager_timeouts timeouts to prevent flakiness (#1484).Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 122 | Karol Baryła |
| 48 | Wojciech Przytuła |
| 5 | Stanisław Czech |
| 4 | dependabot[bot] |
| 3 | Mikołaj Uzarski |
| 3 | Yaniv Kaul |
| 2 | Piotr Dulikowski |
| 2 | copilot-swe-agent[bot] |
| 1 | Andres Medina |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.4.1, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible wi
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.4.1,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
1.4.0 failed to build on https://docs.rs/ . We fixed the bug and introduced a CI pipeline to prevent such issues in the future (#1468).
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
It was accessible to users with PreparedStatement::get_result_set_col_specs , which is now deprecated and will return initial result metadata. Use get…
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.4.0,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
SELECT * queries), and in many cases performance (because driver won't have to request result metadata for each request). (#1463).PreparedStatement is now mutable in order to support the above extension. It was accessible to users with PreparedStatement::get_result_set_col_specs, which is now deprecated and will return initial result metadata. Use get_current_result_set_col_specs instead (#1445).execute_iter, query_iter) now respect client-side timeout settings, treating is as timeout for fetching a single page (#1458).DeserializeRow derive macro now supports default_when_null field attribute (#1403).'static bounds from QueryPager::rows_stream method (#1427).Bug fixes:
execute_iter, query_iter) is now performed for each page, not only the first one (#1449).Internal cleanups/refactors:
id and lwt fields were moved to shared data of PreparedStatement (#1442).PreparedStatement variants have been centralized to make reasoning about it easier (#1446).QueryResult::into_rows_result (#1461).Documentation:
Cargo.toml (#1459).CI / developer tool improvements:
test_default_policy_is_tablet_aware that started to fail because of Scylla changes (#1412).#[deprecated] attribute is added (#1450, #1464).Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 127 | Karol Baryła |
| 24 | Wojciech Przytuła |
| 3 | Mikołaj Uzarski |
| 2 | Stanisław Czech |
| 1 | Collin Styles |
| 1 | spoorn |
| 1 | dependabot[bot] |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.3.1, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible wi
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.3.1,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
Bytes as CQL blob. This works in tandem with the already present blob -> Bytes deserialization capability (#1397).Bug fixes:
scylla_cql::deserialize module appear in mirror module in scylla crate (#1406).Documentation:
Scylla with ScyllaDB, following the official naming (#1393).Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 49 | Wojciech Przytuła |
| 8 | Karol Baryła |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.3.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible wi
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.3.0,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
DefaultPolicy now filters out disconnected nodes, which is a useful optimisation (#1364).ExecutionError::EmptyPlan error message (#1371).Box<str> and Arc<str> (#1382).Bug fixes:
Internal API cleanups/refactors:
run_request and unified autohandling of specific responses. This simplifies the code and makes it more bug-resitant (#1375).Documentation:
enforce_coordinator example is extended to show how to inspect the coordinator of a request (#1346).Others:
sphinx-scylladb-theme from 1.8.6 to 1.8.7 (#1388).clippy::uninlined_format_args lint) (#1389).Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 44 | Karol Baryła |
| 23 | Wojciech Przytuła |
| 1 | Mikołaj Uzarski |
| 1 | dependabot[bot] |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.2.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible wi
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.2.0,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
flatten attribute to SerializeRow derive macro. The attribute is inspired and analogous to the one found in serde #1144nil() method for CqlTimeuuid #1314.MaybeUnset::from_option() convenience constructor to reduce boilerplate #1317.Debug for timestamp generator types #1341.CachingSessionBuilder #1345.PreparedStatement is materialized only where needed, avoiding unnecessary allocations #1329.CachingSession #1340.Bug fixes:
LoadBalancingPolicy was out of range for the chosen node #1325.Metrics::percentiles() would return the number of observations in the corresponding bucket instead of the mean value of the bucket #1327.Internal API cleanups/refactors:
LatencyAwareness uses existing Iterator's methods instead of hand-crafted logic #1330.PreparedIteratorConfig to PreparedPagerConfig, because it was a remnant of the legacy naming #1335Node::is_down() and related code, as the event-based node status mechanism is error prone and was not used anyway #1358.Documentation:
scylla-cql API's considerations - versioning requirements, guarantees, etc. #1322.flatten attribute docs to SerializeRow, as it had been put in a wrong place #1144.CI / developer tool improvements:
allow() to expect(), removed unnecessary lints and enabled of checking public API with Clippy #1359.Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 108 | Wojciech Przytuła |
| 20 | Mikołaj Uzarski |
| 19 | Karol Baryła |
| 8 | Andres Medina |
| 8 | smoczy123 |
| 4 | Andrés Medina |
| 2 | David Garcia |
| 2 | Vartan Babayan |
| 1 | Dmitry Kropachev |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.1.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible wi
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.1.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
CloudConfig from any Reader. #1183Sized requirement in SerializeRow implementation for Box. The constraint was implicit and unnecessary. #1277Bug fixes:
Session's Debug implementation. #1301ClusterState::get_nodes_info()). #1308API cleanups / better types:
Partitioner pub again, as they showed to be required by, among others, cql-stress. The traits were sealed to prevent adding implementations by downstream crates. #1298Internal API cleanups/refactors:
Session creation. #1306Documentation:
Query to Statement (those that were accidentally omitted before 1.0.0). #1278Session::await_schema_agreement (we had forgot to update docs when the change was done). #1283--no-merges option to git shortlog used for count commits per author for each release. We decided that merge commits should not count as meaningful impact on the driver. #1311CI / developer tool improvements:
cargo check, etc.). #1274session_test.rs, which require running ScyllaDB cluster, from library (unit) tests to integration tests. This is another step on the path to make unit tests runnable without a set up cluster. (#1291)Others:
scylla-2025.1.0) does not support tablets + materialized views combination. #1304Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 22 | Karol Baryła |
| 18 | Mikołaj Uzarski |
| 18 | Wojciech Przytuła |
| 4 | Roman Hargrave |
| 1 | Collin Styles |
| 1 | Vartan Babayan |
| 1 | dependabot[bot] |
So what does it mean to us, and why did we release this version? Up until now, we introduced breaking changes whenever we felt we could improve the AP…
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 1.0.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
1.0 has a special meaning for Rust crates - it means that the crate is considered "API-stable" - however there is no specific definition of what it means to be "API-stable". So what does it mean to us, and why did we release this version? Up until now, we introduced breaking changes whenever we felt we could improve the API this way (sometimes we kept the old API for a bit, and provided a migration guide). This caused the vast majority of our releases to have to bump the major version number - we didn't reach minor version greater than "2" for a few years now. This is not a great situation for our users, because it means it is basically never possible to update the driver without adjusting their codebases. At the same time we know that we can't (and don't want to) freeze the API forever - there are still many improvements we can make, and the databases (Scylla / Cassandra) are always changing, which sometimes requires breaking changes on our part (an example of this is Tablets feature in Scylla, which required us to change our load balancing APIs). This means we won't stay on 1.x forever. We decided to stabilize the API by providing a guarantee regarding how long a breaking change won't occur, which will allows users to better allocate time for dealing with breakage. For the 1.0, we won't release 2.0 earlier than 9 months after 1.0 (but we may release it later). Until then we will release minor (1.x) versions. In 1.x versions we may of course introduce new APIs, and deprecate old ones, but there will be no breaking changes. Two exceptions that may force us to release major versions quicker are:
After releasing new major version (e.g. 2.0) we will continue to provide bugfixes (but no new features) for the previous major version (e.g. 1.0). The exact duration of such bugfix support will be provided after the new major version is released.
Additionally, 1.0 release signifies that we view the driver as production ready. It has been for a long time now, but the 0.x version number may have been suggesting otherwise to some people, and we don't want to send mixed signals.
New features / enhancements:
Mutex internally, causing performance problems because of contention. Now AtomicHistogram is used to avoid this problem. Additionally, metrics are now guarded by metrics feature, so that the users who don't need them don't have to pay the performance cost and introduce additional dependency. (#1263)CqlType::UserDefinedType. Now, in case of this (and some other errors) the metadata fetch for given keyspace will be aborted (and warning printed), returning previous version of this keyspace if possible. (#1162)Table::partition_key and Table::clustering_key are present in Table::columns. If this is not the case, fetch is failed only for this keyspace, as above. (#1252)Node::is_down was made private, instead new method Node::is_connected was introduced. The old method has very misleading semantics. The new one tells if there are currently any driver connections opened to given node. (#1196)Vector support. Driver can now correctly fetch metadata of tables with vector columns. Serializing / deserializing vector values will be added after 1.0. (#1020)Display was implemented for CqlValue. (#1257)rand dependency was updated to 0.9.0. This is a breaking change, because a trait from rand appears in ReplicaSet::choose_filtered method. (#1255)system.local table use WHERE key='local' which should be a minor performance improvement. (#1245)Debug for MaybeUnset. (#1199)Bug fixes:
Debug implementation on CachingSession was not usable due to unsatisfiable bounds. (#1161)scylla-cql, so the change is breaking - but it should not affect users. (#1176)API cleanups / better types:
authentication, client, cluster, network, observability, policies, response, routing, statement, utils. Some structs and method were also renamed as part of this effort. Unfortunately, this is a big change that will require users of our driver to update most of their use statements. (#1163, #1187)CqlType was removed, and ColumnType is used in its place. To make this possible, ColumnType was heavily modified. (#1166)scylla-cql has a lot of problems. Many of them were addressed, which of course is a very breaking change. (#1198)Query was renamed to Statement. (#1250)SerializedValues from public API of scylla crate. Functions using it were either changed to using &dyn SerializeRow or deemed unnecessary and removed from the public API. Error types of ClusterState token calculation APIs were changed as part of this. (#1252)ColumnSpecView and TableSpecView were removed. ColumnSpecs received a second lifetime. PreparedStatement::get_variable_col_specs and PreparedStatement::get_result_set_col_specs now return ColumnSpecs to make it consistent with QueryRowsResult and QueryPager. (#1249)PreparedStatement::get_partitioner_name() was made pub. (#1222)#[non_exhaustive] because we may want to add new variants to them in the future. (#1261, #1262, #1257, #1205, #1269)RetryPolicy-related APIs were adjusted to past naming changes in load balancing. (#1202)ClusterState now has getter and iterator for keyspaces, instead of exposing HashMap<String, Keyspace>. (#1266)
The two changes below are formally API-breaking, but are extremely unlikely to cause any breakage, so we don't mark them as such.PeerEndpoint, because it was not used in any public API. (#1261)RowSerializationContext::column_by_name because there is no probable use case that needs it. (#1252)Internal API cleanups/refactors:
Documentation:
query vs statement vs request. (#1250)scylla-macros crate. (#1260)CI / developer tool improvements:
Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 194 | Karol Baryła |
| 149 | Wojciech Przytuła |
| 133 | Mikołaj Uzarski |
| 9 | Andrés Medina |
| 8 | Dmitry Kropachev |
| 6 | smoczy123 |
| 6 | Dawid Pawlik |
| 3 | Henrik Gustafsson |
| 2 | Joel Höner |
| 2 | Lucas Kent |
| 2 | William Shiao |
| 2 | dependabot[bot] |
| 1 | Nikodem Gapski |
| 1 | Stanislav Tkach |
Deprecated remnants of the legacy framework and items belonging to the legacy serialization framework (#1141).
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.15.1, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
automatically_derived attribute to impls auto-generated by derive macros (#1145).ConnectionSetupRequestError public (#1131).Bug fixes:
session.batch() would silently drop extra values (#1142).API cleanups / better types:
SerializedValuesError (#1149).Documentation:
chrono -> chrono-04) (#1123, #1110).CI / developer tool improvements:
Others:
QueryRowsResult::into_inner behind cpp_rust_unstable cfg for use in cpp-rust-driver (#1133).PoolRefiller::use_keyspace (#1143).Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Beginning with this release, instead of putting all API-breaking changes into one group, now they are in the proper categories, but labeled as ⚠️ [API…
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.15.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
Beginning with this release, instead of putting all API-breaking changes into one group, now they are in the proper categories, but labeled as ⚠️ [API-breaking].
The main change in this release is the deserialization API refactor. Its primary goal was to reduce overhead caused by all rows being eagerly deserialized to type-erased CqlValue type, only then being converted to end user types.
Old traits and structs (FromCqlVal, FromRow, QueryResult - renamed to LegacyQueryResult, RowIterator - renamed to LegacyRowIterator, TypedRowIterator - renamed to LegacyTypedRowIterator) are replaced by new ones (DeserializeValue, DeserializeRow, new QueryResult, QueryPager, TypedRowStream). There are wrappers and helper implementations provided, designed to aid in gradually migrating to new API - see the migration guide in the book for more information. Old traits and structs will be removed in one of future versions.
New serialization API has a benefit of increased efficiency - now, rows are deserialized straight to the end user type, without any copying and allocations on the way.
Another feature is the ability to deserialize rows to borrowed types (e.g. &str or &[u8]).
And the result metadata is now deserialized in the borrowed form, saving even more allocations.
The refactor included:
Deserialize{Value,Row} with two lifetimes: 'frame and 'metadata separately (#1101).New features / enhancements:
ResultMetadata lifetime-generic, which paved a path to deserializing metadata in a borrowed way as an optimisation to save allocations (#1082).SerializeRow impl for Box<T: SerializeRow> (#1105).Bug fixes:
i64 for type safety (#1106).API cleanups / better types:
RetryPolicy stored behind Arc instead of Box (#1103).Internal API cleanups/refactors:
Connection's API (#1084).unnameable_types clippy lint to prevent having such situation in the future (#1094).Documentation:
CI / developer tool improvements:
book.yml CI workflow (#1096).Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 154 | Mikołaj Uzarski |
| 89 | Wojciech Przytuła |
| 45 | Karol Baryła |
| 26 | Piotr Dulikowski |
| 3 | David Garcia |
| 1 | Daniel Boll |
| 1 | Alex Pozhylenkov |
API cleanups / breaking changes:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.14.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
API cleanups / breaking changes:
execute_unpaged / execute_single_page / execute_iter) rather than the page size associated with the statement object. Other changes include (#1061):
Bytes.execute_single_page instead of being a field in QueryResult.page_size on the statements mandatory and providing the default value.SerializeCql was renamed to SerializeValue because old name turned out to be confusing for users. (#1000)chrono, time and secret were renamed to chrono-04, time-03 and secrecy-08 to allow us to support new major versions of those libraries in the future. (#939)QueryResult.col_specs was changed from being a field to a method in order to allow sharing it with PreparedStatement. (#1065)ResultMetadata.paging_state field to Rows.paging_state_response. This is because paging state is something that changes on each paged request and should not be cached by PreparedStatement. (#1065)New features / enhancements:
STARTUP message (DRIVER_NAME, DRIVER_VERSION) can now be configured using new SelfIdentity API in SessionBuilder. (#1039).unwrap()s with .expect()s in the code generated by our derive macros. This is done to avoid angering unwrap_used clippy lint and to provide better error messages if those panics are ever triggered. (#1055)
https://github.com/scylladb/scylla-rust-driver/pull/1019Documentation:
PreparedStatement. (#986)CI / developer tool improvements:
[tokio::test] is used with [ntest::timeout]Others:
CONTRIBUTING.md. (#997)Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 163 | Wojciech Przytuła |
| 55 | Mikołaj Uzarski |
| 17 | Karol Baryła |
| 3 | David Garcia |
| 2 | Lucas Kent |
| 2 | Piotr Dulikowski |
| 1 | Daniel Reis |
| 1 | Dmitry Kropachev |
| 1 | Kailokk |
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.13.2, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible w
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.13.2, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
Bug fixes:
use_cached_metadata flag was set on a PreparedStatement(#1063)Documentation:
DefaultPolicy (Load Balancing) with a lot of comments intended for developers to understand its logic easier (#1062)CI / developer tool improvements:
cfg allowlist (after such allowlist was made mandatory) (#1049)Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.13.1, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible w
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.13.1, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
Bug fixes:
log logger work with the driver again (#992)Query) (#1038)Documentation:
tracing and log libraries and provided an example (#992)CI / developer tool improvements:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
API cleanups / breaking changes:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.13.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
API cleanups / breaking changes:
LoadBalancingPolicy would return a Plan consisting of Nodes;
now, together with a Node it can optionally specify the Shard to contact as well. This is crucial for proper Tablets support (see above). Main PR #944, with follow up #969Token: added constructor and normalization to increase type-safety (#948)histogram::Histogram, from public API (#935)num_enum dependency. It was unstable, and we managed to do without it, so it no longer appears in the public API. (#931)scylla-cql definitions which weren't intended for access from outside the driver. (#933)New features / enhancements:
FromRow derive macro to suppport structs with unnamed fields. Before, only structs with named fields were supported. (#985)strum and strum_macros dependencies. They were unstable, and we managed to do without it. (#934)Documentation:
QueryResult::rows. The preferred method is the more type safe QueryResult::rows_typed. Moreover, QueryResult::rows is going to be deprecated in the next release, once the new lazy deserialization framework is introduced. We thus recommend switching to rows_typed wherever possible. (#955)CI / developer tool improvements:
pubs (#958)chrono deprecations (#951)cargo clean before tests (#929)uninlined_format_args clippy lint", as rust-analyzer now properly supports semantic analysis of such format args. (#945)Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 40 | Karol Baryła |
| 24 | Mikołaj Uzarski |
| 10 | Wojciech Przytuła |
| 1 | Piotr Dulikowski |
| 1 | Piotr Grabowski |
API cleanups / breaking changes:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.12.0,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
API cleanups / breaking changes:
CqlTimeuuid type. Timeuuid CQL type now corresponds to the new type instead of Uuid. The purpose of new type is mostly providing correct semantics (matching the database) with regard to sorting / comparing / hashing (#894)num_bigint::BigInt are now hidden behind feature flag. Support for num_bigint 0.4 is added. You can enable support for chosen version using num-bigint-03 / num-bigint-04 feature flags (#902)bigdecimal dependency version is bumped to 0.4. Similarly to BigInt, usages of bigdecimal are now behind feature-flag bigdecimal-04 (#922)New features / enhancements:
SerializeRow and SerializeCql derive macros now support skip field attribute to skip some fields during serialization (#903)Documentation:
SerializeRow / SerializeCql derive macros is now rendered only in scylla crate. Previously it was only visible in scylla-cql due to an oversight, which made it hard to discover for users. It is not possible to render it in both crates without duplicating it in code because of rustdoc limitation (#907)Session objects and recommendations about sharing Session objects between threads. You can find this section in Connecting to the cluster page of book (#914)Bug fixes:
time-related were put behind chrono feature flag instead of time feature flag (#898)chrono introduced an arguably breaking change - changing values of NaiveDate::MIN/MAX. We changed our tests to nor rely on those values. If you used those values as markers / placeholders in database, you may not be able to deserialize them with new version ofchrono(#919)CI / developer tool improvements:
Cargo.lock.msrv file and ways to update this file when min_rust job are now documented in CONTRIBUTING.md (#913)mdbook. In order to be able to build it with mdbook we had a wrapper script that stripped those sections before calling mdbook. Now this script is replaced by preprocessor script called automatically by mdbook - so just calling mdbook commands "just works" again now (#910).:::{warning}
text
:::
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 31 | Mikołaj Uzarski |
| 31 | Karol Baryła |
| 13 | Piotr Dulikowski |
| 2 | Oliver Bøving |
| 1 | David Garcia |
| 1 | Nick Sippl-Swezey |
Due to our mistake, crate scylla-macros 0.2.2 contained a breaking change, while only being a minor version bump. This resulted in the driver breaking…
Due to our mistake, crate scylla-macros 0.2.2 contained a breaking change, while only being a minor version bump.
This resulted in the driver breaking for some existing projects that use version 0.10.x.
You can find more detailed explanation here: https://github.com/scylladb/scylla-rust-driver/issues/891
To solve this situation:
scylla-macros 0.3.0 was released identical to 0.2.2 and 0.2.2 was yanked.scylla-cql 0.0.11 was released, the only changed from 0.0.10 is scylla-macros dependency bumped to 0.3.0.scylla 0.11.1 was released, the only change from 0.11.0 is updating the scylla-cql and scylla-macros dependencies. 0.11.0 was yanked.Additionally, we published scylla-macros 0.2.3, equivalent to 0.2.1, to minimize breakage in existing projects.
API cleanups / breaking changes:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.11.0,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
The main feature of this PR is refactor of serialization API. Old traits and structs (Value, ValueList, BatchValues - renamed to LegacyBatchValues, SerializedValues - renamed to LegacySerializedValues) are replaced by new ones (SerializeCql, SerializeRow, new BatchValues, new SerializedValues). There are wrappers and helper implementations provided, designed to aid in gradually migrating to new API - see the migration guide in the book for more information. Old traits and structs will be removed in one of future versions.
New serialization API has a benefit of type safety - now, if you use wrong type for a bind marker in a query, you will get an understandable error locally (without actually executing the query on the database) instead of cryptic deserialization error from Scylla, or worse - silent data corruption.
API cleanups / breaking changes:
New features / enhancements:
i16 to u16 (#824)Default for MaybeUnset (#883)Documentation:
Bug fixes:
Option<&&str> in one place to work around possible rustc bug (#838)CI / developer tool improvements:
needless_borrows_for_generic_args (#861)make ci so that developers can notice errors while testing locally (#877)cqlsh to unblock CI (#873)Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 116 | Piotr Dulikowski |
| 67 | Karol Baryła |
| 5 | Jan Ciołek |
| 5 | Sylwia Szunejko |
| 1 | David Garcia |
| 1 | Mikhail Pogretskiy |
| 1 | Nick Sippl-Swezey |
| 1 | Oliver Bøving |
| 1 | RoDmitry |
| 1 | Samuel Orji |
| 1 | Yaniv Kaul |
Backport of #1045 , commit id f4fc810 . Created on response to customer issue: scylladb/scylla-enterprise#5627
Backport of #1045, commit id f4fc810.
Created on response to customer issue: scylladb/scylla-enterprise#5627
Fixed a panic in LatencyAwarePolicy when 2 calls to Instant::now() returned the same value.
Instant::now() returned the same value. (#830)API cleanups / breaking changes:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.10.0,
an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
API cleanups / breaking changes:
Serial and LocalSerial levels to Consistency enum because those are valid levels for LWT SELECTs. LegacyConsistency became redundant so it was removed. (#792)pub specifiers removed but those should not result in API-break. (#773)StatementConfig private - it is used internally and does not appear in any public API. retry_policy field is moved there from Query, PreparedStatement and Batch. (#772)pick() and fallback() methods. Signature of ReplicaSet::choose_filtered() is slightly changed (a reference is added to predicate's argument). (#777)New features / enhancements:
std::hash. Changed all it's usages to take advantage of this functionality, getting rid of a lot of needless allocations of partition key. This decreased number of allocations and improved performance. (#758)scylla-macros now use produce proper compilation errors instead of panicking, resulting in nicer error messages. (#818)HashMap and HashSet with custom hashers. (#808)&[u8], which allows deriving ValueList for structs with &[u8] fields. (#790)write_coalescing() method from SessionBuilder to GenericSessionBuilder as there is nothing preventing using it in Cloud. (#778)cluster_metadata_refresh_interval method on GenericSessionBuilder. (#776)Documentation:
AddressTranslator trait. (#796)main branch. It also defaults to latest release. (#784)Bug fixes:
chrono dependency to the one that supports functionality that we use. (#807)CI / developer tool improvements:
RELEASE.md . (#785)SessionBuilder vs GenericSessionBuilder) to prevent CloudSessionBuilder not getting the functionalities that it should. (#781)Others:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 79 | Wojciech Przytuła |
| 34 | Piotr Dulikowski |
| 4 | Anna Stuchlik |
| 2 | Pavel Kirilin |
| 1 | Karol Baryła |
| 1 | Collin Styles |
| 1 | Jan Ciołek |
| 1 | Lucas Kent |
| 1 | Rishabh Aryal |
| 1 | koheatel |
Fixed a panic in LatencyAwarePolicy when 2 calls to Instant::now() returned the same value.
Instant::now() returned the same value. (#830)__API cleanups / breaking changes__:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.9.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
API cleanups / breaking changes:
Session::estimate_replicas_for_query. The same effect can be achieved via slightly longer session.get_cluster_data().get_token_endpoints(). (https://github.com/scylladb/scylla-rust-driver/pull/768)Session::get_tracing_info_custom. The parameters passed to that function (number of retries, delay between retries, consistency level) can now be set on the per-session level basis, and get_tracing_info should be used instead. (https://github.com/scylladb/scylla-rust-driver/pull/768)Consistency and SerialConsistency from the scylla::statement::batch module. Those are already available through more convenient import paths. (https://github.com/scylladb/scylla-rust-driver/pull/767)QueryResult from scylla::transport::connection module. It is already reexported from the scylla module which should be more convenient. (https://github.com/scylladb/scylla-rust-driver/pull/763)scylla::routing::Node struct. It hasn't been used by any of our APIs and had a very similar name to scylla::transport::Node, so it would only be a source of confusion if left alone any longer. (https://github.com/scylladb/scylla-rust-driver/pull/762)scylla-cql crate, as well as two internal functions related to frame compression/decompression. (https://github.com/scylladb/scylla-rust-driver/pull/764)CloudConfig struct has been exposed to the users. The purpose of this change is to aid in implementing Scylla Cloud support in the cpp-rust-driver project. (https://github.com/scylladb/scylla-rust-driver/pull/750)New features / enhancements:
tokio::tracing span in a human-readable form. Previously, it was also emitted, but in a form that is hard to parse by a human. (https://github.com/scylladb/scylla-rust-driver/pull/766)Session::calculate_token_for_partition_key is added. It allows to calculate a partition key only by using a partitioner and values of a partition key, no PreparedStatement object is needed. (https://github.com/scylladb/scylla-rust-driver/pull/757)scale parameter in LatencyAwarePolicy, which is exposed in cpp driver but was missing from the rust implementation's API, is now exposed. The previous default value has been changed. (https://github.com/scylladb/scylla-rust-driver/pull/733)Bug fixes:
RoutingInfo struct to load balancing policies used to have incorrect consistency level set. This is now fixed, and a regression test has been added. (https://github.com/scylladb/scylla-rust-driver/pull/743)CI / developer tool improvements:
Others:
clone.rs example has been removed. It promoted bad practices; we recommend only using one Session object per application. (https://github.com/scylladb/scylla-rust-driver/pull/728)SimpleStrategy has been removed from examples and documentation. This strategy will become deprecated in ScyllaDB in the future, and we no longer want to promote its use in learning materials. (https://github.com/scylladb/scylla-rust-driver/pull/726)ccm tool, used by the CI, requires Python 2 which is no longer available in the ubuntu-latest runner. Requirement for Python 2 will be dropped with the next ScyllaDB release, and the system version will be upgraded again after this happens. (https://github.com/scylladb/scylla-rust-driver/pull/752)docker compose version has been upgraded from V1 to V2 in the CI. The old one stopped receiving updates. (https://github.com/scylladb/scylla-rust-driver/pull/761)Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 20 | Piotr Dulikowski |
| 15 | Wojciech Przytuła |
| 11 | Piotr Grabowski |
| 3 | Jan Ciolek |
| 2 | David Garcia |
| 2 | Gor Stepanyan |
| 1 | Lucas Kent |
That feature implies a transitive dependency on time crate in version 0.1, which has a vulnerability. More details here: https://rustsec.org/advisorie…
Features:
Security fixes:
chrono dependency no longer requires the oldtime feature. That feature implies a transitive dependency on time crate in version 0.1, which has a vulnerability. More details here: https://rustsec.org/advisories/RUSTSEC-2020-0071 (https://github.com/scylladb/scylla-rust-driver/pull/723)Bugfixes:
Enhancements:
SessionConfig::add_known_nodes{_addr} and SessionBuilder::known_nodes{_addr} functions were made more generic and now they accept a wider range of argument types. (https://github.com/scylladb/scylla-rust-driver/pull/705)RUST_BACKTRACE=full environment variable which causes full backtraces to be printed when panic occurs in tests. This should help in debugging issues, especially those that only occur in CI. (https://github.com/scylladb/scylla-rust-driver/pull/719)Token awareness now works correctly with execute_iter.
Bugfixes:
execute_iter. (#700)Enhancements:
set_retry_policy/get_retry_policy methods were brought back (they were removed previously with the introduction of execution profiles). (#707)CI:
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.8.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible wi
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.8.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
New features / enhancements:
DefaultPolicy, which is configurable and offers the same functionality as the previous, composable policies. (#612)BatchValues trait was simplified with the help of recently introduced Generic Associated Types (GATs). (#596)impl FromCqlVal for CqlDuration, which was previously missing, was added. (#623)impl FromCqlVal for Date, which was previously missing, was added. (#638)secrecy::Secret was added. To enable it, you need to enable the secret feature. (#619)Session::calculate_token is now public. (#658)Clone trait. (#669)deser_cql_value function was made public. It is used by the scylla-rust-udf library. (#630)ahash in tests. It wasn't really needed and, in some cases, could trigger a bug in the cargo resolver with a cryptic error message, which could prevent the whole project from compiling. (#625)scylla-cql by using the #[scylla_crate = "scylla_cql"] attribute. (#628)AddressTranslator to be more dynamic - for example, if a node's IP changes and all connections are closed, if the AddressTranslator reacts to this quickly then the driver can re-establish connections to this node much more quickly. (#641)Bug fixes:
Session::query_iter/execute_iter methods will now correctly work when used to send a write request. (#644)Performance improvements:
Connection::query_all that was used to fetch cluster metadata has been replaced with Connection::query_iter. The new method does not concatenate results from multiple pages into single one, but rather returns an iterator which allows processing the rows as they are fetched in the background. This should reduce memory usage during metadata fetch in some extreme cases. Moreover, the new method fits the upcoming "iterator-based deserialization" API rework better. (#645)PreparedStatement is now cheaper to clone. Its internals that allocated on clone are now wrapped in an Arc. (#653)CI / developer tool improvements:
Makefile now boots Scylla nodes sequentially. This slows down the boot process, but the old method is technically incorrect and could result in a fail - the new method follows the best practices. (#647)Other:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 108 | Wojciech Przytuła |
| 66 | Piotr Dulikowski |
| 18 | Michał Sala |
| 5 | Jan Ciolek |
| 5 | Wojciech Mitros |
| 3 | Jan Ciołek |
| 3 | Thomas BESSOU |
| 1 | Gor Stepanyan |
| 1 | Sining (Stephen) Ma |
| 1 | Ten0 |
Although this policy may be useful for some use cases, caution is advised as it was deprecated in C++ driver and also removed from the Java driver
The ScyllaDB team is pleased to announce ScyllaDB Rust Driver 0.7.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Some interesting statistics:
Bugs fixed:
CachingSession used to cache not only prepared statement IDs but also query parameters (such as page size) and those parameters overrode the ones provdided to CachingSession::execute. This caused strange and inconsistent behavior. Now, query parameters are not cached but are always taken from the Query object provided to CachingSession::execute (https://github.com/scylladb/scylla-rust-driver/pull/598)query_iter/execute_iter is used to perform a write with a DowngradingConsistencyPolicy (https://github.com/scylladb/scylla-rust-driver/pull/609)system.clients table (https://github.com/scylladb/scylla-rust-driver/pull/611)scylla-macros crate can now be used on generic structs (https://github.com/scylladb/scylla-rust-driver/pull/565)New features/enhancements:
TokenAwareStrategy to choose the nodes for queries in a predefined order, bypassing any shuffling coming from the child policy. This reduces the number of retries needed to perform an LWT update in case when multiple clients try to update the same key (https://github.com/scylladb/scylla-rust-driver/pull/578)LatencyAwarePolicy has been added which mimics the behavior of C++ driver's latency aware routing. The new policy measures latency on a per-node basis and prefers nodes with lower latencies. Although this policy may be useful for some use cases, caution is advised as it was deprecated in C++ driver and also removed from the Java driver (https://github.com/scylladb/scylla-rust-driver/pull/536)AuthenticatorProvider and AuthenticatorSession traits. The previous, hardcoded password authentication scheme is now offered as PlainTextAuthenticator (although the SessionBuilder::user method was kept for convenience) (https://github.com/scylladb/scylla-rust-driver/pull/572)CachingSession now supports custom hashers for use in the internal hashmap. By default, the default hasher from the standard library is used, but a more efficient implementation can be chosen by the user (https://github.com/scylladb/scylla-rust-driver/pull/577)impl_from_cql_value_from_method! macro is added that allows you to easily generate FromCqlValue impls from your extension trait methods (https://github.com/scylladb/scylla-rust-driver/pull/601)Value trait used for serialization was implemented for Box and for references to unsized types, allowing to cover trait objects (dyn T) as well (https://github.com/scylladb/scylla-rust-driver/pull/590)CI / developer tools:
Congrats to all contributors and thanks everyone for using our driver!
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since the last release:
| commits | author |
|---|---|
| 63 | Wojciech Przytuła |
| 10 | Michał Sala |
| 10 | Thomas BESSOU |
| 9 | Piotr Dulikowski |
| 5 | Colin O'Brien |
| 2 | Gor Stepanyan |
| 2 | colin-grapl |
| 1 | Jan Ciolek |
| 1 | Joseph Perez |
| 1 | Lucas Kent |
| 1 | Piotr Grabowski |
Forgot to update the scylla-cql version from 0.0.1 to 0.0.2 in Cargo.toml which prevented 0.6.0 from being published to crates.io. The version 0.6.1 d
The ScyllaDB team is delighted to announce ScyllaDB Rust Driver 0.5.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible
The ScyllaDB team is delighted to announce ScyllaDB Rust Driver 0.5.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Cool, ever growing open-source stats:
=== Notable changes ===
Also, the usual stuff: fixes, speedups, amendments, doc updates and example updates were all applied.
Congrats to all contributors and thanks everyone for using our driver!
=======================
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since last release: commits|author 28 Wojciech Przytuła 14 Piotr Sarna 13 Piotr Dulikowski 13 Jan Ciołek 2 Lucas Kent 1 David Garcia 1 Gor Stepanyan
schema changes now wait for schema agreement by default, because it's never a bug to wait unnecesarily, while it is a bug not to wait at all - this be
Prepared metadata is now accessible for users.
CDC partitioner support was added
tower integration example was addedswitched from deprecated max_value and min_value to ::MAX and ::MIN respectively
It's now possible to set up a keepalive interval for a session, which is useful for rarely used sessions (e.g. ones querying once an hour for statisti
token aware policy is now capable of falling back to non-replicas, if none are available
fixed issue #392 - IoError used to lose context when it was propagated from lower layers and it's no longer the case
The Scylla team is pleased to announce Scylla Rust Driver 0.4.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with A
The Scylla team is pleased to announce Scylla Rust Driver 0.4.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
We're also excited to shamelessly brag about:
=== Notable changes ===
Non-standard partitioners used to cause the driver to fail - it's no longer the case, a fallback token policy will be used.
Maps and sets based on B-Trees can now be used as the source of their corresponding CQL types: map and set.
Getting column specification is now also possible for iterator-based queries.
It's now possible to inspect current schema information directly from the driver. The metadata includes tables, their columns, types, column kinds (regular, static, clustering/partition key), ordering of partition key and clustering columns, UDTs, partitioner, etc. Fetching schemas can be optionally disabled when building a session.
Request ids orphaned by timeouts are now accounted for and managed. When a request times out, its request id cannot be immediately reused in order to avoid matching responses with incorrect requests (e.g. see an interesting bug lately discovered in Python CQL driver: https://github.com/scylladb/python-driver/pull/106). Scylla Rust Driver now properly tracks which requests got orphaned and returns them to the pool only once it's safe to do so.
Batched requests used to fail when one or more statements turned out to be not prepared on the server side. The new heuristics tries to reprepare all missing statements and retry the execution.
Named bind markers are now supported. It's still recommended to use unnamed markers for binding variables in statements (?) since they induce less overhead, but the named syntax (:name) is now also accepted.
A visibility bug in the load balancing layer made it impossible to actually implement custom load balancing policies. It's now fixed, and custom policies can be coded by implementing the LoadBalancingPolicy trait.
A number of convenience functions were added in order to make it more ergonomic to manage query results: rows_num, rows, rows_typed, result_not_rows, rows_or_empty, rows_typed_or_empty, first_row, first_row_typed, maybe_first_row, maybe_first_row_typed, single_row, single_row_typed.
Also, as usual, many fixes, smaller amendments, examples and doc updates were applied.
Congrats to all contributors and thanks everyone for using our driver!
=======================
The source code of the driver can be found here:
The official crates.io registry entry is here:
Thank you for your attention, please do not hesitate to contact us if you have any questions, issues, feature requests, or are simply interested in our driver!
Contributors since last release: commits|author 24 Piotr Sarna 16 Jan Ciolek 12 Piotr Dulikowski 8 Marcin Mazurek 6 Michał Sala 3 nemosupremo 3 Maciej Herdon 2 Jan Ciołek 1 Ultrabug 1 guy9 1 Creston Bunch 1 Adam Boguszewski
performance improvements by applying buffering to reads and writes
he Scylla team is pleased to announce Scylla Rust Driver 0.3.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Ap
he Scylla team is pleased to announce Scylla Rust Driver 0.3.0, an asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Congrats to all contributors and thanks everyone for using our driver!
Nothing published for this version
Nothing published for this version
The (extended) Scylla team is pleased to announce the first release of Scylla Rust Driver 0.1.0 - a brand new, asynchronous CQL driver for Rust, optim
The (extended) Scylla team is pleased to announce the first release of Scylla Rust Driver 0.1.0 - a brand new, asynchronous CQL driver for Rust, optimized for Scylla, but also compatible with Apache Cassandra!
Our new driver is capable of the following, and much more:
Crates:
One column per quarter.