A token is an integer position on a hash ring. ScyllaDB hashes each partition key to a token, placing rows with the same partition key together and assigning responsibility for that position to a node. section 3.3.1
Nodes claim token ranges around the ring, often through multiple virtual-node positions. When a node joins, it takes portions of existing ranges, and other nodes stream those rows to the new owner. section 3.3.1
During reads and inserts, ScyllaDB hashes the partition key, determines the applicable token, and forwards the request to the node that owns it. The TOKEN function exposes a partition's ring position. section 8.2.1
Inspecting a token
Use TOKEN(id) in cqlsh to display the ring position associated with each partition-key value: SELECT TOKEN(id), id FROM reviews.authors; section 8.2.1
Figure 3.8 Partitions are mapped to places on a hash ring.
A hash-ring figure makes the relationship between partition placement and token positions visible. section 3.3.1
