From 806cc085e8984d1d820067a0c0ee807130cbe801 Mon Sep 17 00:00:00 2001 From: st-shchetinin Date: Fri, 5 Dec 2025 14:58:35 +0000 Subject: [PATCH 1/2] topics in export --- .../reference/ydb-cli/export-import/_includes/s3_export.md | 1 + .../reference/ydb-cli/export-import/_includes/export-s3.md | 5 +++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/s3_export.md b/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/s3_export.md index e16b7218c5a2..b8776e4c28f8 100644 --- a/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/s3_export.md +++ b/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/s3_export.md @@ -16,6 +16,7 @@ The export feature is available only for objects of the following types: - [Row-oriented table](../../../../concepts/datamodel/table.md#row-oriented-tables) - [Secondary index](../../../../concepts/glossary.md#secondary-index) - [Vector index](../../../../concepts/glossary.md#vector-index) +- [Topic](../../../../concepts/datamodel/topic.md) () {% endnote %} diff --git a/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/export-s3.md b/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/export-s3.md index 4735f644fa38..494c45a920d7 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/export-s3.md +++ b/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/export-s3.md @@ -14,8 +14,9 @@ - [директория](../../../../concepts/datamodel/dir.md); - [строковая таблица](../../../../concepts/datamodel/table.md#row-oriented-tables); -- [вторичный индекс](../../../../concepts/glossary.md#secondary-index). -- [векторный индекс](../../../../concepts/glossary.md#vector-index). +- [вторичный индекс](../../../../concepts/glossary.md#secondary-index); +- [векторный индекс](../../../../concepts/glossary.md#vector-index); +- [топик](../../../../concepts/datamodel/topic.md) (only the schema, without messages). Для более простого экспорта одиночных строковых и колоночных таблиц в S3-совместимое хранилище данных можно использовать [внешние источники данных](../../../../concepts/datamodel/external_data_source.md). Подробнее см. в статье [{#T}](../../../../concepts/federated_query/s3/write_data.md#export-to-s3). From 8085aef7bc35f81a3462f934bae023fdef1cf7ce Mon Sep 17 00:00:00 2001 From: st-shchetinin Date: Fri, 5 Dec 2025 16:02:08 +0000 Subject: [PATCH 2/2] cli --- .../ydb-cli/export-import/_includes/file_structure.md | 3 +++ .../ydb-cli/export-import/_includes/file-structure.md | 4 ++++ 2 files changed, 7 insertions(+) diff --git a/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/file_structure.md b/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/file_structure.md index f10ccaf6868e..4e227712b95c 100644 --- a/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/file_structure.md +++ b/ydb/docs/en/core/reference/ydb-cli/export-import/_includes/file_structure.md @@ -73,6 +73,9 @@ For each table in the database, there's a same-name directory in the file struct - The `changefeed_description.pb` file describing the changefeed in the [text protobuf](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.text_format) format - The `topic_description.pb` file describing the underlying topic in the [text protobuf](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.text_format) format +## Topics {#topics} + +For each topic in the database, there's a same-name directory in the file structure's directory hierarchy that includes the create_topic.pb file. This file provides information about the topic parameters, partitioning settings, and consumers in the [text protobuf](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.text_format) format. ## Files with data {#datafiles} diff --git a/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/file-structure.md b/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/file-structure.md index a26c55552874..5304375f0094 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/file-structure.md +++ b/ydb/docs/ru/core/reference/ydb-cli/export-import/_includes/file-structure.md @@ -73,6 +73,10 @@ - Файл `changefeed_description.pb`, содержащий информацию о потоке изменений в формате [text protobuf](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.text_format) - Файл `topic_description.pb`, содержащий информацию о нижележащем топике в формате [text protobuf](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.text_format) +## Топики {#topics} + +Каждому топику в базе данных также соответствует одноименная директория в иерархии директорий файловой структуры, в которой находится файл `create_topic.pb`, содержащий информацию о параметрах топика, настройках партиционирования и консьюмерах в формате [text protobuf](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.text_format) + ## Файлы с данными {#datafiles} Формат файлов с данными - `.csv`, одна строка соответствует одной записи в таблице, без строки с заголовками колонок. Для строк применяется представление в urlencoded формате. Например, строка файла для таблицы с колонками uint64 и utf8, содержащая число 1 и строку "Привет" соответственно, выглядит таким образом: