sstablesplit

Use this tool to split SSTables files into multiple SSTables of a maximum designated size. For example, if SizeTieredCompactionStrategy (STCS) was used for a major compaction and results in a excessively large SSTable, it’s a good idea to split the table because won’t get compacted again until the next huge compaction.

DataStax Enterprise must be stopped to use this tool.

Synopsis

sstablesplit [options] <filename> [<filename>]*

For tarball and Installer No-Services installations, run this command from INSTALL_DIRECTORY/resources/cassandra/bin.

Example

sstablesplit -s 40 /var/lib/cassandra/data/Keyspace1/Standard1/*

Options

Short Long Description

--debug

Display stack traces.

-h

--help

Display help.

--no-snapshot

Do not snapshot the SSTables before splitting.

-s

--size <size>

Maximum size in megabytes (MB) for the output SSTables (default: 50).

-v

--verbose

Verbose output.

Troubleshoot OutOfMemoryError

Some tools require a larger heap size. If you get OutOfMemoryError exceptions, try increasing the heap size for sstablesplit. To do this, edit the MAX_HEAP_SIZE in the tools/bin/sstablesplit shell script. For example:

MAX_HEAP_SIZE="8G"

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | 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: Contact IBM