Was this page helpful?
ScyllaDB Java Driver is available under the Apache v2 License. ScyllaDB Java Driver is a fork of DataStax Java Driver. See Copyright here.
Caution
You're viewing documentation for a previous version of Scylla Java Driver. Switch to the latest stable version.
Connectivity¶
Quick overview¶
How the driver reaches the nodes of a cluster, and what each kind of network needs configured.
contact points and a local datacenter, and nothing else, when every node is reachable at the address it broadcasts – VPC peering, AWS Transit Gateway, or a direct connection over the public internet.
a cloud private endpoint that publishes per-node routes needs client routes, which this version does not have: they are first available in driver 4.19.0.7, see client routes.
advanced.address-translatorfor anything else, see address resolution.
A CqlSession starts from the contact points you give it, discovers the rest of the cluster from
system.peers, and then opens connections to each node at the address that node broadcasts. Whether
that last step works is a property of your network, not of the driver, and it is what the pages in
this section are about.
| How your application reaches the cluster | What the driver needs |
|---|---|
| VPC peering, Transit Gateway or a direct connection -- every node is reachable at the address it broadcasts | contact points and a local datacenter, nothing else |
A cloud private endpoint that publishes a per-node entry in system.client_routes -- AWS PrivateLink, Azure Private Link, GCP Private Service Connect |
client routes, which need driver 4.19.0.7 or later |
| A proxy in front of the cluster -- one hostname for every node (a single-endpoint PrivateLink included), or EC2 multi-region | an address translator |
A cloud private endpoint appears in two of those rows, and the difference is what the cluster
publishes: a per-node endpoint mapping the driver can read means client routes, while one hostname
standing in front of every node means an address translator. The translator has to give each node
its own address and port: nodes translated to the same one share a single endpoint, so the proxy
rather than the driver picks the node, and token-aware and shard-aware routing stop working.
FixedHostNameAddressTranslator keeps each node’s port, which on ScyllaDB is the same for every
node, so it does not meet this on its own.
Two things are the same in every case and are covered elsewhere: SSL for encrypting the traffic, and authentication for proving who you are. Contact points themselves are covered in the core manual.