Skip to content
Snippets Groups Projects
Commit 4eff6358 authored by Alexander Tolstoy's avatar Alexander Tolstoy
Browse files

docs: rearrange subsections, get rid of 'broadcaster' references

parent 85f99c83
No related branches found
No related tags found
1 merge request!95docs: rearrange subsections, get rid of 'broadcaster' references
......@@ -16,6 +16,7 @@
### Справочные материалы
* [Описание параметров запуска Picodata](cli)
* [Справочник команд SQL](sbroad/sql_queries)
* [Поддерживаемые функции стандарта SQL](sbroad/sql_reference)
* [Глоссарий основных терминов и определений](glossary)
......
# Работа с SQL в Picodata
Данный раздел содержит базовые сведения о поддержке распределенного SQL в Picodata и используемой в ней СУБД Tarantool.
## Доступные материалы в данном разделе
Мы предоставляем следующие документы для описания возможностей SQL в Picodata:
* [Справочник команд SQL](../sql_queries)
* [Общее описание и принцип работы распределенного SQL](../sql_review)
* [Перечень поддерживаемых типов данных](../sql_datatypes)
* [Инструкцию по установке и работе с тестовым приложением Sbroad](../sql_tutorial)
<!-- * [Глоссарий основных терминов и определений](../sql_glossary) -->
* [Справочник поддерживаемых функций стандарта SQL](../sql_reference)
## Основные термины и определения
Работа с СУБД Tarantool предполагает знание и понимание основных терминов, используемых при эксплуатации распределенных систем. Для этого на нашем портале документации имеется [справочник-глоссарий](../sql_review), дающий определения для базовых понятий.
## Picodata и SQL
Picodata включает в себя богатую функциональность по работе с реляционными данными, имеющуюся в СУБД Tarantool. Пользователи могут создавать, наполнять данными хранилище БД и затем считывать данные посредством запросов в интерактивной консоли Picodata.
Дополнительно, Picodata предоставляет функцию получения данных из всего распределенного хранилища посредством компонента [SQL Broadcaster](https://git.picodata.io/picodata/picodata/sbroad). Таким образом, Picodata является одной из немногих СУБД, где реализован механизм как локального, так и распределенного SQL.
Дополнительно, Picodata предоставляет функцию получения данных из всего распределенного хранилища посредством компонента [Sbroad](https://git.picodata.io/picodata/picodata/sbroad). Таким образом, Picodata является одной из немногих СУБД, где реализован механизм как локального, так и распределенного SQL.
## Основные понятия SQL
......@@ -19,28 +30,17 @@ Picodata включает в себя богатую функционально
* Стандарт SQL не гарантирует какой-либо порядок строк при чтении из таблицы;
Для работы с SQL в рамках распределенной системы (кластера) в Picodata используется компонент Sbroad (SQL Broadcaster).
Для работы с SQL в рамках распределенной системы (кластера) в Picodata используется компонент SQL Broadcaster.
## Что такое Sbroad
## Что такое SQL Broadcaster
SQL Broadcaster — это динамическая библиотека, которая работает на всех экземплярах БД Tarantool в кластере. Данная библиотека предоставляет функции планировщика и модуля исполнения SQL-запросов в рамках кластера СУБД Tarantool. SQL-запросы выполняются на узлах, исполняющих роль маршрутизаторов (роутеров), и получают данные с узлов хранения (storages). Поскольку в кластере может быть много как узлов хранения, так и роутеров, каждый распределенный запрос разбивается на части для опроса всех узлов. Собранные данные затем консолидируются и возвращаются пользователю.
Sbroad — это динамическая библиотека, которая работает на всех экземплярах БД Tarantool в кластере. Данная библиотека предоставляет функции планировщика и модуля исполнения SQL-запросов в рамках кластера СУБД Tarantool. SQL-запросы выполняются на узлах, исполняющих роль маршрутизаторов (роутеров), и получают данные с узлов хранения (storages). Поскольку в кластере может быть много как узлов хранения, так и роутеров, каждый распределенный запрос разбивается на части для опроса всех узлов. Собранные данные затем консолидируются и возвращаются пользователю.
Подробности архитектуры планировщика доступны в отдельной [PDF-презентации](https://git.picodata.io/picodata/picodata/sbroad/-/blob/main/doc/design/sbroad.pdf).
## Доступные материалы в данном разделе
Мы предоставляем следующие документы для SQL Broadcaster:
* [Общее описание и принцип работы компонента SQL Broadcaster](../sql_review)
* [Справочник команд SQL Broadcaster](../sql_queries)
* [Перечень поддерживаемых типов данных](../sql_datatypes)
* [Инструкция по установке SQL Broadcaster и тестового приложения](../sql_tutorial)
<!-- * [Глоссарий основных терминов и определений](../sql_glossary) -->
* [Справочник поддерживаемых функций стандарта SQL](../sql_reference)
## Обратная связь и получение помощи
Программное обеспечение Picodata, включающее в себя, в том числе, компонент SQL Broadcaster, является открытым и доступно в нашем [Git-репозитории](https://git.picodata.io/). Мы приветствуем использование, распространение и доработку нашего ПО в рамках совместной коллективной работы.
Программное обеспечение Picodata является открытым и доступно в нашем [Git-репозитории](https://git.picodata.io/). Мы приветствуем использование, распространение и доработку нашего ПО в рамках совместной коллективной работы.
Дополнительную техническую поддержку, информацию о новостях и тренингах Picodata, а также о сотрудничестве можно также получить в нашем Telegram-канале [@picodataru](https://t.me/picodataru).
......
# Справочник команд SQL Broadcaster
# Справочник команд SQL
Справочник команд предоставляет основные варианты использования команд SQL в Picodata при работе с распределенной СУБД.
Функциональность компонента SQL Broadcaster обеспечивает поддержку распределенных запросов SELECT и INSERT. Ниже на схеме показаны базовые варианты этих запросов.
Функциональность компонента Sbroad в Picodata обеспечивает поддержку распределенных запросов `SELECT` и `INSERT`. Ниже на схеме показаны базовые варианты этих запросов.
![Query](ebnf/query.svg)
......@@ -9,7 +9,7 @@
## Запрос SELECT
Запрос `SELECT` используется для получения информации из указанной таблицы в базе данных. Он возвращает 0 или более строк из таблицы согласно поисковому запросу.
В контексте распределенной системы, запрос `SELECT` в `SQL Broadcaster` получает информацию из всех сегментов таблицы, которая может храниться на нескольких узлах кластера.
В контексте распределенной системы, запрос `SELECT` в Picodata получает информацию из всех сегментов таблицы, которая может храниться на нескольких узлах кластера.
Cхема возможных распределенных запросов `SELECT` показана ниже.
......
......@@ -15,6 +15,7 @@ nav:
- Пример работы с кластером Picodata: tutorial.md
- Справочные материалы:
- Описание параметров запуска Picodata: cli.md
- Справочник команд SQL: sbroad/sql_queries
- Глоссарий основных терминов и определений: glossary.md
- Поддерживаемые функции стандарта SQL: sbroad/sql_reference.md
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment