Rewrite YQL ALTER TABLE (#6340)

Co-authored-by: Ivan Blinkov <ivan@ydb.tech>

Author: Pseudolukian

ydb/docs/ru/core/_includes/not_allow_for_olap_note.md

@@ -1,4 +1,4 @@
-{% if oss == "true" and backend_name == "YDB" %}
+{% if oss == true and backend_name == "YDB" %}
 
 {% note alert %}
 

ydb/docs/ru/core/changelog-server.md

@@ -199,7 +199,7 @@
 
 **Что нового:**
 
-* Добавлены [параметры конфигурации потока изменения](yql/reference/syntax/alter_table.md#changefeed-options) для передачи дополнительной информации об изменениях в топик.
+* Добавлены [параметры конфигурации потока изменения](yql/reference/syntax/alter_table/changefeed.md) для передачи дополнительной информации об изменениях в топик.
 * Добавлена поддержка [переименования для таблиц](concepts/datamodel/table.md#rename) с включенным TTL.
 * Добавлено [управление временем хранения записей](concepts/cdc.md#retention-period) для потока изменений.
 

ydb/docs/ru/core/concepts/_includes/secondary_indexes.md

@@ -51,8 +51,8 @@
 Вторичный индекс может быть:
 
 - Создан при создании таблицы командой YQL [CREATE TABLE](../../yql/reference/syntax/create_table.md).
-- Добавлен к существующей таблице командой YQL [ALTER TABLE](../../yql/reference/syntax/alter_table.md) или командой YDB CLI [table index add](../../reference/ydb-cli/commands/secondary_index.md#add)
-- Удален у существующей таблицы командой YQL [ALTER TABLE](../../yql/reference/syntax/alter_table.md) или командой YDB CLI [table index drop](../../reference/ydb-cli/commands/secondary_index.md#drop).
+- Добавлен к существующей таблице командой YQL [ALTER TABLE](../../yql/reference/syntax/alter_table/index.md) или командой YDB CLI [table index add](../../reference/ydb-cli/commands/secondary_index.md#add)
+- Удален у существующей таблицы командой YQL [ALTER TABLE](../../yql/reference/syntax/alter_table/index.md) или командой YDB CLI [table index drop](../../reference/ydb-cli/commands/secondary_index.md#drop).
 - Удален вместе с таблицей командой YQL [DROP TABLE](../../yql/reference/syntax/drop_table.md) или командой YDB CLI `table drop`.
 
 ## Назначение и применение вторичных индексов {#best_practices}

ydb/docs/ru/core/concepts/cdc.md

@@ -31,7 +31,7 @@ Change Data Capture (CDC) обеспечивает захват изменени
 
 {% note info %}
 
-По умолчанию виртуальные метки времени не выгружаются в поток изменений. Для их включения используйте [соответствующий параметр](../yql/reference/syntax/alter_table.md#changefeed-options) при создании потока.
+По умолчанию виртуальные метки времени не выгружаются в поток изменений. Для их включения используйте [соответствующий параметр](../yql/reference/syntax/alter_table/changefeed.md) при создании потока.
 
 {% endnote %}
 
@@ -56,7 +56,7 @@ Change Data Capture (CDC) обеспечивает захват изменени
 
 ## Структура записи {#record-structure}
 
-В зависимости от [параметров потока](../yql/reference/syntax/alter_table.md#changefeed-options) структура записи может отличаться.
+В зависимости от [параметров потока](../yql/reference/syntax/alter_table/changefeed.md) структура записи может отличаться.
 
 ### JSON-формат {#json-record-structure}
 
@@ -214,11 +214,11 @@ Change Data Capture (CDC) обеспечивает захват изменени
 
 Удаление записей до их обработки клиентом приводит к возникновению пропусков [офсетов](topic.md#offset), то есть офсеты последней прочитанной из партиции записи и самой ранней из доступных будут отличаться более, чем на единицу.
 
-Для настройки времени хранения записей укажите параметр [RETENTION_PERIOD](../yql/reference/syntax/alter_table.md#changefeed-options) при создании потока изменений.
+Для настройки времени хранения записей укажите параметр [RETENTION_PERIOD](../yql/reference/syntax/alter_table/changefeed.md) при создании потока изменений.
 
 ## Количество партиций топика {#topic-partitions}
 
-По умолчанию количество [партиций топика](topic.md#partitioning) равно количеству партиций таблицы. Количество партиций топика можно переопределить, указав параметр [TOPIC_MIN_ACTIVE_PARTITIONS](../yql/reference/syntax/alter_table.md#changefeed-options) при создании потока изменений.
+По умолчанию количество [партиций топика](topic.md#partitioning) равно количеству партиций таблицы. Количество партиций топика можно переопределить, указав параметр [TOPIC_MIN_ACTIVE_PARTITIONS](../yql/reference/syntax/alter_table/changefeed.md) при создании потока изменений.
 
 {% note info %}
 
@@ -228,7 +228,7 @@ Change Data Capture (CDC) обеспечивает захват изменени
 
 ## Создание и удаление потока изменений {#ddl}
 
-Поток изменений может быть добавлен к существующей таблице или удален директивами [ADD CHANGEFEED и DROP CHANGEFEED](../yql/reference/syntax/alter_table.md#changefeed) операции YQL `ALTER TABLE`. При удалении таблицы добавленный к ней поток изменений также будет удален.
+Поток изменений может быть добавлен к существующей таблице или удален директивами [ADD CHANGEFEED и DROP CHANGEFEED](../yql/reference/syntax/alter_table/changefeed.md) операции YQL `ALTER TABLE`. При удалении таблицы добавленный к ней поток изменений также будет удален.
 
 ## Назначение и применение CDC {#best_practices}
 

ydb/docs/ru/core/concepts/datamodel/_includes/table.md

@@ -144,7 +144,7 @@ YDB поддерживает создание строковых и колоно
 
 Скорость выполнения переименования определяется типом дата-транзакций, которые выполняются в данный момент на таблице, и не зависит от количества данных в таблице.
 
-* [Переименование таблицы в YQL](../../../yql/reference/syntax/alter_table.md#rename)
+* [Переименование таблицы в YQL](../../../yql/reference/syntax/alter_table/rename.md)
 * [Переименование таблицы через CLI](../../../reference/ydb-cli/commands/tools/rename.md)
 
 ### Фильтр Блума {#bloom-filter}
@@ -159,7 +159,7 @@ YDB поддерживает создание строковых и колоно
 
 {{ ydb-short-name }} позволяет группировать колонки в таблице для оптимизации их хранения и использования. Механизм групп колонок позволяет увеличить производительность операций неполного чтения строк путем разделения хранения колонок таблицы на насколько групп. Наиболее часто используемый сценарий — организация хранения редко используемых атрибутов в отдельной группе колонок (и, возможно, с использованием сжатия и на более медленных устройствах хранения данных).
 
-У каждой группы колонок есть собственное имя, уникальное в рамках таблицы. Состав групп колонок устанавливается при [создании таблицы](../../../yql/reference/syntax/create_table.md#column-family), а также может быть [изменен](../../../yql/reference/syntax/alter_table.md#column-family) позднее. Удаление групп колонок из существующей таблицы не предусмотрено.
+У каждой группы колонок есть собственное имя, уникальное в рамках таблицы. Состав групп колонок устанавливается при [создании таблицы](../../../yql/reference/syntax/create_table.md#column-family), а также может быть [изменен](../../../yql/reference/syntax/alter_table/family.md) позднее. Удаление групп колонок из существующей таблицы не предусмотрено.
 
 Группа колонок может содержать произвольное число колонок своей таблицы, в том числе не содержать ни одной. Каждая колонка таблицы принадлежит одной, и только одной группе колонок (группы колонок не пересекаются). Принадлежность колонок группам устанавливается при создании таблицы, но может быть изменена позднее.
 

ydb/docs/ru/core/deploy/configuration/config.md

@@ -174,7 +174,7 @@ domains_config:
   # ...
 ```
 
-Каждой базе данных в кластере назначается как минимум один из доступных пулов хранения, выбираемый в операции создания базы данных. Имена пулов хранения среди назначенных могут быть использованы в атрибуте `DATA` при определении групп колонок в операторах YQL [`CREATE TABLE`](../../yql/reference/syntax/create_table.md#column-family)/[`ALTER TABLE`](../../yql/reference/syntax/alter_table.md#column-family).
+Каждой базе данных в кластере назначается как минимум один из доступных пулов хранения, выбираемый в операции создания базы данных. Имена пулов хранения среди назначенных могут быть использованы в атрибуте `DATA` при определении групп колонок в операторах YQL [`CREATE TABLE`](../../yql/reference/syntax/create_table.md#column-family)/[`ALTER TABLE`](../../yql/reference/syntax/alter_table/family.md).
 
 ### Конфигурация State Storage {#domains-state}
 

ydb/docs/ru/core/dev/cdc.md

@@ -4,7 +4,7 @@
 
 ## Включение и выключение CDC {#add-drop}
 
-CDC представлен объектом схемы данных — потоком изменений, который может быть добавлен к таблице или удален директивами [ADD CHANGEFEED и DROP CHANGEFEED](../yql/reference/syntax/alter_table.md#changefeed) операции YQL `ALTER TABLE`.
+CDC представлен объектом схемы данных — потоком изменений, который может быть добавлен к таблице или удален директивами [ADD CHANGEFEED и DROP CHANGEFEED](../yql/reference/syntax/alter_table/changefeed.md) операции YQL `ALTER TABLE`.
 
 ## Чтение из топика {#read}
 
@@ -44,7 +44,7 @@ CDC представлен объектом схемы данных — пото
 
 * формирование записи и сохранение ее в поток изменений;
 * хранением записей в потоке изменений;
-* в некоторых [режимах](../yql/reference/syntax/alter_table.md#changefeed-options) (например, `OLD_IMAGE`, `NEW_AND_OLD_IMAGES`) возникает необходимость предварительного чтения данных, даже если пользовательский запрос этого не предполагает.
+* в некоторых [режимах](../yql/reference/syntax/alter_table/changefeed.md) (например, `OLD_IMAGE`, `NEW_AND_OLD_IMAGES`) возникает необходимость предварительного чтения данных, даже если пользовательский запрос этого не предполагает.
 
 Это может вызывать увеличение времени исполнения запросов, а также превышение лимитов на размер хранимых данных.
 

ydb/docs/ru/core/dev/secondary-indexes.md

@@ -12,7 +12,7 @@
 
 ## Создание вторичных индексов {#create}
 
-Вторичный индекс является объектом схемы данных и может быть определен при создании таблицы [командой YQL `CREATE TABLE`](../yql/reference/syntax/create_table.md), или добавлен к ней позднее [командой YQL `ALTER TABLE`](../yql/reference/syntax/alter_table.md).
+Вторичный индекс является объектом схемы данных и может быть определен при создании таблицы [командой YQL `CREATE TABLE`](../yql/reference/syntax/create_table.md), или добавлен к ней позднее [командой YQL `ALTER TABLE`](../yql/reference/syntax/alter_table/index.md).
 
 Команда [создания индекса `table index add`](../reference/ydb-cli/commands/secondary_index.md#add) поддерживается в YDB CLI.
 

ydb/docs/ru/core/integrations/flyway.md

@@ -294,7 +294,7 @@ flyway -url=jdbc:ydb:grpc://localhost:2136/local -locations=db/migration migrate
 
 ![_assets/flyway-migrate-step-1.png](_assets/flyway-migrate-step-1.png)
 
-Затем мы изменяем схему, добавляя [вторичный индекс](../yql/reference/syntax/alter_table.md) в таблицу `series`:
+Затем мы изменяем схему, добавляя [вторичный индекс](../yql/reference/syntax/alter_table/index.md) в таблицу `series`:
 
 ```
 db/migration:

ydb/docs/ru/core/reference/ydb-cli/commands/_includes/secondary_index.md

@@ -8,7 +8,7 @@
 
 {% include [conn_options_ref.md](conn_options_ref.md) %}
 
-Также добавить или удалить вторичный индекс можно с помощью директив [ADD INDEX и DROP INDEX](../../../../yql/reference/syntax/alter_table.md#secondary-index) операции YQL ALTER TABLE.
+Также добавить или удалить вторичный индекс можно с помощью директив [ADD INDEX и DROP INDEX](../../../../yql/reference/syntax/alter_table/secondary_index.md) операции YQL ALTER TABLE.
 
 О назначении и применении вторичных индексов при разработке приложений можно прочитать в статье [Вторичные индексы](../../../../dev/secondary-indexes.md).