ストレージエンジン

書き込みが発生すると、Cassandraはデータをローカルの追記専用cassandra.apache.org//glossary.html#commit-log)[コミットログ]に書き込みます。この操作により、Cassandraノードに行われたすべての書き込みをログに記録することで、設定可能な耐久性が提供されます。予期しないシャットダウンが発生した場合、コミットログはデータの永続的な耐久性のある書き込みを提供します。起動時に、コミットログ内のすべての変更はcassandra.apache.org//glossary.html#memtable)[memtable]に適用されます。コミットログはテーブル間で共有されます。

すべての変更は、コミットログセグメントのストレージで書き込みが最適化され、ディスクへの書き込みに必要なシーク数が削減されます。コミットログセグメントは、commitlog_segment_sizeオプションによって制限されます。定義されたサイズに達すると、新しいコミットログセグメントが作成されます。すべてのデータがSSTableにフラッシュされると、コミットログセグメントはアーカイブ、削除、またはリサイクルできます。Cassandraが特定の時点よりも古いデータをSSTableに書き込んだ場合、コミットログセグメントは切り捨てられます。nodetool drainをCassandraを停止する前に実行すると、memtable内のすべてのデータがSSTableに書き込まれ、起動時のコミットログとの同期が不要になります。

デフォルト値：batch

デフォルト値：/var/lib/cassandra/commitlog

デフォルト値：（複雑なオプション）

デフォルト値：8192MiB

書き込みが発生すると、Cassandraはデータをmemtableにも書き込みます。memtableは、Cassandraが書き込みをバッファリングするインメモリ構造です。一般的に、テーブルごとに1つのアクティブなmemtableがあります。memtableは、Cassandraがキーで検索するデータパーティションのライトバックキャッシュです。memtable_allocation_typeに応じて、memtableは完全にオンヒープ、または部分的にオフヒープに格納できます。

memtableは、設定可能な制限に達するまで、書き込みをソートされた順序で格納します。制限に達すると、memtableはディスクにフラッシュされ、変更不可能なSSTableになります。フラッシュはいくつかの方法でトリガーできます。

トリガーイベントが発生すると、memtableはディスクにフラッシュされるキューに入れられます。フラッシュは、memtableでソートされた順序でデータをディスクに書き込みます。トークンをディスク上の場所へマッピングするパーティションインデックスもディスク上に作成されます。

キューは、cassandra.yamlファイルのmemtable_heap_spaceまたはmemtable_offheap_space設定を使用して設定できます。フラッシュするデータがmemtable_cleanup_thresholdを超えると、次のフラッシュが成功するまで、Cassandraは書き込みをブロックします。nodetool flushまたはnodetool drain（他のノードへの接続を待機せずにmemtableをフラッシュします）を使用して、テーブルを手動でフラッシュできます。コミットログの再生時間を短縮するために、ノードを再起動する前にmemtableをフラッシュすることをお勧めします。ノードが動作を停止した場合、コミットログの再生により、停止前に存在していたmemtableへの書き込みが復元されます。

memtable内の対応するデータがディスク上のSSTableにフラッシュされると、コミットログ内のデータはパージされます。

SSTableは、Cassandraがディスクにデータを永続的に保存するために使用する変更不可能なデータファイルです。SSTableはテーブルごとに保持されます。SSTableは変更不可能であり、memtableがフラッシュされた後は二度と書き込まれません。したがって、データの追加または変更に応じて、パーティションは通常複数のSSTableファイルに格納されます。

各SSTableは、個別のファイルに格納されている複数のコンポーネントで構成されています。

Data.db ファイル内では、行はパーティション別に整理されています。これらのパーティションはトークン順（つまり、デフォルトのパーティショナーであるMurmur3Partitionを使用する場合、パーティションキーのハッシュによる）でソートされています。パーティション内では、行はクラスタリングキーの順序で格納されます。

SSTableは、オプションでブロックベースの圧縮を使用して圧縮できます。

SSTableがmemtablesからディスクにフラッシュされるか、他のノードからストリーミングされると、Cassandraはコンパクションをトリガーして複数のSSTableを1つに結合します。新しいSSTableが書き込まれると、古いSSTableは削除できます。

(BigFormat#BigVersionより)。

これまでに使用されているバージョン番号は次のとおりです。

Cassandra 5.0では、Trieインデックス付きSSTableの新しいSSTableフォーマットであるBTIが導入されました。BTIフォーマットを使用するには、cassandra.yamlで設定します。

バージョンは(BtiFormat#BtiVersionより)。

実装ドキュメントについては、(BtiFormat.mdを参照してください。