page_title: Log-structured merge-tree
hierarchical_section_title: Log-structured merge-tree
caption_attribution_description: English: Diagram of a log-structured merge tree (or LSM tree).
context_page_description: In computer science, the log-structured merge-tree is a data structure with performance characteristics that make it attractive for providing indexed access to files with high insert volume, such as transactional log data. LSM trees, like other search trees, maintain key-value pairs. LSM trees maintain data in two or more separate structures, each of which is optimized for its respective underlying storage medium; data is synchronized between the two structures efficiently, in batches.
  One simple version of the LSM tree is a two-level LSM tree.
  As described by Patrick O'Neil, a two-level LSM tree comprises two tree-like structures, called C₀ and C₁. C₀ is smaller and entirely resident in memory, whereas C₁ is resident on disk. New records are inserted into the memory-resident C₀ component. If the insertion causes the C₀ component to exceed a certain size threshold, a contiguous segment of entries is removed from C₀ and merged into C₁ on disk.
context_section_description: In computer science, the log-structured merge-tree (or LSM tree) is a data structure with performance characteristics that make it attractive for providing indexed access to files with high insert volume, such as transactional log data. LSM trees, like other search trees, maintain key-value pairs.  LSM trees maintain data in two or more separate structures, each of which is optimized for its respective underlying storage medium; data is synchronized between the two structures efficiently, in batches.
  One simple version of the LSM tree is a two-level LSM tree.
  As described by Patrick O'Neil, a two-level LSM tree comprises two tree-like structures, called C₀ and C₁. C₀ is smaller and entirely resident in memory, whereas C₁ is resident on disk. New records are inserted into the memory-resident C₀ component. If the insertion causes the C₀ component to exceed a certain size threshold, a contiguous segment of entries is removed from C₀ and merged into C₁ on disk. The performance characteristics of LSM trees stem from the fact that each component is tuned to the characteristics of its underlying storage medium, and that data is efficiently migrated across media in rolling batches, using an algorithm reminiscent of merge sort.
  Most LSM trees used in practice employ multiple levels.  Level 0 is kept in main memory, and might be represented using a tree.   The on-disk data is organized into sorted runs of data.  Each run contains data sorted by the index key.  A run can be represented on disk as a single file, or alternatively as a collection of files with non-overlapping key ranges.  To perform a query on a particular key to get its associated value, one must search in the Level 0 tree and each run.
  A particular key may appear in several runs, and what that means for a query depends on the application.  Some applications simply want the newest key-value pair with a given key.  Some applications must combine the values in some way to get the proper aggregate value to return.  For example, in Apache Cassandra, each value represents a row in a database, and different versions of the row may have different sets of columns.
  In order to keep down the cost of queries, the system must avoid a situation where there are too many runs.
  Extensions to the 'leveled' method to incorporate B+ tree structures have been suggested, for example bLSM and Diff-Index.
  LSM trees are used in data stores such as Bigtable, HBase, LevelDB, SQLite4, Tarantool ,
  RocksDB, WiredTiger, Apache Cassandra, InfluxDB and ScyllaDB.
caption: Diagram illustrating compaction of data in a log-structured merge tree
exif: {}