1
0
Fork 0
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Grigorii Safronov a5577f8619 Изменил(а) на 'cmd/rqlited/main.go' 5 months ago
.circleci Make it easier to follow CircleCI testing 8 months ago
.github/ISSUE_TEMPLATE Update bug_report.md 8 months ago
DOC Delete obsolete documentation 7 months ago
auth Update unit tests 9 months ago
auto Actually fix it 7 months ago
aws aws: reuse session and S3 manager 8 months ago
cluster Formatting 7 months ago
cmd Изменил(а) на 'cmd/rqlited/main.go' 5 months ago
command Add optional freshness_strict 7 months ago
db Fix test 7 months ago
disco Push in read-only status 9 months ago
http Update service.go 7 months ago
log Remove use of deprecated ioutil 8 months ago
progress Log at DB level if open times are higher 9 months ago
queue Working 9 months ago
random Minor improvements to random module 8 months ago
rtls Remove unused joint TLS config creation 9 months ago
scripts Удалить 'scripts/gofmt.sh' 7 months ago
snapshot Always close the Snaphot 8 months ago
store Init open 7 months ago
system_test Use "sync" instead of "commit" 7 months ago
tcp Remove unused joint TLS config creation 9 months ago
testdata Move to example.com cert and key 9 months ago
.gitignore Add initial skeleton of WAL Compactor 1 year ago
CHANGELOG.md Update CHANGELOG.md 7 months ago
CONTRIBUTING.md Update CONTRIBUTING.md 2 years ago
LICENSE Update LICENSE year 9 months ago
Logo.png Загрузил(а) файлы в '' 7 months ago
README.md Изменил(а) на 'README.md' 5 months ago
Vagrantfile Add node ID 2 years ago
appveyor.yml Update appveyor.yml 7 months ago
doc.go Update doc.go 2 years ago
go.mod go mod updates 7 months ago
go.sum go mod updates 7 months ago
vagrant_setup.sh Fix Vagrant set up file 8 months ago

README.md

fluidB

Multimodel distributed in memory database management system


Table of Contents

  1. About The Project
  2. Getting Started
  3. Gratitudes
  4. Features
  5. Requirements
  6. Cases
  7. Cluster
  8. Troubles
  9. Contributing
  10. License
  11. FAQ
  12. Roadmap
  13. Contact

About The Project

fluidB is Multimodel in-memory database management system an easy-to-use. It's lightweight, distributed which uses SQLite as its storage engine for small datasests.

fluidB is simple to deploy, operating it is very straightforward, and its clustering capabilities provide you with fault-tolerance and high-availability. [fluidB is available only for Unix-like systems only]. fluidB uses Raft to achieve consensus across all the instances of the SQLite databases, ensuring that every change made to the system is made to a quorum of SQLite databases, or none at all. fluidB gives you the functionality of a rock solid, fault-tolerant, replicated relational database, but with very easy installation, deployment, and operation. With it you've got a lightweight and reliable distributed relational data store. Think etcd or Consul, but with relational data modelling also available. You could use fluidB as part of a larger system, as a central store for some critical relational data, without having to run larger, more complex distributed databases.

Finally, if you're interested in understanding how distributed systems actually work, fluidB is a good example to study. Much thought has gone into its and implementation, with clear separation between the various components, including storage, distributed consensus, and API.

Key features

  • Trivially easy to deploy, with no need to separately install SQLite.
  • Super-simple to use, with a straightforward HTTP API (https://fluidB.io/docs/api/). A command-line interface is also available, as are various client libraries.
  • Fully replicated production-grade SQL database, with full access to SQLite full-text search and JSON document support
  • Multiple options for node-discovery and automatic clustering, including integration with Kubernetes, Consul, etcd and DNS, allowing clusters to be dynamically created.
  • Extensive security and encryption support , including node-to-node encryption.
  • Choice of read consistency levels, and support for choosing [write performance over durability
  • Optional read-only (non-voting) nodes, which can add read scalability to the system.
  • A form of transaction support.
  • Hot backups, as well as [load directly from SQLite https://fluidB.io/docs/guides/restore/.

Gratitudes

  • Philip O' Toole, I wish to express my appreciation for all your efforts!!!

Requirements

  • Hardware: Intel or AMD
  • Processor: 64-bit
  • RAM: 1 GB or higher
  • Nodes: 5 (strongly recomended)
  • Operating System: UNIX-like only (Linux, BSD(except OpenBSD), MacOS X) Windows isn't supported

Cases

  • Logs ageregation
  • Caching system
  • Queue server
  • Pattern "Central dispatcher" (for sharding)
  • Solution that sits in front of multiple data sources and allow them to be treated as a single json database
  • Web-server and database for hosting static web-sites

Getting Started

Basic modeles

fluidB The project consists of two main modules:

  1. relational- relational model
  2. temporal- temporal model

Building

  1. Install Golang 19.4 or higher build-essential in your operating system

  2. Clone the fluidb-repo

    git clone https://source.fluidb.icu/fluidB/fluidb
    
    
    
  3. Change folder and running compilation

 cd fluidb && go install ./...
  1. Change directory
cd .. go/bin/
  1. Configuration fluidB
chmod +x fconf.sh && ./fconf.sh
  1. Running server fluidb
  ./fluidbd ~/node.1

fluidB is Multimodel in-memory database management system an easy-to-use. It's lightweight, distributed which uses SQLite as its storage engine for small datasests and futrum which uses Riak for large datasests.

fluidB is simple to deploy, operating it is very straightforward, and its clustering capabilities provide you with fault-tolerance and high-availability. [fluidB is available only for Unix-like systems only]. fluidB uses Raft to achieve consensus across all the instances of the SQLite databases, ensuring that every change made to the system is made to a quorum of SQLite databases, or none at all. fluidB gives you the functionality of a rock solid, fault-tolerant, replicated relational database, but with very easy installation, deployment, and operation. With it you've got a lightweight and reliable distributed relational data store. Think etcd or Consul, but with relational data modelling also available. You could use fluidB as part of a larger system, as a central store for some critical relational data, without having to run larger, more complex distributed databases.

Finally, if you're interested in understanding how distributed systems actually work, fluidB is a good example to study. Much thought has gone into its and implementation, with clear separation between the various components, including storage, distributed consensus, and API. Key features

Trivially easy to deploy, with no need to separately install SQLite.
Super-simple to use, with a straightforward HTTP API (https://fluidB.io/docs/api/). A command-line interface is also available, as are various client libraries.
Fully replicated production-grade SQL database, with full access to SQLite full-text search and JSON document support
Multiple options for node-discovery and automatic clustering, including integration with Kubernetes, Consul, etcd and DNS, allowing clusters to be dynamically created.
Extensive security and encryption support , including node-to-node encryption.
Choice of read consistency levels, and support for choosing [write performance over durability
Optional read-only (non-voting) nodes, which can add read scalability to the system.
A form of transaction support.
Hot backups, as well as [load directly from SQLite https://fluidB.io/docs/guides/restore/.

Troubles

Support transactions

It supports a form of transactions. You can wrap a bulk update in a transaction such that all the statements in the bulk request will succeed, or none of them will. However the behaviour or rqlite is undefined if you send explicit BEGIN, COMMIT, or ROLLBACK statements. This is not because they wont work they will but if your node (or cluster) fails while a transaction is in progress, the system may be left in a hard-to-use state. So until rqlite can offer strict guarantees about its behaviour if it fails during a transaction, using BEGIN, COMMIT, and ROLLBACK is officially unsupported. Unfortunately this does mean that rqlite may not be suitable for some applications.

This single node automatically becomes the leader. You can pass -h to fluidBd to list all configuration options.

Installation

For Linux-systems you can install fluidB automaticly using installation script from our site:

Installation Script for Debian-based systems
Installation Script for Red-Hat-based systems
Installation Script for Arch-based systems

  1. Open the link above
  2. Download the script
  3. Copy the tar-archive in your home directory
  4. Open you terminal and then print (-terminal prompt) ``` chmod +x install.sh && ./install.sh```
  5. Wait for the installation process to complete, after installation the application will start automatically

Start working with fluidB

To begin with, let's check that fluidB is running at all:

$ clif
127.0.0.1:4001> CREATE TABLE foo (id INTEGER NOT NULL PRIMARY KEY, name TEXT)
0 row affected (0.000668 sec)
127.0.0.1:4001> .schema
+-----------------------------------------------------------------------------+
| sql                                                                         |
+-----------------------------------------------------------------------------+
| CREATE TABLE foo (id INTEGER NOT NULL PRIMARY KEY, name TEXT)               |
+-----------------------------------------------------------------------------+
127.0.0.1:4001> INSERT INTO foo(name) VALUES("fiona")
1 row affected (0.000080 sec)
127.0.0.1:4001> SELECT * FROM foo
+----+-------+
| id | name  |
+----+-------+
| 1  | fiona |
+----+-------+

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the BSD 3 License. See LICENSE for more information.

FAQ

This page provides answers to frequently asked questions regarding fluidB


  • What is the main idea of your project? The key idea of our product is that it solves the problems of processing, storing and analyzing a large amount of continuously incoming data, mainly geolocation data. It is intended primarily for application software developers and DBAs (Database Administrators). Our main goal is to provide the user with a simple yet flexible and functional tool for working with data.

  • How is your project different from sqlite?

When developing our product, we took sqlite as a basis, as an improved version of the sqlite, easy and understandable to learn and operate. The difference between fluidB and KeyDB lies in the implementation of bash-installation scripts and raft-algorithm supporting.


  • What is the multi-model database management system? A multi-model subdivision is such a subdivision that allows you to store data using different data storage schemes. For example, along with relational data (stored in the form of tables), data can be stored in the form of associative array, etc. Thus, incredible flexibility in storing data is achieved, depending on the type of data, the most suitable tool for storing and processing it is used.

  • Is there a fluidB implementation for the Windows operating system? No, there is no implementation of FluidB for the Windows operating system. our application is client-server, with on-board caching subdivision, focused on use mainly on servers, and the vast majority of servers run under the Linux operating system. We do not plan to release a version for Windows in the future.

  • Is fluidB in Linux repositories?

    No, FluidB is still distributed as source.

  • Is there a docker image of the project? No, there is no docker image, because docker, like any virtualization environment, forms an additional layer of abstraction, which complicates both the development process itself and the program operation process. Our goal: "To create a high-performance subassembly that is as easy to use as possible"

  • Why are you confident that you will be able to create a high-quality, competitive software product that people need?

For several reasons. First, because our product is based on the well-proven Redis DBMS. Secondly, our software product is already used as a backend in the ws-stickleback project "Biology and Soil" of the Faculty of the Department of Ichthyology and Hydrobiology, St. Petersburg State University


  • Is there a paid version of your software product with advanced functionality?

There is such a version, it is calledEnterprise-version, this version includes both the functionality required by the client (discussed individually with each client) and the default functionality.


  • How is authorization used?

In the traditional sense, there is no authorization. We have a funny login form that we wrote to show how you can quickly implement it using JavaScript, it is used by default in our fluwc web interface, where you can make "typical requests" in the browser. FluidB is not intended to be publicly displayed. This is an application that works on the Internet, so we do not have authorization at this stage.


  • How does your product name stand for?

The name of our project is deciphered as follows: FluidB, this is a reference to the English word "fluid", which means "fluid" - a physical term meaning "a state of matter with parameters above critical", which very accurately characterizes our product. A critical state of a substance means a state in which it disappears the difference between its liquid and vapor phases. This is illustrated by the colors of the logo: At first, there is no load on the application (blue Greek letter "Phi"), then it increases sharply (three red subsequent letters), then the load begins to decrease and evenly distribute- orange symbol, differential, showing the rate of change of the value of the variable during balancing, and finally it is evenly distributed and becomes normal (seventh blue symbol). In our case, it should be interpreted as follows: thanks to our product, the line between low loads and very high loads is erased, i.e. to. it helps balance the load. A couple of words should be said separately about the symbol of the "flower" standing in front of the inscription: It personifies the mathematical graph of objects, tk. our subd is a multi-model supporting graph data storage model.


  • I have decided to purchase the Enterprise version of your product, where should I contact?

You shoud write the letter in email: gvsafronov@gmail.com

Roadmap

  • Raft implementation for core databases (fluidB-engine)
  • Improve installation scripts
  • Improve futrum installation script
  • Research riak and improve it as a database-engine (futrum) for big datasets
  • Develop application-engine for fuidB
  • Develop hash-sharding
  • Rewrite temporal model

Cluster

While not strictly necessary to run fluidB, running multiple nodes means you'll have a fault-tolerant cluster. Start two more nodes, allowing the cluster to tolerate failure of a single node, like so:
```bash
fluidBd -node-id 2 -http-addr localhost:4003 -raft-addr localhost:4004 -join http://localhost:4001 ~/node.2
fluidBd -node-id 3 -http-addr localhost:4005 -raft-addr localhost:4006 -join http://localhost:4001 ~/node.3

This demonstration shows all 3 nodes running on the same host. In reality you probably wouldn't do this, and then you wouldn't need to select different -http-addr and -raft-addr ports for each fluidB node.

With just these few steps you've now got a fault-tolerant, distributed relational database. For full details on creating and managing real clusters, including running read-only nodes, check out this documentation.

Contact

Grigoriy Safronov - gvsafronov@yandex.ru

Project Link: https://fluidb.icu