Merge 3ef0155 into a435e8c

Author: shnikd

ydb/docs/en/core/yql/reference/syntax/index.md

@@ -21,6 +21,7 @@
 * [CREATE TABLE](create_table/index.md)
 * [DROP TABLE](drop_table.md)
 * [INSERT](insert_into.md)
+* [SHOW CREATE](show_create.md)
 
 {% if feature_map_tables %}
 

ydb/docs/en/core/yql/reference/syntax/show-create.md

@@ -0,0 +1,32 @@
+# SHOW CREATE
+
+
+`SHOW CREATE` returns a query (possibly consisting of several SQL statements) required to recreate the structure of the specified object: {% if concept_table %}[table]({{ concept_table }}){% else %}table{% endif %} (TABLE) or [view](../../../concepts/datamodel/view.md) (VIEW).
+
+### Syntax
+
+```yql
+SHOW CREATE [TABLE|VIEW] <name>;
+```
+
+### Parameters
+
+* `TABLE|VIEW` — The object type: `TABLE` for a table or `VIEW` for a view.
+* `<name>` — The object name. An absolute path may also be specified.
+
+## Result
+
+The command always returns **exactly one row** with three columns:
+
+| TablePath       | TableType  | CreateTableQuery                 |
+|-----------------|------------|----------------------------------|
+| Absolute path   | Table/View | SQL DDL statements for creation  |
+
+- **TablePath** — The absolute path to the object (e.g., `/Root/MyTable` or `/Root/MyView`).
+- **TableType** — The type of object: `Table` or `View`.
+- **CreateTableQuery** — The complete set of DDL statements needed to recreate the object:
+    - For tables: the main [CREATE TABLE](create_table/index.md) statement (with the path relative to the database), plus any additional statements describing the current configuration, such as:
+        - [ALTER TABLE ... ALTER INDEX](alter_table/indexes#altering-an-index-alter-index) — for index partitioning settings.
+        - [ALTER TABLE ... ADD CHANGEFEED](alter_table/changefeed.md) — for adding a change feed.
+        - `ALTER SEQUENCE` — for restoring a `Sequence` state for `Serial` columns.
+    - For views: the definition via [CREATE VIEW](create-view.md), and, if necessary, the output of [PRAGMA TablePathPrefix](pragma#tablepathprefix-table-path-prefix).

ydb/docs/en/core/yql/reference/syntax/toc_i.yaml

@@ -42,6 +42,7 @@ items:
 - { name: SELECT,                       include: { mode: link, path: select/toc_p.yaml }  }
 - { name: SELECT STREAM,                href: select_stream.md,              when: feature_mapreduce and process_command == "PROCESS STREAM" }
 - { name: SUBQUERY,                     href: subquery.md,                   when: feature_subquery }
+- { name: SHOW CREATE,                  href: show_create.md }
 - { name: UPDATE,                       href: update.md,                     when: feature_map_tables }
 - { name: UPSERT,                       href: upsert_into.md,                when: feature_upsert }
 - { name: USE,                          href: use.md,                        when: feature_mapreduce }

ydb/docs/ru/core/yql/reference/syntax/index.md

@@ -21,6 +21,7 @@
 * [CREATE TABLE](create_table/index.md)
 * [DROP TABLE](drop_table.md)
 * [INSERT](insert_into.md)
+* [SHOW CREATE](show_create.md)
 
 {% if feature_map_tables %}
 

ydb/docs/ru/core/yql/reference/syntax/show-create.md

@@ -0,0 +1,31 @@
+# SHOW CREATE
+
+`SHOW CREATE` возвращает запрос, возможно состоящий из нескольких SQL-стейтментов, необходимых для воссоздания структуры выбранного объекта: {% if concept_table %}[таблицы]({{ concept_table }}){% else %}таблицы{% endif %} (`TABLE`) или [представления](../../../concepts/datamodel/view.md) (`VIEW`).
+
+### Синтаксис:
+
+```yql
+SHOW CREATE [TABLE|VIEW] <name>;
+```
+### Параметры
+
+* `TABLE|VIEW` - тип объекта: `TABLE` для таблицы или `VIEW` для представления.
+* `<name>` - имя объекта, также может быть указан абсолютный путь.
+
+## Результат выполнения
+
+Команда возвращает **ровно одну строку** с тремя колонками:
+
+| TablePath       | TableType | CreateTableQuery            |
+|-----------------|-----------|-----------------------------|
+| Абсолютный путь | Table/View| SQL-стейтменты для создания |
+
+- **TablePath** — абсолютный путь к объекту (например, `/Root/MyTable` или `/Root/MyView`).
+- **TableType** — тип объекта: `Table` или `View`.
+- **CreateTableQuery** — полный набор DDL-стейтментов, необходимых для воссоздания объекта:
+    - Для таблиц: основной оператор [CREATE TABLE](create_table/index.md) (с путем относительно базы), а также дополнительные команды, необходимые для описания текущего состояния и настроек:
+        - [ALTER TABLE ... ALTER INDEX](alter_table/indexes#изменение-параметров-индекса-alter-index)— для задания настроек партицирования вторичных индексов.
+        - [ALTER TABLE ... ADD CHANGEFEED](alter_table/changefeed.md)— для добавления потока изменений.
+        - `ALTER SEQUENCE` — для восстановления состояния `Sequence` у колонок типа [Serial](../../../yql/reference/types/serial.md).
+    - Для представлений: определение посредством команды [CREATE VIEW](create-view.md), а также, если необходимо, вывода [PRAGMA TablePathPrefix](pragma#tablepathprefix-table-path-prefix).
+

ydb/docs/ru/core/yql/reference/syntax/toc_i.yaml

@@ -55,6 +55,7 @@ items:
 - { name: REVOKE,                       href: revoke.md,                     when: feature_user_and_group }
 - { name: SELECT,                       include: { mode: link, path: select/toc_p.yaml } }
 - { name: SELECT STREAM,                href: select_stream.md,              when: feature_mapreduce and process_command == "PROCESS STREAM" }
+- { name: SHOW CREATE,                  href: show_create.md }
 - { name: SUBQUERY,                     href: subquery.md,                   when: feature_subquery }
 - { name: UPDATE,                       href: update.md,                     when: feature_map_tables }
 - { name: UPSERT,                       href: upsert_into.md,                when: feature_upsert }