aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorAndrey Fomichev <andrey.fomichev@gmail.com>2022-04-18 13:11:58 +0300
committerAndrey Fomichev <andrey.fomichev@gmail.com>2022-04-18 13:11:58 +0300
commit6f5965b134a068aa9f1f889485b3b3929eee52b8 (patch)
tree888a84c391afa78a1c356ec4466a004092f499e2 /README.md
parentd4be68e361f4258cf0848fc70018dfe37a2acc24 (diff)
downloadydb-6f5965b134a068aa9f1f889485b3b3929eee52b8.tar.gz
improve readme (KIKIMR-12267)
ref:228468abb6d0d64bdd9bb30ec7d4ba41ccd83df0
Diffstat (limited to 'README.md')
-rw-r--r--README.md41
1 files changed, 21 insertions, 20 deletions
diff --git a/README.md b/README.md
index 68c3c0e86b..f24adb3080 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
[![PyPI version](https://badge.fury.io/py/ydb.svg)](https://badge.fury.io/py/ydb)
[![Telegram](https://img.shields.io/badge/chat-on%20Telegram-2ba2d9.svg)](https://t.me/yandexdatabase_ru)
-## YDB Platform
+## YDB
[Website](https://ydb.tech) |
[Documentation](https://ydb.tech/docs) |
@@ -19,7 +19,7 @@ YDB is an open-source Distributed SQL Database that combines high availability a
## Main YDB Advantages
-YDB was designed from scratch as a response to growing demand for scalable interactive web services. Scalability, strict consistency and effective cross-row transactions were a must for such OLTP-like workload. YDB was built by people with strong background in databases and distributed systems, who had an experience of developing No-SQL database and the Map-Reduce system for one of the largest search engines in the world.
+YDB is designed from scratch as a response to growing demand for scalable interactive web services. Scalability, strict consistency and effective cross-row transactions were a must for such OLTP-like workload. YDB is built by people with strong background in databases and distributed systems, who had an experience of developing No-SQL database and the Map-Reduce system for one of the largest search engines in the world.
We found that YDB's flexible design allows us to build more services on top of it including persistent queues and virtual block devices.
Basic YDB features:
@@ -30,35 +30,36 @@ Basic YDB features:
- SQL dialect (YQL) for data manipulation and scheme definition;
- ACID transactions across multiple nodes and tables with strict consistency.
-### Fault-tolerant configurations
+### Fault-tolerant Configurations
-YDB could be deployed in three availability zones. Cluster remains available for both reads and writes during complete outage of a single zone.
+YDB could be deployed in three availability zones. Cluster remains available for both reads and writes during complete outage of a single zone. Availability zones and regions are covered in more detail [in documentation](https://ydb.tech/en/docs/concepts/databases#regions-az).
-Availability zones and regions are covered in more detail [in documentation](https://ydb.tech/en/docs/concepts/databases#regions-az).
+### Horizontal Scalability
-### Horizontal scalability
+Unlike traditional relational databases YDB [scales out](https://en.wikipedia.org/wiki/Scalability#Horizontal_or_scale_out) providing developers with capability to simply extend cluster with computation or storage resources to handle increasing load. YDB has desaggregated storage and compute layers which allow you to scale storage and compute resources independently.
-Unlike traditional relational databases YDB [scales out](https://en.wikipedia.org/wiki/Scalability#Horizontal_or_scale_out) providing developers with capability to simply extend cluster with computation or storage resources to handle increasing load.
+Current production installations have more than 10,000 nodes, store petabytes of data and handle millions distributed transactions per second.
-Current production installations have more than 10,000 nodes, store petabytes of data and handle more than 100,000 distributed transactions per second.
+### Automatic Disaster Recovery
-### Automatic disaster recovery
+YDB has built-in automatic recovery support to survive a hardware failure. After unpredictable disk, node, rack or even datacenter failure YDB remains fully available for reads and writes and restores required data redundancy automatically.
-YDB Platform has built-in automatic recovery support to survive a hardware failure. After unpredictable disk, node, rack or even datacenter failure YDB platform remains fully available for reads and writes and restores required data redundancy automatically.
+### Multitenant and Serverless Database
+YDB has support for multitenant and serverless setups. A user can run a YDB cluster and create several databases that share one pool of storage and have different compute nodes. Alternatively a user can run several serverless databases that share one pool of compute resources to utilize them effectively.
-## Supported platforms
+## Supported Platforms
### Minimal system requirements
YDB runs on x86 64bit platforms with minimum 8 GB of RAM.
-### Operating systems
+### Operating Systems
We have major experience running production systems on 64-bit x86 machines working under Ubuntu Linux.
For development purposes we test that YDB could be built and run under latest versions of MacOS and Microsoft Windows on a regular basis.
-## Getting started
+## Getting Started
1. Install YDB using [pre-built executables](https://ydb.tech/en/docs/getting_started/self_hosted/ydb_local), [build it from source](BUILD.md) or [use Docker container](https://ydb.tech/en/docs/getting_started/self_hosted/ydb_docker).
1. Install [command line interace](https://ydb.tech/en/docs/getting_started/cli) tool to work with scheme and run queries.
@@ -68,24 +69,24 @@ For development purposes we test that YDB could be built and run under latest ve
1. Develop an application using [YDB SDK](https://ydb.tech/en/docs/reference/ydb-sdk/).
-## How to build
-* Build ydb and ydbd binaries [from source](BUILD.md).
+## How to Build from Source Code
+* Build server (ydbd) and client (ydb) binaries [from source code](BUILD.md).
-## How to deploy
+## How to Deploy
* Deploy a cluster [using Kubernetes](https://ydb.tech/en/docs/deploy/orchestrated/concepts).
* Deploy a cluster using [pre-built executables](https://ydb.tech/en/docs/getting_started/self_hosted/ydb_local).
-## How to contribute
+## How to Contribute
We are glad to welcome new contributors!
1. Please read [contributor's guide](CONTRIBUTING).
-2. We can accept your work to YDB Platform after you have read contributor's license agreement (aka CLA).
+2. We can accept your work to YDB after you have read contributor's license agreement (aka CLA).
3. Please don't forget to add a note to your pull request, that you agree to the terms of the CLA.
More information can be found in [CONTRIBUTING](CONTRIBUTING) file.
-## Success stories
+## Success Stories
-See YDB Platform [official web site](https://ydb.tech/) for the latest success stories and projects using YDB Platform.
+Take a look at YDB [web site](https://ydb.tech/) for the latest success stories and user scenarios.