Bedrock – Rock-solid distributed data

Bedrock is a simple, modular, WAN-replicated, Blockchain-based data foundation for global-scale applications. Taking each of those in turn:

Bedrock is simple. This means it exposes the fewest knobs necessary, with appropriate defaults at every layer.

This means it exposes the fewest knobs necessary, with appropriate defaults at every layer. Bedrock is modular. This means its functionality is packaged into separate “plugins” that are decoupled and independently maintainable.

This means its functionality is packaged into separate “plugins” that are decoupled and independently maintainable. Bedrock is WAN-replicated. This means it is designed to endure the myriad real-world problems that occur across slow, unreliable internet connections.

This means it is designed to endure the myriad real-world problems that occur across slow, unreliable internet connections. Bedrock is Blockchain-based. This means it uses a private blockchain to synchronize and self organize.

This means it uses a private blockchain to synchronize and self organize. Bedrock is a data foundation. This means it is not just a simple database that responds to queries, but rather a platform on which data-processing applications (like databases, job queues, caches, etc) can be built.

This means it is not just a simple database that responds to queries, but rather a platform on which data-processing applications (like databases, job queues, caches, etc) can be built. Bedrock is for global-scale applications. This means it is built to be deployed in a geo-redundant fashion spanning many datacenters around the world.

Bedrock was built by Expensify, and is a networking and distributed transaction layer built atop SQLite, the fastest, most reliable, and most widely distributed database in the world.

Why to use it

If you’re building a website or other online service, you’ve got to use something. Why use Bedrock rather than the alternatives? We’ve provided a more detailed comparision against MySQL, but in general Bedrock is:

Faster. This is true for networked queries using the Bedrock::DB plugin, but especially true for custom plugins you write yourself because SQLite is just a library that operates inside your process’s memory space. That means when your plugin queries SQLite, it isn’t serializing/deserializing over a network: it’s directly accessing the RAM of the database itself. This is great in a single node, but if you still want more (because who doesn’t?) then install any number of nodes and load-balance reads across all of them. This means every CPU of every database server is available for parallel reads, each of which has direct access to the database RAM.

Simpler. This is because Bedrock is written for modern hardware with large SSD-backed RAID drives and generous RAM file caches, and thereby doesn’t mess with the zillion hacky tricks the other databases do to eke out high performance on largely obsolete hardware. This results in fewer esoteric knobs, and sane defaults that “just work”.

More reliable. This is because Bedrock’s synchronization engine supports active/active distributed transactions with automatic failover, and can be clustered not just inside a single datacenter, but across multiple datacenters spanning the internet. This means Bedrock continues functioning not only if a single node goes down, but even if you lose an entire datacenter. After all, it doesn’t matter who you are using: your datacenter will fail, eventually. But you needn’t fail along with it.

More powerful. Most people don’t realize just how powerful SQLite is. Indexes, triggers, foreign key constraints, native JSON support, expression indexes – check the full list here. You’ll be amazed, but that’s just the start. On top of this Bedrock layers a robust plugin system, and includes a fully functional job queue and replicated cache – all the basics you need for modern service design, wrapped into one simple package.

Bedrock is not only production ready, but actively used by Expensify’s many thousands of customers, and millions of users. (Curious why an expense reporting company built their own database? Read what the First Round Review has to say about it.)

How to get it

Bedrock can be compiled from source using the Expensify/Bedrock public repo, or installed with the commands below:

Ubuntu Linux

You can build from scratch as follows:

# Clone out this repo: git clone https://github.com/Expensify/Bedrock.git # Install some dependencies sudo add-apt-repository ppa:ubuntu-toolchain-r/test sudo apt-get update sudo apt-get install gcc-9 g++-9 libpcre++-dev zlib1g-dev # Build it cd Bedrock make # Create an empty database (See: https://github.com/Expensify/Bedrock/issues/489) touch bedrock.db # Run it (press Ctrl^C to quit, or use -fork to make it run in the backgroud) ./bedrock # Connect to it in a different terminal using netcat nc localhost 8888 # Type "Status" and then enter twice to verify it's working # See here to use the default DB plugin: http://bedrockdb.com/db.html

Or you can install an older binary by copy/pasting this whole section into your terminal:

# Add the Bedrock repo to apt sources for your distro: sudo wget -O /etc/apt/sources.list.d/bedrock.list https://apt.bedrockdb.com/ubuntu/dists/$(lsb_release -cs)/bedrock.list # Add the Bedrock repo key: wget -O - https://apt.bedrockdb.com/bedrock.gpg | sudo apt-key add - # Update the apt-get and install Bedrock sudo apt-get update sudo apt-get install bedrock

Arch Linux

Copy/paste this command into your terminal:

yaourt -S bedrock

This will tansparently download the latest version from GitHub, compile it, package it up, and install it.

MacOSX

You can build from scratch as follows:

# Clone out this repo: git clone https://github.com/Expensify/Bedrock.git # Install some dependencies with Brew (see: https://brew.sh/) brew update brew install gcc@6 # Configure PCRE to use C++17 and compile from source brew uninstall --ignore-dependencies pcre brew edit pcre # Add these to the end of the `system "./configure"` command: # "--enable-cpp", # "--enable-pcre64", # "CXX=/usr/local/bin/g++-9", # "CXXFLAGS=--std=gnu++14" brew install --build-from-source pcre # Build it cd Bedrock make # Create an empty database (See: https://github.com/Expensify/Bedrock/issues/489) touch bedrock.db # Run it (press Ctrl^C to quit, or use -fork to make it run in the backgroud) ./bedrock # Connect to it in a different terminal using netcat nc localhost 8888 # Type "Status" and then enter twice to verify it's working # See here to use the default DB plugin: http://bedrockdb.com/db.html

How to use it

Bedrock is so easy to use, you’ll think you’re missing something. Once installed, Bedrock listens on localhost port 8888, and stores its database in /var/lib/bedrock . The easiest way to talk with Bedrock is using netcat as follows:

$ nc localhost 8888 Query: SELECT 1 AS foo, 2 AS bar;

That query can be any SQLite-compatible query – including schema changes, foreign key constraints, partial indexes, native JSON expressions, or any of the tremendous amount of functionality SQLite offers. The result will be returned in an HTTP-like response format:

200 OK Content-Length: 16 foo | bar 1 | 2

By default, Bedrock optimizes the output for human consumption. If you are a robot, request JSON output:

$ nc localhost 8888 Query query: SELECT 1 AS foo, 2 AS bar; format: json 200 OK Content-Length: 40 {"headers":["foo","bar"],"rows":[[1,2]]}

Some people are creeped out by sockets, and prefer tools. No problem: Bedrock supports the MySQL protocol, meaning you can continue using whatever MySQL client you prefer:

$ mysql -h 127.0.0.1 Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 1 Server version: bedrock 09b08f82e6eefe69f79bb8414882dd64182e3e8c Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. mysql> SELECT 1 AS foo, 2 AS bar; +------+------+ | foo | bar | +------+------+ | 1 | 2 | +------+------+ 1 row in set (0.01 sec) mysql>

That also means you can continue using whatever MySQL language binding you already know and love. Alternatively, if you don’t know or love any of them, Bedrock also provides a PHP binding that looks something like this:

$bedrock = new Bedrock(); $result = $bedrock->db->query("SELECT 1 AS foo, 2 AS bar;");

It really can be that easy.

Bedrock plugins

Additionally, Bedrock::DB is just one plugin to the overall Bedrock platform. Bedrock itself is less a database, and more a tool that can be used to build a wide variety of data-management applications – with a database being just one example. Each “plugin” implements and exposes new externally-visible commands (essentially equivalent to “stored procedures”). However, unlike simple stored procedures, plugins can also include schema changes. Plugins can be enabled via the “-plugins” command line parameter. Current plugins include:

Status - Provides basic status about the health the Bedrock cluster.

DB - Provides direct SQL access to the underlying database.

Jobs - Provides a simple job queue.

Cache - Provides a simple replicated cache.

MySQL - Emulates MySQL

How to help and get helped

So many ways!