quickstart трансфер данных

ydb/docs/ru/core/recipes/index.md

@@ -5,3 +5,4 @@
 * [{#T}](ydb-sdk/index.md)
 * [{#T}](ydb-cli/index.md)
 * [{#T}](../yql/reference/recipes/index.md)
+* [{#T}](transfer/index.md)

ydb/docs/ru/core/recipes/toc_p.yaml

@@ -17,3 +17,8 @@ items:
   include:
     mode: link
     path: vector-search/toc_p.yaml
+- name: Трансфер данных из топика в таблицу
+  href: transfer/index.md
+  include:
+    mode: link
+    path: transfer/toc_p.yaml

ydb/docs/ru/core/recipes/transfer/index.md

@@ -0,0 +1,7 @@
+# Рецепты работы с трансфером данных из топика в таблицу
+
+Этот раздел содержит рецепты работы с [трансфером](../../concepts/transfer.md) из топика в таблицу.
+
+Содержание:
+
+* [{#T}](transfer-quickstart.md)

ydb/docs/ru/core/recipes/transfer/toc_p.yaml

@@ -0,0 +1,3 @@
+items:
+- name: Трансфер - быстрый старт
+  href: transfer-quickstart.md

ydb/docs/ru/core/recipes/transfer/transfer-quickstart.md

@@ -0,0 +1,101 @@
+# Трансфер — быстрый старт
+
+Эта статья поможет быстро начать работу с [трансфером](../../concepts/transfer.md) в {{ ydb-short-name }} на простейшем модельном примере.
+
+В статье будут рассмотрены следующие шаги работы с трансфером:
+
+* [создание топика](#step1) из которого будет читать трансфер;
+* [создание таблицы](#step2) в которую будут записываться данные;
+* [создание трансфера](#step3);
+* [заполнение топика данными](#step4);
+* [проверка содержимого таблицы](#step5).
+
+## Шаг 1. Создание топика {#step1}
+
+Сначала нужно создать [топик](../../concepts/topic.md) в {{ ydb-short-name }}, из которого трансфер будет читать данные. Это можно сделать с помощью [SQL-запроса](../../yql/reference/syntax/create-topic.md):
+
+```yql
+CREATE TOPIC SourceTopic;
+```
+
+Этот топик `SourceTopic` позволяет передавать любые неструктурированные данные.
+
+## Шаг 2. Создание таблицы {#step2}
+
+После создания топика следует добавить [таблицу](../../concepts/datamodel/table.md), в которую будут поставляться данные из топика `SourceTopic`. Это можно сделать с помощью [SQL-запроса](../../yql/reference/syntax/create_table/index.md):
+
+```yql
+CREATE TABLE TargetTable (
+  partition Uint32 NOT NULL,
+  offset Uint64 NOT NULL,
+  data String,
+  PRIMARY KEY (partition, offset)
+);
+```
+
+Эта таблица `TargetTable` имеет три столбца:
+
+* `partition` — идентификатор [партиции](../../concepts/glossary.md#partition) топика, из которой получено сообщение;
+* `offset` — [порядковый номер](../../concepts/glossary.md#offset), идентифицирующий сообщение внутри партиции;
+* `data` — тело сообщения.
+
+## Шаг 3. Создание трансфера {#step3}
+
+После создания топика и таблицы следует добавить [трансфер](../../concepts/transfer.md) данных, который будет перекладывать сообщения из топика в таблицу. Это можно сделать с помощью [SQL-запроса](../../yql/reference/syntax/create-transfer.md):
+
+```yql
+$transformation_lambda = ($msg) -> {
+    return [
+        <|
+            partition: $msg._partition,
+            offset: $msg._offset,
+            data: $msg._data
+        |>
+    ];
+};
+
+CREATE TRANSFER Transfer
+  FROM SourceTopic TO TargetTable
+  USING $transformation_lambda;
+```
+
+В этом примере:
+
+* `$transformation_lambda` - это правило преобразования сообщения из топика в колонки таблицы;
+* `$msg` - переменная, которая содержит обрабатываемое сообщение из топика.
+
+## Шаг 4. Заполнение топика данными {#step4}
+
+После создания трансфера можно записать в топик сообщение, например, используя [{{ ydb-short-name }} CLI](../../reference/ydb-cli/index.md).
+
+{% include [x](../../_includes/ydb-cli-profile.md) %}
+
+```bash
+echo "Message 1" |  ydb --profile quickstart topic write SourceTopic
+echo "Message 2" |  ydb --profile quickstart topic write SourceTopic
+echo "Message 3" |  ydb --profile quickstart topic write SourceTopic
+```
+
+## Шаг 5. Проверка содержимого таблицы {#step5}
+
+После записи сообщения в топик `SourceTopic` спустя некоторое время появится запись в таблице `TargetTable`. Проверить ее наличие можно с помощью [SQL-запроса](../../yql/reference/syntax/select/index.md):
+
+```yql
+SELECT *
+FROM TargetTable;
+```
+
+Результат выполнения запроса:
+
+```bash
+partition offset  data
+0         0       "Message 1"
+0         1       "Message 2"
+0         2       "Message 3"
+```
+
+## Заключение
+
+Данная статья приводит простой пример работы с трансфером: создание топика, таблицы и трансфера, записи в топик и проверки результата работы трансфера.
+
+Более подробную информацию о трансфере см. [здесь](../../concepts/transfer.md).