nodetool datapaths

Cassandra 4.1+

This command is available in Cassandra 4.1 and later.

Displays the data file directories for the node.

---

Synopsis

nodetool [connection_options] datapaths [options] [--] [<keyspace.table> | <keyspace>]

See connection options for connection options.

Description

nodetool datapaths shows the data file paths for tables on the Cassandra node. The output is organized by keyspace and table, showing where each table's SSTables are stored.

Options

Option	Description
-F, --format <format>	Output format (json or yaml)

---

Examples

Basic Usage

nodetool datapaths

Sample Output

Keyspace: my_keyspace
        Table: users
                /var/lib/cassandra/data/my_keyspace/users-abc123
        Table: orders
                /var/lib/cassandra/data/my_keyspace/orders-def456
Keyspace: system
        Table: local
                /var/lib/cassandra/data/system/local-xyz789
...

Filter by Keyspace or Table

# Show paths for specific table
nodetool datapaths my_keyspace.users

# Show paths for all tables in a keyspace
nodetool datapaths my_keyspace

---

Configuration

Data paths are configured in cassandra.yaml:

cassandra.yaml

data_file_directories:
    - /var/lib/cassandra/data

# Or multiple directories:
data_file_directories:
    - /mnt/disk1/cassandra/data
    - /mnt/disk2/cassandra/data

---

Use Cases

Verify Configuration

# Confirm data directory paths
nodetool datapaths

Disk Space Monitoring

# Check disk space on data directories using tablestats
nodetool tablestats my_keyspace | grep "Space used"

JSON Output

# Get paths in JSON format for scripting
nodetool datapaths -F json my_keyspace

---

Best Practices

Data Path Guidelines

1. Dedicated disks - Use separate disks for data
2. Monitor space - Track disk usage per path
3. Fast storage - SSDs recommended for data paths
4. JBOD configuration - Multiple paths for JBOD setups

---

Related Commands

Command	Relationship
info	Node information including paths
tablestats	Table disk usage
status	Cluster overview