From 6979103437648593a3dd7ba140740dbaf1814e2e Mon Sep 17 00:00:00 2001
From: "a.tolstoy" <a.tolstoy@picodata.io>
Date: Tue, 25 Jul 2023 12:48:19 +0300
Subject: [PATCH] sync glossary with the docs version

---
 docs/cluster_group.svg | Bin 0 -> 139926 bytes
 docs/glossary.md       | 249 +++++++++++++++++++++++++++++++++++++----
 2 files changed, 230 insertions(+), 19 deletions(-)
 create mode 100644 docs/cluster_group.svg

diff --git a/docs/cluster_group.svg b/docs/cluster_group.svg
new file mode 100644
index 0000000000000000000000000000000000000000..00260c54cbcbeaf872454104e59a5c74008f1fe8
GIT binary patch
literal 139926
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
Y645CZ%8-;*{`33KK7RMjAAa}$03wUu-~a#s

literal 0
HcmV?d00001

diff --git a/docs/glossary.md b/docs/glossary.md
index 3343d9519d..f26b56d36f 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -1,37 +1,248 @@
 # Глоссарий
 ## Общие сведения
-Данный документ содержит список терминов и их определений для основных программных компонентов и понятий, которые используются в Picodata. У глоссария две простые цели:
+Данный раздел содержит описание основных терминов, используемых в Picodata.
 
-- Дать точное и непротиворечивое определение каждому термину применительно к его использованию в Picodata.
-- Обеспечить единообразие терминологии во внутренних документах (комментарии в коде, readme и прочие Markdown-документы в наших репозиториях).
+## Подсистемы
+### Raft
+**Raft** является алгоритмом распределенного консенсуса, который нужен, чтобы несколько участников могли совместно решить, произошло ли событие или нет, и что за чем следовало. Raft используется в Picodata для согласования работы узлов и поддержания консистентности в кластере. Концепция распределенного консенсуса предполагает, что в кластере всегда есть только один лидер и некоторое количество голосующих узлов. Эти узлы в нормальном состоянии подтверждают легитимность лидера, а при отказе текущего лидера организуют выборы нового.
+См. [подробнее](https://raft.github.io/raft.pdf).
 
-Список ниже будет дополняться и исправляться в течение времени.
+### Терм (term)
+Период между выборами лидера в raft-группе называется **термом** (term). Каждый терм начинается в момент объявления выборов нового лидера. Обычно это происходит после потери связи с прежним лидером. Терм состоит из двух частей: выборов и периода нормальной работы raft-группы. Исключением служат термы, в течение которых не удалось выбрать лидера группы: у таких термов есть только первая часть (выборы).
+Важно помнить, что в одном терме не может существовать более одного лидера raft-группы.
 
-## Список терминов и определений
-**Инстанс** — программный узел, входящий в состав кластера. Каждый инстанс является экземпляром приложения Picodata, а также репликой в составе репликасета. Среда выполнения приложения может быть как виртуальной, так и физической.
+### Состояния узлов в Raft-группе <a name="raft-group"></a>
+В raft-группе любой узел может быть в одном из трех состояний:
 
-**Кластер** — набор программных узлов, составляющих отдельную группу.
+**Пассивный узел (follower)** — состояние по умолчанию для каждого инстанса после запуска. Follower — обычный голосующий узел, который лишь отвечает на запросы, но не генерирует их.
 
-**Raft** — алгоритм синхронной репликации, обеспечивающий целостность кластера (raft-группы). Raft отвечает за автоматический выбор лидера raft-группы (лидер может меняться). В raft-группе есть лидер, а остальные узлы называются follower’ами.
+**Кандидат в лидеры (candidate)** — состояние инстанса во время выборов лидера. Когда начинается новый терм, инстансы в статусе follower увеличивают значение терма и переходят в статус кандидатов, голосуют сами за себя и затем ждут результатов выбора. Выходов из этого состояния три: 
 
-**Отказоустойчивость** — повышение надежности данных с помощью репликации.
+- Кандидат побеждает в выборах и становится лидером.
+- Кандидат возвращается в статус follower, так как другой инстанс становится лидером.
+- Кандидат остается кандидатом, так как не удается выбрать лидера. Raft увеличивает терм еще раз и организует повторные выборы.
 
-**Репликация** — создание и поддержание в актуальном состоянии резервных копий инстансов.
+**Лидер raft-группы (leader)** — избранный узел, который отвечает за обработку запросов и репликацию raft-журнала.
 
-**Фактор репликации** — число инстансов в репликасете.
+### Raft-лидер	
+**Лидер в raft-группе** — это один из узлов, который несет ответственность за репликацию raft-журнала. Лидер избирается на голосовании и признается таковым всеми участниками голосования. Задача лидера состоит в приеме сообщений от клиентов кластера и отправке сообщений на узлы кластера таким образом, чтобы в любой момент времени все узлы имели консистентную, непротиворечивую версию raft-журнала. Лидерство в Raft предполагает, что все остальные узлы признают приоритет версии журнала, предлагаемую лидером.
 
-**Репликасет** — буквально «набор реплик», экземпляров приложений, в которых хранится один и тот же набор реплицированных данных. В зависимости от роли реплик, в Picodata есть реплики _active (RW)_ и _standby (RO)_. 
+Если лидер становится недоступным, то алгоритм Raft организует выборы нового лидера среди оставшихся участников. Если после этих выборов прежний лидер снова присоединится к кластеру, он уже будет иметь права обычного голосующего узла (но не лидера).
 
-**Failure domain** — букв. _"домен отказа"_. Термин обозначает зону доступности инстанса Picodata, т.е. признак физического размещения сервера, на котором запущен инстанс (географический регион, датацентр, стойка и т.д.). Зона доступности используется для того чтобы в один репликасет по возможности попадали инстансы с разным размещением, повышая таким образом отказоустойчивость как отдельного репликасета, так и кластера в целом.
+### Репликация raft-журнала
+**Репликация raft-журнала** нужна для того, чтобы на каждом узле кластера (raft-группы) была одинаковая история команд. Когда лидеру группы нужно добавить в журнал новую команду, он сначала отправляет ее всем узлам, ждет подтверждения записи (commit), и лишь затем добавляет эту команду в собственный журнал. В случае, если журнал обычного узла отличается от журнала лидера, то лидер настаивает на приоритете своего журнала и перезаписывает журнал обычного узла, считая его устаревшим.
+Для упрощения репликации алгоритм Raft придерживается двух правил при сравнении журналов разных узлов:
 
-**Bucket** (бакет) — виртуальная неделимая единица хранения данных, обеспечивающая локальность данных (т. е. их нахождение на каком-то одном репликасете).
+- Если записи имеют одинаковые индексы и термы, то они содержат одинаковые команды.
+- Если записи имеют одинаковые индексы и термы, то считается, что все предыдущие записи соответствующих журналов одинаковы.
 
-**Горизонтальное масштабирование** — шардинг, т.е. распределение bucket'ов между различными репликасетами, находящихся на разных серверах. Каждый такое репликасет называется шардом.
+Так как а) записи в журнале не могут менять порядок и б) каждой записи соответствует только один индекс и терм, то указанные выше правила гарантирует консистентность журнала.
 
-**Discovery** — алгоритм взаимного обнаружения инстансами друг друга во время объединения в кластер.
 
-**Space** (спейс) — пространство хранения данных в СУБД. В резидентных СУБД спейс является синонимом _таблицы_ из реляционных СУБД.
 
-**Grade** (грейд) — специфичный для Picodata способ обозначения состояния инстанса. Грейд отражает то, как инстанс сконфигурирован его соседями. Существуют _текущий_ (current) и _целевой_ (target) типы грейдов. За приведение первого ко второму отвечает _governor_ (губернатор).
+### Web UI
+**Веб-консоль** — это вариант графического интерфейса к функциям Picodata. Данная подсистема находится в разработке и будет представлена в следующем релизе Picodata. Веб-консоль в наглядном виде отображает и позволяет менять конфигурацию и состав кластера, параметры отдельных узлов, схему данных и т.д. Веб-консоль является удобным инструментов локального и удаленного администрирования Picodata.
+
+### CLI (Command-line interface)
+**CLI** — это интерфейс командной строки для запуска и управления как отдельными инстансами, так и всем кластером Picodata.
+
+### Дискавери (discovery)
+**Discovery** —  алгоритм, по которому инстансы обнаруживают друг друга. Этот шаг необходим на старте каждого инстанса для корректной работы кластера.
+
+### Vshard
+**Vshard** — библиотека из экосистемы СУБД Tarantool, используемая в Picodata для горизонтального масштабирования — сегментирования данных по нескольким узлам в кластере. Это становится важным по мере увеличения объема хранимых данных, ввода в строй новых узлов — т.е. роста кластера.
+Библиотека Vshard встроена в Picodata и является неотъемлемой ее частью. 
+В клиентских интерфейсах Vshard желательно прятать за фасадом, но при острой необходимости ничто не помешает им воспользоваться.
+
+## Сущности
+В начале идет общее обозначение термина, затем в скобках указан предпочтительный вариант употребления в коде (без пробелов в “змеином регистре”). 
+
+### Инстанс (instance) <a name="instance"></a>
+**Обозначение единицы кластера СУБД и сервера приложений**
+При описании кластера мы различаем программный и логический уровни.
+
+На программном уровне единицей кластера является экземпляр приложения Picodata, также на техническом жаргоне называемый инстансом. Среда выполнения приложения может быть как виртуальной, так и физической. В разрезе операционных систем каждый инстанс порождает два процесса: собственно экземпляр приложения и вспомогательный процесс (supervisor), управляющий жизненным циклом первого. 
+
+На логическом уровне единицей кластера является узел. Под узлом, в зависимости от контекста, может пониматься как отдельная вычислительная единица, обладающая пулом ресурсов (физический сервер, виртуальная машина, контейнер), так и программный экземпляр Picodata, уже входящий в состав кластера.
+
+Также инстанс является репликой в составе репликасета и может входить в указанную при его запуске группу инстансов.
+
+### Кластер (cluster) <a name="cluster"></a>
+**Кластер** — набор логических и программных узлов, составляющих отдельную централизованно управляемую группу с общим пространством хранения.
+
+**Кластер** является наиболее крупной сущностью в системе хранения, в некотором смысле он и есть система хранения. Внутри кластера находятся инстансы, объединенные в репликасеты (см. ниже). Дополнительно, в Picodata используется понятие групп инстансов — отдельного способа более гибко управлять большим числом инстансов в зависимости от их ролей, характера нагрузки и топологии сети.
+
+Схематичное представление кластера, в составе которого есть некоторое число инстансов, репликасетов и групп инстансов, показано ниже.<a name="cluster_group"></a>
+
+![Cluster](cluster_group.svg)
+
+### Репликасет (replicaset) <a name="replicaset"></a>
+**Репликасет** — буквально «набор реплик», экземпляров приложений, в которых хранится один и тот же набор данных. Реплика в составе репликасета может быть в одном из двух состояний:
+
+- активная (active) — доступная на запись, иногда ее называют мастером или лидером репликасета.
+- резервная (standby) — доступная только на чтение, read-only.
+В нормальных условиях в репликасете активной является ровно одна реплика, но в отдельных случаях их может быть несколько или не быть вообще.
+
+### Лидер (leader)
+<p name="leader">В Picodata есть две разновидности лидеров:</p>
+
+- “raft-лидер” — лидер raft-группы,
+- и “репликасет-лидер” — лидер репликасета.
+
+Термин _лидер_ часто путают с _мастером_ применительно к репликации Tarantool. В Picodata они хоть и близки, но все же отличаются по смыслу. Под _мастером_ следует понимать инстанс, который выполняет пользовательские DML-операции (insert / update / delete). На практике чаще всего такой инстанс один, и в таком случае оба термина описывают один и тот же инстанс (отсюда и путаница), но в Tarantool архитектурно заложена возможность вести запись на нескольких узлах репликасета одновременно — т.н. режим мультимастера (multi-master). Даже в таком режиме операции DDL (`create_space` и т.д.) должен выполнять лишь один инстанс из всех, и здесь становится важно отличать _лидера_ от _мастера_. Несмотря на то, что в Picodata режим мультимастера пока не реализован, документация и код должны использовать эти термины корректно.
+
+### Группа инстансов (instance_group)
+**Группа инстансов** — это логическое объединение инстансов с общим фактором репликации и ролями. Каждая группа шардируется индивидуально.
+
+Концепция групп является аналогом [vshard_group](https://www.tarantool.io/ru/doc/latest/book/cartridge/cartridge_cli/commands/replicasets/#list-vshard-groups) из Cartridge, но дополнительно позволяет назначать роли группам (в Cartridge роли настраивались индивидуально для каждого репликасета). 
+
+**Группа инстансов** является более крупным образованием, чем репликасет. См пояснительную [картинку](glossary.md#cluster_group).
+
+Каждый шардированный спейс принадлежит одной конкретной инстанс-группе. На инстансах из других групп спейс физически не создается. Но т.к. схема данных является общей на весь кластер, создавать два спейса с одинаковым именем в разных группах не разрешается. Принадлежность инстанс-группе определяется только для шардированных спейсов, глобальные спейсы создаются повсюду.
+
+### Домен отказа (failure_domain)
+**Домен отказа** является признаком физического расположения сервера, на котором запущен инстанс. Указание домена отказа позволяет обозначить наличие единой точки отказа у двух инстансов. Смысл данного параметра состоит в том, чтобы в один репликасет попадали инстансы из разных физических локаций, что повышает отказоустойчивость кластера.
+
+**Домен отказа** представляет собой набор пар “ключ=значение”, которые соответствуют отдельным зонам (географический регион, датацентр, стойка и т.д.). Зоны задаются пользователем исходя из фактической конфигурации оборудования, будь то виртуальные машины в облаке (`“region=eu”`) или физические сервера (`“dc=msk”`). Домен отказа может включать несколько зон (`“dc=msk,srv=msk-1”`).
+
+Можно использовать любые ключи и значения. Picodata не делает предположений об иерархии зон или их физическом смысле и просто сравнивает строки. Тем не менее, чтобы избежать человеческих ошибок, Picodata требует, чтобы набор зон (ключей) на всех инстансах был одинаковым.
+
+Если домены отказа двух инстансов имеют хотя бы одну общую зону (и ключ, и значение), то допускается возможность одновременной потери связи с обоими. Поэтому инстансы, делящие общую зону, не будут объединены в репликасет. Picodata также стремится распределить голосующие raft-узлы таким образом, чтобы их домены отказа имели по минимуму общих зон.
+
+### Фактор репликации (replication_factor)
+**Фактор репликации** — число инстансов в репликасете. Задается общим на группу инстансов (так же как и набор ролей). Отредактировать фактор репликации, сохраненный в конфигурации кластера, можно командой `picodata set-replication-factor`. Редактирование конфигурации сказывается только на вновь добавляемых инстансах, но не затрагивает уже работающие.
+
+
+### Бакет (bucket) <a name="bucket"></a>
+**Bucket (бакет)** — виртуальная неделимая единица хранения данных, обеспечивающая их локальность (т. е. нахождение на каком-то одном репликасете).
+
+### Спейс (space)
+**Space (спейс)** — пространство хранения данных. В резидентных СУБД спейс является синонимом таблицы из реляционных СУБД. В Picodata есть следующие виды спейсов:
+
+1. Глобальные (_global_) — их содержимое реплицируется на весь кластер.
+2. Шардированные (_sharded_) — каждый репликасет хранит лишь часть общего
+   набора данных. Данные реплицируются внутри репликасета.
+
+Метаданные всех спейсов Picodata присутствуют на всех узлах кластера.
+Фактически для пользователя не существует понятия “не кластерных”
+спейсов, он лишь выбирает между стратегиями шардирования и репликации
+тех спейсов, с которыми он работает.
+
+### Индекс (index)
+**Индекс** — это специальная структура данных, которая хранит группу ключевых значений и указателей. Индекс строится по какому-либо одному столбцу таблицы и используется для эффективного поиска значений этого столбца. У каждого спейса обязательно должен быть первичный индекс и опционально некоторое число вторичных индексов. 
+
+### LSN (log sequence number)
+Термин **LSN** (log sequence number) относится к архитектурным особенностям Tarantool, в котором все обновления БД фиксируются в журнале упреждающей записи (WAL, write-ahead log) в виде отдельных записей. Каждая запись представляет собой запрос на изменение данных (`insert` | `update` | `delete`) и маркируется монотонно возрастающим номером LSN. Наибольший номер обозначает номер наиболее свежей записи, находящейся в конце журнала WAL. 
+
+### Vclock (vector clock)
+Репликация в Tarantool предполагает обмен записями между репликами в репликасете. Благодаря этому обмену, на каждой отдельной реплике имеется специальный набор записей, полученный от разных реплик с разными LSN — это и есть **Vclock** (vector clock, векторные часы). Vclock описывает состояние БД для отдельного инстанса в репликасете.
+
+Vclock репликасет-лидера играет важную роль в поддержании консистентности при переключении лидера (consistent switchover). В случае аварийного переключения (фейловера, failover), когда консистентность сохранить невозможно и она жертвуется в угоду доступности, отслеживание vclock позволяет строить метрики точек восстановления (RPO, recovery point objective).
+
+### Сетевой адрес (address) <a name="address"></a>
+**Сетевой адрес** — это комбинация `host:port`, используемая для связи инстансов друг с другом по сети. Другие названия для связки `host:port` (например URL, URI) мы стараемся искоренить. Расширенная версия `user:pass@host:port` все равно определяется термином _адрес_.
+
+### Грейд (grade)
+**Grade (грейд)** — специфичный для Picodata способ обозначения состояния инстанса. Грейд отражает то, как инстанс сконфигурирован его соседями. Существуют текущий (`current`) и целевой (`target`) типы грейдов. За приведение первого ко второму отвечает governor (губернатор).
+
+### Губернатор (governor)
+**Governor (губернатор)** — внутренняя централизованная сущность, управляющая конфигурациями и жизненными циклами инстансов в соответствие с изменениями их грейдов. "Губернатор" выполняется на лидере raft-группы.
+
+### Крейт (crate)
+**Крейт** (буквально “ящик”) — наименьшая логическая единица проекта, написанного на Rust. С точки зрения компилятора rustc, любой отдельный фрагмент кода является крейтом. Из одного крейта может быть скомпилирован бинарный исполняемый файл, либо разделяемая библиотека. Несколько крейтов могут вместе составлять пакет (package). Пакет может состоять также и из одного крейта. Если крейтов в пакете несколько, то из них только один может предоставлять разделяемую библиотеку.
+
+### Снапшот (snapshot) <a name="snapshot"></a>
+**Снапшот**, в самом широком смысле этого слова — это снимок состояния распределенного конечного автомата. В контексте Picodata можно говорить о двух независимых (почти) распределенных конечных автоматах, и, соответственно, о двух видах снапшотов — Tarantool и Raft.
+
+Picodata прилагает все усилия, чтобы эти состояния были одинаковыми на каждом узле кластера, но т.к. изменения на нодах происходят через применение команд из журнала (WAL или raft), то даже в штатном режиме случаются не одновременно.
+
+Более детально, состояние инстанса включает в себя две части:
+
+- персистентные данные, которые можно сериализовать и сохранить на диск;
+- транзиторное (transient) состояние — все структуры, которые Tarantool строит в оперативной памяти для обработки DML-запросов.
+
+См. также:
+
+- [RFC — Storage schema — Raft snapshot](https://docs.google.com/document/d/1MEpGnpKKj6WezLKytvvonZzbpy1tlWtAK5ccxaeAOrE/edit#heading=h.687c3wywf9ub)
+- [Tarantool — Persistence](https://www.tarantool.io/en/doc/latest/concepts/data_model/persistence/)
+
+
+## Процессы и алгоритмы
+### Компактизация raft-журнала (raft log compaction)
+**Компактизация** — процесс, не допускающий бесконтрольного роста журнала записей Raft. Компактизация заключается в удалении части журнала, относящейся к сделанному ранее снапшоту.
+
+### Создание снапшотов (snapshotting)
+**Создание снапшотов** — процесс периодического сохранения состояния инстанса на жесткий диск. Наличие снапшотов (т.е. снимков состояния) позволяют восстановить инстанс в прежнем виде после его перезапуска.
+
+### Фенсинг (fencing)
+**Фенсинг** — это подпись всех запросов в кластере номером эпохи или терма, и отказ обслуживать запросы с устаревшей эпохой. Данный инструмент используется для корректной работы распределенной блокировки, т.е. ситуации, когда из нескольких узлов нужно гарантированно выбрать один для выполнения запроса.
+
+### CaS (compare and swap) <a name="cas"></a>
+**Compare and swap** — особый алгоритм в составе Picodata. Он обеспечивает уровень изоляции транзакций [serializable](glossary.md#isolation), тем самым не допуская случаев несогласованности данных в результате выполнения конкурирующих запросов/транзакций. Таким случаем, например, может быть ситуация, когда одна транзакция затирает результат действия другой, выполняющейся в тоже время. _Compare and swap_ решает эту проблему с помощью проверки предиката, т.е. меняет данные какого-либо параметра кластера только в том случае, если исходное ожидаемое значение этого параметра соответствует исходному фактическому. 
+Технически данный алгоритм реализован в виде хранимой процедуры `proc_cas()`. 
+
+### Бутстрап (bootstrap) <a name="bootstrap"></a>
+**Bootstrap** — процесс первоначального объединения разрозненных инстансов в единый кластер. В контексте Picodata речь обычно идет о бутстрапе инстанса, когда инстанс запускается в чистой директории без снапшотов. При необходимости можно уточнить, бутстрапится _лидер реплиасета_ или _read-only-реплика_ — алгоритмы для них отличаются.
+
+Случай, когда инстанс запускается на существующих снапшотах, называется _восстановлением из снапшота_ (recovery from a snapshot). Этот процесс сопутствует перезапуску инстанса.
+
+Другой эксплуатационный сценарий, когда при перезапуске удаляются все данные инстанса, называют _ребутстрапом_ (rebootstrap), т.е. повторным запуском. Ребутстрап всегда сопровождается сменой `raft_id`, хотя `instance_id` может при этом переиспользоваться.
+
+_Бутстрап кластера_ — бутстрап первого инстанса + [присоединение](#joining) некоторого количества других. 
+
+_Бутстрап репликасета_ — бутстрап лидера репликасета + присоединение к нему реплик.
+
+### Присоединение (joining) инстанса к кластеру <a name="joining"></a>
+_Присоединение инстанса_ близко по смыслу к [бутстрапу](#bootstrap), но делает акцент на процессах, происходящих в самом кластере. Чтобы инстанс мог присоединиться, другие (уже существующие) члены кластера должны сначала сохранить информацию о нем в raft-журнал.
+
+### Репликация (replication) <a name="replication"></a>
+**Репликация** — один из механизмов [актуализации](#actualization) данных между инстансами. В Picodata существует два вида репликации: Tarantool (внутри [репликасета](#replicaset)) и Raft (глобальная на весь кластер). Под термином репликация обычно имеют в виду пересылку записей журналов (`wal` или `raft` в зависимости от того, о каком виде репликации идет речь).
+
+### Актуализация (catch-up) инстанса <a name="actualization"></a>
+Актуализация — это по сути синхронизация данных между инстансами. Существует два механизма актуализации: посредством [репликации](#replication) журнала (catch-up by log replication), и посредством применения [снапшота](#snapshot) (catch-up by snapshot).
+
+Актуализация снапшотом поддерживается только для Raft, но не для Tarantool. Она требуется, когда на raft-лидере отсутствуют нужные записи в raft-журнале. Если аналогичная ситуация происходит с WAL Tarantool, пользователю не остается выбора кроме как делать [ребутстрап](#bootstrap) инстанса.
+
+### Proc API
+
+**Proc API** — Stored Procedures API (хранимые процедуры). Хранимыми процедурам являются Rust-функции с аттрибутом `#[tarantool::proc]`. Процедуры могут быть вызваны с помощью любого тарантул-коннектора, в частности, с помощью Lua-модуля `net.box` или Rust-модуля `tarantool::network::client`. В Picodata хранимые процедуры используются для коммуникации между инстансами. 
+
+Примерами хранимых процедур в Picodata могут служить:
+- `.proc_cas`  (низкоуровневый вызов механизма [Compare and Swap](#cas) на выбранном инстансе);
+- `.proc_read_index` (получение текущего значения raft-индекса выбранного инстанса).
+
+## Общие концепции
+### Отказоустойчивость <a name="failsoft"></a>
+**Отказоустойчивость** — свойство кластера сохранять наличие и доступность данных при выходе из строя части узлов. В Picodata отказоустойчивость обеспечивается репликацией и грамотным проектированием алгоритмов.
+
+### Горизонтальное масштабирование <a name="sharding"></a>
+**Горизонтальное масштабирование** (оно же сегментирование или шардирование, sharding) — подход, предполагающий разделение данных на сегменты (бакеты, buckets), которые могут храниться на отдельных репликасетах кластера. С точки зрения набора хранимых данных, каждый репликасет называется шардом. Деление на шарды — это еще один вариант логического деления кластера, но без привязки к серверам, на которых выполняются инстансы.
+
+### Линеаризуемость <a name="linearizability"></a>
+В контексте распределенных баз данных **линеаризуемость** обозначает свойство хранилища обеспечивать целостность и согласованность данных на разных репликах БД. Линеаризуемость в Picodata обеспечивается алгоритмом консенсуса Raft, который обновляет данные на мастер-реплике только после того, как они записаны на резервные реплики.
+
+
+В схеме данных кластера для каждого шардированного спейса (таблицы) задается параметр распределения — _ключ шардирования_, состоящий из одной или нескольких колонок. Пример:
+
+```
+sharding_key:
+    - id
+    - name
+```
+### Уровень изоляции транзакций <a name="isolation"></a>
+Уровень изоляции транзакций является одним из компонентов ACID (_atomicity, consistency, isolation, durability_), который представляет собой набор требований к СУБД согласно стандарту [ANSI/ISO SQL](https://en.wikipedia.org/wiki/ISO/IEC_9075). Уровень изоляции транзакций определяет степень строгости, которую СУБД применяет к возможной несогласованности данных при исполнении нескольких транзакций одновременно. Различают следующие уровни (по мере повышения строгости и усиления блокировок):
+
+- **Read uncommitted**. Низший уровень изоляции, допускающий чтение незафиксированных данных. В результат чтения могут попасть данные от других, еще не завершившихся операций записи.
+- **Read committed.** Чтение уже зафиксированных данных. Данный уровень гарантирует, что в момент чтения данные были ранее зафиксированы, однако позволяет изменять данные сразу после этого. Т.е. повторное чтение внутри транзакции уже не гарантирует получение такого же набора данных.
+- **Repeatable read**. Повторяемое чтение данных, при которых нельзя изменять данные до тех пор, пока читающая их транзакция не завершилась.
+- **Serializable**. Наивысший уровень изоляции, предполагающий полное упорядочивание (сериализацию) транзакций. Результат выполнения нескольких параллельных транзакций должен быть таким, как если бы они выполнялись последовательно.
+
+### Read phenomena (проблемы чтения данных)
+Уровни изоляции транзакций существуют для учета и решения следующих проблем, возникающих при одновременном (параллельном) чтении данных:
+
+- **Lost update** (потерянное обновление). При одновременном изменении данных разными транзакциями теряются все изменения, кроме последнего.
+- **Dirty read** (неточное чтение). В результат чтения добавятся данные, привнесенные другой транзакцией, которая впоследствие будет отменена (не получит статуса committed).
+- **Non-repeatable read** (проблема однократного чтения). Несколько последовательных операций чтения одних и тех же данных дают разный результат, т.к. между ними вклинилась сторонняя операция записи.
+- **Phantom read** (фантомное чтение). Проблема схожа с предыдущей и также касается изменения данных после начала операции чтения. Однако, “фантомное чтение” предполагает изменение самой выборки (параллельная операция записи добавляет/удаляет строки).
+
 
-**Governor** (губернатор) — внутренняя централизованная сущность, управляющая конфигурациями и жизненными циклами инстансов в соответствие с изменениями их грейдов.
-- 
GitLab