Data distribution to nodes

In Hyper-Converged Database (HCD), the cluster manages the total amount of data as a ring. HCD divides the ring into ranges equal to the number of nodes, and each node handles one or more data ranges. Before a node can join the ring, you must assign it a token. The token value determines the node’s position in the ring and its range of data. HCD partitions table data across the nodes based on the row key.

To determine the node where the first replica of a row will live, HCD locates the node with a token value greater than that of the row key. Each node handles the region of the ring between the node itself and its predecessor, excluding the predecessor’s token value. When you sort the nodes in token order, the last node becomes the predecessor of the first node.

For example, consider a simple four-node cluster where all of the row keys managed by the cluster are numbers in the range of 0 to 100. HCD assigns each node a token representing a point in this range. In this simple example, the token values are 0, 25, 50, and 75. The first node with token 0 handles the wrapping range from 76 to 0. The node with the lowest token also accepts row keys less than the lowest token and more than the highest token.

A large circle divided into four quadrants to represent a cluster with evenly distributed token ranges. Four smaller

HCD provides several types of partitioners for your cluster. HCD assigns an initial_token value to each node so that each node handles roughly an equal amount of data.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2025 DataStax | Privacy policy | Terms of use | Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com