Skip to content

Conversation

@orange13
Copy link
Contributor

Changelog entry

...

Changelog category

  • Documentation (changelog entry is not required)

Description for reviewers

...

@orange13 orange13 requested a review from a team as a code owner October 27, 2025 10:22
@github-actions
Copy link

github-actions bot commented Oct 27, 2025

2025-10-27 10:23:24 UTC Pre-commit check linux-x86_64-release-asan for 6381ea5 has started.
2025-10-27 10:23:40 UTC Artifacts will be uploaded here
2025-10-27 10:24:59 UTC ya make is running...
🟢 2025-10-27 10:25:05 UTC Tests successful.

Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-10-27 10:25:07 UTC Build successful.

@github-actions
Copy link

github-actions bot commented Oct 27, 2025

2025-10-27 10:23:26 UTC Pre-commit check linux-x86_64-relwithdebinfo for 6381ea5 has started.
2025-10-27 10:23:39 UTC Artifacts will be uploaded here
2025-10-27 10:24:59 UTC ya make is running...
🟢 2025-10-27 10:25:05 UTC Tests successful.

Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-10-27 10:25:08 UTC Build successful.

@github-actions
Copy link

🟢 2025-10-27 10:25:03 UTC The validation of the Pull Request description is successful.

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Oct 27, 2025
@github-actions
Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (10)

⚠️ en/devops/observability/monitoring.md: 54: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 7]

⚠️ ru/devops/observability/monitoring.md: 72: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 8]

⚠️ ru/public-materials/videos/2025.md: 13: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 27: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 33: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 47: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 59: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/reference/configuration/query_service_config.md: 33: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/yql/reference/syntax/insert_into.md: 65: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/yql/reference/syntax/update.md: 37: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]


{{ ydb-short-name }} предоставляет единый интерфейс для выполнения запросов, способный эффективно обрабатывать широкий спектр нагрузок — от высоконагруженных [транзакционных OLTP-запросов](https://ru.wikipedia.org/wiki/OLTP) до сложных аналитических [OLAP-запросов](https://ru.wikipedia.org/wiki/OLAP). Такой подход позволяет приложениям выполнять транзакционные и аналитические запросы прозрачно, без необходимости использовать разные API для разных типов нагрузки.

Для выполнения запросов используется распределённый движок, спроектированный с учётом масштабируемости и эффективности в больших распределённых средах. При запуске запроса {{ ydb-short-name }} автоматически распределяет работу между несколькими узлами, максимально учитывая локальность данных — обрабатывает данные там, где они хранятся. Это снижает избыточные сетевые пересылки. Кроме того, применяется вычислительный pushdown (вынос фильтрации и вычислений ближе к слою хранения), что дополнительно ускоряет обработку. Благодаря этим техникам {{ ydb-short-name }} эффективно справляется со сложными запросами и большими нагрузками на уровне кластера.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

про локальность данных не звучит похожим на правду: на сторадж нодах же вроде толком ничего не вычисляется и многочисленные пересылки по сети примерно всегда есть — тут про что именно вообще рассказ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Это согласуется с английской версией - давай уточним в рамках доделок и применим смысловое сразу к двум языкам


Сессия в {{ ydb-short-name }} — это логическое "соединение" с базой данных, которое хранит контекст, необходимый для выполнения запросов и управления транзакциями. Внутри сессии поддерживается состояние транзакций и другая рабочая информация, что позволяет выполнять связанные друг с другом запросы как часть одной транзакции. Большинство операций с запросами выполняется в контексте активной сессии.

Сессии являются долгоживущими объектами. Одна из их важных задач — эффективное распределение нагрузки: за счёт распределения сессий и связанных с ними запросов по разным узлам кластера {{ ydb-short-name }} достигает высокой доступности и масштабируемости.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

По идее эффективное распределение нагрузки — задача не самих сессий, а управляющих ими компонентов. Сама по себе одна сессия вроде как установлена с каким-то конкретным узлом и на распределение нагрузки кроме как своим существованием не влияет.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласовано с английским - в уточнения


## Результирующие наборы

Результатом выполнения запроса в {{ ydb-short-name }} может быть один или несколько результирующих наборов (result sets). Результирующий набор похож на таблицу: он содержит строки со строгой типизацией данных в каждом столбце. Строгая типизация результатов обеспечивает предсказуемость и согласованность формата выдачи.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ноль results sets — тоже вполне валидная ситуация

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

в доделки


## Результирующие наборы

Результатом выполнения запроса в {{ ydb-short-name }} может быть один или несколько результирующих наборов (result sets). Результирующий набор похож на таблицу: он содержит строки со строгой типизацией данных в каждом столбце. Строгая типизация результатов обеспечивает предсказуемость и согласованность формата выдачи.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Результирующий набор похож на таблицу — не понятно почему только «похож», я б прям писал, что логически представляет собой таблицу

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

в доделки


Результатом выполнения запроса в {{ ydb-short-name }} может быть один или несколько результирующих наборов (result sets). Результирующий набор похож на таблицу: он содержит строки со строгой типизацией данных в каждом столбце. Строгая типизация результатов обеспечивает предсказуемость и согласованность формата выдачи.

Результирующие наборы могут содержать произвольно большой объём данных, поэтому для их эффективной передачи {{ ydb-short-name }} использует потоковую выдачу (streaming) — результат возвращается на клиент порциями (chunks). Это позволяет сразу начинать обработку данных без ожидания получения всей выборки и минимизирует использование оперативной памяти клиентским приложением.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

пару слов сказать, что опция с автоматической буферизацией всей таблицы в памяти в SDK тоже есть для случаев, когда разработчику известно, что большого объёма не будет

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

в доделки

@github-actions
Copy link

github-actions bot commented Oct 28, 2025

2025-10-28 15:30:53 UTC Pre-commit check linux-x86_64-release-asan for fad85ec has started.
2025-10-28 15:31:10 UTC Artifacts will be uploaded here
2025-10-28 15:32:30 UTC ya make is running...
🟢 2025-10-28 15:32:37 UTC Tests successful.

Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-10-28 15:32:40 UTC Build successful.

@github-actions
Copy link

github-actions bot commented Oct 28, 2025

2025-10-28 15:32:50 UTC Pre-commit check linux-x86_64-relwithdebinfo for fad85ec has started.
2025-10-28 15:33:07 UTC Artifacts will be uploaded here
2025-10-28 15:34:25 UTC ya make is running...
🟢 2025-10-28 15:34:32 UTC Tests successful.

Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-10-28 15:34:34 UTC Build successful.

@github-actions
Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (10)

⚠️ en/devops/observability/monitoring.md: 54: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 7]

⚠️ ru/devops/observability/monitoring.md: 72: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 8]

⚠️ ru/public-materials/videos/2025.md: 13: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 27: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 33: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 47: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/public-materials/videos/2025.md: 59: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/reference/configuration/query_service_config.md: 33: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/yql/reference/syntax/insert_into.md: 65: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

⚠️ ru/yql/reference/syntax/update.md: 37: MD009 / no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

@orange13 orange13 merged commit 0783efb into main Oct 29, 2025
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants