MPL-2.0 licensed by Toralf Wittner
Maintained by Toralf Wittner, Roman S. Borschel

Module documentation for 1.1.0

CQL Cassandra driver

This library uses the cql library which implements Cassandra’s CQL protocol and complements it with the neccessary I/O operations. The feature-set includes:

Node discovery

The driver discovers nodes automatically from a small set of bootstrap nodes.

Customisable load-balancing policies

In addition to pre-built LB policies such as round-robin, users of this library can provide their own policies if desired.

Support for connection streams

Requests can be multiplexed over a few connections.

Customisable retry settings

Support for default retry settings as well as local overrides per query.

Prepared queries

Prepared queries are an optimisation which parse and prepare a query only once on Cassandra nodes but execute it many times with different concrete values.

TLS support

Client to node communication can optionally use transport layer security (using HsOpenSSL).

License

See LICENSE.

Cassandra Logo License

Copyright © 2018 Apache Software Foundation

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Changes

1.1.0
-----
- Improve configuration of retry settings and refactor exceptions
(https://gitlab.com/twittner/cql-io/issues/13).
- Document and export the 'getResult' function alongside the low-level
query API.
- Replace monad-control with unliftio.
- Remove dependency on tinylog, introducing a minimal logging interface that can
be hooked up to any logging library. Tinylog integration has moved to
the new cql-io-tinylog library.

1.0.1.1
-------
- Add more documentation on queries.

1.0.1
------
- Address an issue whereby Cassandra 'Error' responses might be mistakenly
thrown by the (internal) withRetries function, possibly leading to
problems with the automatic (re-)preparation of prepared queries upon
'Unprepared' server responses.

1.0.0
------
- Add support for CQL V4 binary protocol.
- Remove support for CQL V2 binary protocol.
- Add support for SASL-based authentication handlers.
- Bugfix: Retries for error responses were not handled correctly.
- Update and extend test suite.
- Require `cql >= 4.0`

0.16.0
------
- Update Cabal settings to allow `cql` >= 3.1

0.15.2
------
- Update `async` dependency

0.15.1
------
- Use `retry >= 0.7` instead of internal module

0.15.0
------
- Add experimental TLS support

0.14.5
------
- Add `trans` to execute "lightweight transactions"

0.14.4
------
- Update dependencies

0.14.3
------
- Bugfixes

0.14.2
------
- Export `PrepareStrategy` from `Database.CQL.IO`

0.14.1
------
- Support for prepared queries
- Bugfixes
- `Control.Retry` module update to match version 0.6

0.13.2
------
- Retry on `IOException`
- Update dependencies

0.13.1
------
- Support `monad-control` 1.*

0.13.0
------
- Add `setMaxRecvBuffer` option

0.12.2
------
- Update dependencies

0.12.1
------
- Update dependencies

0.12.0
------
- Remove wait-queue
- Add more type-class instances

0.10.0
------
- Add `MonadClient` type-class
- Add retry settings

0.9.7
-----
- Bugfix release

0.9.6
-----
- Initial release
Depends on 3 packages:
Used by 2 packages:
comments powered byDisqus