liveBook · Manning

Nodetool describering

As explained in ScyllaDB in Action

nodetool describering is a Cassandra-compatible cluster-administration command that displays token ranges and their owning endpoints for a keyspace.

nodetool describering displays the token ranges for a keyspace and the endpoints that own each range. Its output identifies where ownership shifts in the hash ring, helping divide comprehensive scans into node-local queries. section 12.1.1

Use the command to make token-range extraction more targeted:

  • Run describering for the keyspace being scanned. section 12.1.1
  • Read each range’s start token, end token, and owning endpoints; output order is not sorted. section 12.1.1
  • Use the ranges with TOKEN predicates to query large portions of a table on one node and its replicas. section 12.1.1
  • Prefer driver metadata when available: the Python driver stores end-token-to-host mappings by keyspace. section 12.1.1

Inspecting the reviews keyspace

Run `nodetool describering reviews`. A returned TokenRange includes start_token, end_token, endpoints, RPC endpoints, datacenter, and rack. In a one-node cluster, the range lists one endpoint such as `172.18.0.2`.

How ScyllaDB in Action covers it

How deep it goes
Explains range boundaries, endpoint ownership, driver metadata, and extraction trade-offs, but not command implementation internals.
Examples
Uses `nodetool describering reviews` and sample ranges containing tokens, endpoints, datacenters, and racks.
What it assumes
Assumes familiarity with keyspaces and queries, while introducing hash-ring ownership and TOKEN-based range scanning.
What you can do after
Operate/configure token-range exports by discovering ownership and passing bounded ranges to queries.
How it connects
Connects token ranges with the hash ring, TOKEN function, replicas, Python driver metadata, and data extraction.
Cover of ScyllaDB in Action
liveBookmanning.com
Read ScyllaDB in Action on liveBook Get the book at manning.com

Related concepts

This explainer was generated by Manning's knowledge graph from the text of ScyllaDB in Action. The section links point to the parts of the book it draws on.