Isolation Levels

Not Supported

Dolt does not support transactions. In Dolt's model, concurrent edits take place on separate branches and would be merged by explicit user actions.

Logging

Not Supported

Dolt does not support logging but ensures data durability. New data is written once to new table files containing new chunks. The table files are written to disk before the manifest references are updated.

System Architecture

Shared-Nothing

Dolt is not distributed at a system level. Dolt is designed to distribute the same database to multiple locations where it can be worked on in isolation and any edits from one location can be explicitly pulled or pushed to another location. At the checkout level, Dolt databases are shared-nothing.

Foreign Keys

Not Supported

Under active development.

Query Interface

Custom API SQL Command-line / Shell

Dolt provides a Git like command-line interface. Dolt also allows SQL queries through the MySQL wire protocol and through its command line. Dolt also allows data to be imported and exported using CSV files.

Stored Procedures

Not Supported

Checkpoints

Not Supported

Dolt does not support mutable database files, hence it does not explicitly take checkpoints. Dolt has a manifest that stores pointers to all currently active table files, which is updated atomically on every mutation of the database.

Data Model

Relational

Dolt emulates MySQL.

Query Execution

Tuple-at-a-Time Model

Dolt supports iterator based query processing with no intra-query parallelism.

Storage Architecture

Disk-oriented

Dolt uses disk storage and can currently store datasets up to 100GB.

Compression

Dictionary Encoding

Dolt uses Snappy an open-sourced compression library that prioritizes speed over size. All chunks are compressed with Snappy before storage and are decompressed as they are read into the block cache. It is necessary to decompress data in order to process queries.

Indexes

B+Tree

Dolt supports a B-tree like index structure for table primary keys only.

Views

Not Supported

Concurrency Control

Not Supported

Dolt does not support transactions. Concurrent SQL sessions on the same dolt checkout will see read committed, with an auto-commit on each executed SQL statement.

Storage Model

N-ary Storage Model (Row/Record)

Dolt stores tables in the N-ary Storage Model with clustered primary keys. The entire dataset is content-addressed as a Merkle Tree of component blocks. A Merkle tree is a hash-based data structure that is a generalization of the hash list. It is a tree structure in which each leaf node is a hash of a block of data, and each non-leaf node is a hash of its children. The boundaries for internal and leaf nodes are chosen by a rolling hash of the block contents.

Storage Organization

Sorted Files

Dolt stores its dataset as a Merkle Tree of component blocks. The content-addressed blocks are stored in write-once table files with a static binary-searchable index at the end. When the table files grow to a number beyond a certain threshold, a compaction phase is run. New data is only written once. It is written to new table files containing the new chunks. These table files are flushed to disk before the manifest referencing them is updated.

Query Compilation

Not Supported