Skip to main content

A Harlequin adapter for Cassandra.

Project description

harlequin-cassandra

[!CAUTION] This adapter is unstable and experimental.

Proceed with caution!

[!WARNING] This adapter does not aim to support Scylla.

[!NOTE] This adapter currently does not support execution profiles, load-balancing polices.

This is a Cassandra adapter for Harlequin.
It is based on Datastax' cassandra-driver.

Integration With Harlequin

Some quirks are to be expected.

Cassandra doesn't use cursor(s), thus HarlequinCursor and HarlequinConnection behave differently in this adapter.

A manual translation of cassandra-driver objects types to Python types is required for Apache Arrow to work correctly.

In this adapter, Transaction Modes refers to Cassandra's consistency levels.

Transaction Modes GIF

Installation

harlequin-cassandra depends on harlequin, so installing this package will also install Harlequin.

Using pip

To install this adapter into an activated virtual environment:

pip install harlequin-cassandra

Using poetry

poetry add harlequin-cassandra

Using pipx

If you do not already have Harlequin installed:

pip install harlequin-cassandra

If you would like to add the Cassandra adapter to an existing Harlequin installation:

pipx inject harlequin harlequin-cassandra

As an Extra

pip install harlequin[cassandra]

Usage and Configuration

You can open Harlequin with the Cassandra adapter by selecting it with the -a option and passing an initial hostname and credentials(if required).

harlequin -a cassandra "localhost" --username "cassandra" --password "cassandra"

Many more options are available; to see the full list, run:

harlequin --help

Things To Explore

Missing advanced configuration that may be of interest:

  • Add an option to support execution profiles.
  • Add an option to support load-balancing policies.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

harlequin_cassandra-0.1.1.tar.gz (9.1 kB view hashes)

Uploaded Source

Built Distribution

harlequin_cassandra-0.1.1-py3-none-any.whl (9.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page