Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

hive docs #7413

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

hive docs #7413

wants to merge 5 commits into from

Conversation

vporyadke
Copy link
Collaborator

@vporyadke vporyadke commented Aug 2, 2024

Changelog entry

...

Changelog category

  • Documentation (changelog entry is not required)

Additional information

...

Copy link

github-actions bot commented Aug 2, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 2, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 5, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 5, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 5, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 5, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 5, 2024

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Aug 6, 2024

❌ Documentation build

Revision build failed

Build logs

Errors (1)

❌ Link is unreachable: ../common_scheme_ydb/cluster.md#history in /ru/concepts/cluster/_includes/hive/intro.md

Copy link

github-actions bot commented Aug 6, 2024

❌ Documentation build

Revision build failed

Build logs

Errors (1)

❌ Link is unreachable: ../../cluster.md#history in /ru/concepts/cluster/_includes/hive/intro.md

Copy link

github-actions bot commented Aug 6, 2024

✅ Documentation build

Revision built successfully
Revision preview link

@vporyadke vporyadke requested a review from ijon August 16, 2024 08:56
@blinkov
Copy link
Member

blinkov commented Oct 24, 2024

@vporyadke when do you plan to mark it as non-draft?

@github-actions github-actions bot added documentation Improvements or additions to documentation and removed new-feature labels Oct 24, 2024
Copy link

github-actions bot commented Nov 29, 2024

2024-11-29 00:13:49 UTC Pre-commit check linux-x86_64-relwithdebinfo for 3470b8d has started.
2024-11-29 00:14:00 UTC Artifacts will be uploaded here
2024-11-29 00:16:26 UTC ya make is running...
🔴 2024-11-29 00:17:44 UTC Build failed, see the logs. Also see fail summary

Copy link

❌ Documentation build

Revision build failed

Build logs

Errors (2)

❌ Link is unreachable: ../../common_scheme_ydb.md#history in /ru/contributor/hive.md

❌ Link is unreachable: ../../hive.md in /ru/contributor/general-schema.md

Copy link

github-actions bot commented Nov 29, 2024

2024-11-29 00:18:16 UTC Pre-commit check linux-x86_64-release-asan for 3470b8d has started.
2024-11-29 00:18:40 UTC Artifacts will be uploaded here
2024-11-29 00:21:11 UTC ya make is running...
🔴 2024-11-29 00:22:15 UTC Build failed, see the logs. Also see fail summary

Copy link

github-actions bot commented Nov 29, 2024

2024-11-29 08:47:41 UTC Pre-commit check linux-x86_64-relwithdebinfo for 4fc65e2 has started.
2024-11-29 08:47:53 UTC Artifacts will be uploaded here
2024-11-29 08:50:21 UTC ya make is running...
🟢 2024-11-29 08:51:51 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2024-11-29 08:51:56 UTC Build successful.

Copy link

github-actions bot commented Nov 29, 2024

2024-11-29 08:48:34 UTC Pre-commit check linux-x86_64-release-asan for 4fc65e2 has started.
2024-11-29 08:48:45 UTC Artifacts will be uploaded here
2024-11-29 08:51:24 UTC ya make is running...
🟢 2024-11-29 08:52:25 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2024-11-29 08:52:31 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

@vporyadke vporyadke requested a review from CyberROFL November 29, 2024 08:55
@vporyadke vporyadke marked this pull request as ready for review November 29, 2024 08:55
@vporyadke vporyadke requested a review from a team as a code owner November 29, 2024 08:55
ydb/docs/ru/core/contributor/general-schema.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/general-schema.md Outdated Show resolved Hide resolved
@@ -0,0 +1,36 @@
# Hive

Hive — таблетка, отвечающая за управление другими таблетками. В кластере {{ ydb-short-name }} есть корневой Hive, который отвечает за системные таблетки всех баз данных кластера. Hive конкретной базы данных в свою очередь отвечает за таблетки, обслуживающие пользовательскую нагрузку этой базы данных. Все узлы кластера регистрируются в корневом Hive, а в Hive конкретной базы регистрируются только вычислительные узлы этой базы. При регистрации узел сообщает в Hive, таблетки каких типов и в каких количествах могут быть на нём запущены.
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
Member

Choose a reason for hiding this comment

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

Добавь в глоссарий и сделай кросс-ссылку (оттуда-сюда, отсюда-туда).

ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/general-schema.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
Copy link

github-actions bot commented Dec 26, 2024

2024-12-26 11:24:15 UTC Pre-commit check linux-x86_64-release-asan for 6c71149 has started.
2024-12-26 11:24:28 UTC Artifacts will be uploaded here
2024-12-26 11:26:49 UTC ya make is running...
🟢 2024-12-26 11:28:09 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2024-12-26 11:28:16 UTC Build successful.

Copy link

github-actions bot commented Dec 26, 2024

2024-12-26 11:24:16 UTC Pre-commit check linux-x86_64-relwithdebinfo for 6c71149 has started.
2024-12-26 11:24:28 UTC Artifacts will be uploaded here
2024-12-26 11:26:56 UTC ya make is running...
🟢 2024-12-26 11:28:29 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2024-12-26 11:28:35 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

@vporyadke vporyadke requested a review from CyberROFL December 26, 2024 12:38
ydb/docs/ru/core/contributor/general-schema.md Outdated Show resolved Hide resolved

Hive — таблетка, отвечающая за управление другими таблетками. В кластере {{ ydb-short-name }} есть корневой Hive, который отвечает за [системные таблетки](../concepts/glossary.md#tablet-types) всех баз данных кластера. Hive конкретной базы данных в свою очередь отвечает за таблетки, обслуживающие пользовательскую нагрузку этой базы данных. Все узлы кластера регистрируются в корневом Hive, а в Hive конкретной базы регистрируются только вычислительные узлы этой базы. При регистрации узел сообщает в Hive, таблетки каких типов и в каких количествах могут быть на нём запущены.

Создание и удаление таблеток инициируется таблеткой [SchemeShard](../concepts/glossary.md#scheme-shard). При создании таблетки Hive присваивает ей уникальный TabletId, заполняет [TabletStorageInfo](general-schema.md#history), выбирает наиболее подходящий узел и отправляет на него команду поднять таблетку. В некоторых нестандартных ситуациях отдельная таблетка может прервать работу, тогда узел, на котором она была запущена, отправляет сообщение в Hive. Также Hive предполагает, что если связь с некоторым узлом потеряна, то запущенные на нём таблетки прекратили работу. В таких ситуациях Hive запускает таблетки на других узалах с увеличением поколения.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Создание и удаление таблеток инициируется таблеткой [SchemeShard](../concepts/glossary.md#scheme-shard). При создании таблетки Hive присваивает ей уникальный TabletId, заполняет [TabletStorageInfo](general-schema.md#history), выбирает наиболее подходящий узел и отправляет на него команду поднять таблетку. В некоторых нестандартных ситуациях отдельная таблетка может прервать работу, тогда узел, на котором она была запущена, отправляет сообщение в Hive. Также Hive предполагает, что если связь с некоторым узлом потеряна, то запущенные на нём таблетки прекратили работу. В таких ситуациях Hive запускает таблетки на других узалах с увеличением поколения.
Создание и удаление таблеток инициируется таблеткой [SchemeShard](../concepts/glossary.md#scheme-shard). При создании таблетки Hive присваивает ей уникальный идентификатор (TabletId), заполняет [TabletStorageInfo](general-schema.md#history), выбирает наиболее подходящий узел и отправляет на него команду поднятия таблетки. В некоторых нестандартных ситуациях отдельная таблетка может прервать работу, тогда узел, на котором она была запущена, отправляет сообщение в Hive. Также Hive предполагает, что если связь с некоторым узлом потеряна, то запущенные на нём таблетки прекратили работу. В таких ситуациях Hive запускает таблетки на других узалах с увеличением поколения.

Возможно, еще стоит добавить ссылку на TabletId.

ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
ydb/docs/ru/core/contributor/hive.md Outdated Show resolved Hide resolved
Copy link

github-actions bot commented Jan 9, 2025

2025-01-09 12:03:34 UTC Pre-commit check linux-x86_64-relwithdebinfo for 739f47d has started.
2025-01-09 12:03:57 UTC Artifacts will be uploaded here
2025-01-09 12:06:49 UTC ya make is running...
🟢 2025-01-09 12:08:17 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-01-09 12:08:23 UTC Build successful.

Copy link

github-actions bot commented Jan 9, 2025

2025-01-09 12:04:11 UTC Pre-commit check linux-x86_64-release-asan for 739f47d has started.
2025-01-09 12:04:24 UTC Artifacts will be uploaded here
2025-01-09 12:06:54 UTC ya make is running...
🟢 2025-01-09 12:08:28 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-01-09 12:08:35 UTC Build successful.

Copy link

github-actions bot commented Jan 9, 2025

✅ Documentation build

Revision built successfully
Revision preview link

@vporyadke vporyadke requested a review from CyberROFL January 10, 2025 08:42
Copy link
Member

@CyberROFL CyberROFL left a comment

Choose a reason for hiding this comment

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

В целом, для начала, достаточно.

@@ -355,11 +355,11 @@

### Типы таблеток {#tablet-types}

[Таблетки](#tablet) можно рассматривать как фреймворк для создания надёжных компонентов, работающих в распределённой системе. Многие компоненты {{ ydb-short-name }} реализованы с использованием этого фреймворка, они перечислены ниже.
[Таблетки](#tablet) можно рассматривать как фреймворк для создания надёжных компонентов, работающих в распределённой системе. Многие компоненты {{ ydb-short-name }} — как системные, так и работающие с пользовательскими данными — реализованы с использованием этого фреймворка, основные из них перечислены ниже.

#### Scheme shard {#scheme-shard}
Copy link
Member

Choose a reason for hiding this comment

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

Хайв тоже просится в глоссарий. И сразу можно сослаться на новую статью.

@vporyadke vporyadke changed the title [wip] hive docs hive docs Jan 13, 2025
@github-actions github-actions bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jan 13, 2025
Copy link

✅ Documentation build

Revision built successfully
Revision preview link

@vporyadke vporyadke requested a review from blinkov January 13, 2025 23:44
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