Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dolthub/read-replication-demo
https://github.com/dolthub/read-replication-demo
Last synced: 3 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/dolthub/read-replication-demo
- Owner: dolthub
- Created: 2021-10-08T00:13:18.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-05-24T18:56:14.000Z (over 2 years ago)
- Last Synced: 2024-11-08T08:32:31.640Z (about 2 months ago)
- Language: Shell
- Size: 9.77 KB
- Stars: 1
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Read Replication Demo
This is a docker-compose setup to test Dolt read replication.
The blog post detailing this tutorial will be release Oct 20th 2021:
https://www.dolthub.com/blog/2021-10-20-read-replication/
## Outline:
- [Configuration](#configuration)
- [Setup](#setup)
- [Usage](#usage)
## Configuration
Leader pushes to replication remote on Dolt commit:
```
$ dolt config --local --add DOLT_REPLICATE_TO_REMOTE docker_origin
Config successfully updated.
```
Follower reads from common remote before every SQL transaction:
```
$ dolt config --local --add DOLT_READ_REPLICA_REMOTE docker_origin
Config successfully updated.
```
## Setup
Install Dolt:
```
$ sudo bash -c 'curl -L https://github.com/dolthub/dolt/releases/latest/download/install.sh | sudo bash'
```
Configure user info:
```
$ dolt config --local --add user.name "Max Hoffman"
$ dolt config --local --add user.email "[email protected]"
```
Initialize dbs:
```
$ ./reset_dbs.sh
```
Run `docker-compose.yml`:
```
$ docker-compose up
```
## Usage
Commit data to the leader:
```
$ mysql --user root --host=0.0.0.0 -P 3308 leader
mysql> create table t1 (a int primary key);
Empty set (0.09 sec)
mysql> select dolt_commit('-am', 'cm');
+----------------------------------+
| dolt_commit('-am', 'cm') |
+----------------------------------+
| 0qoslhbbfqcerrfg8osf08qi8iapjp70 |
+----------------------------------+
1 row in set (0.26 sec)
```
Read data from follower:
```
$ mysql --user root --host=0.0.0.0 -P 3307 follower
mysql> show tables:
+-------+
| Table |
+-------+
| t1 |
+-------+
1 row in set (0.05 sec)
```