Rebase EN version of ALTER TABLE (#9123)

Author: Pseudolukian

ydb/docs/en/core/_includes/ways_add_data_to_olap.md

@@ -0,0 +1,9 @@
+{% if oss %}
+
+Available methods for loading data into columnar tables:
+
+* [{{ ydb-short-name }} CLI](../reference/ydb-cli/export-import/import-file.md)
+* [Bulk data upsert](../recipes/ydb-sdk/bulk-upsert.md)
+* [Yandex Data Transfer](https://yandex.cloud/ru/services/data-transfer)
+
+{% endif %}

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

@@ -199,7 +199,7 @@ Release date: March 7, 2023. To update to version **22.5**, select the [Download
 
 ### What's new
 
-* Added [changefeed configuration parameters](yql/reference/syntax/alter_table.md#changefeed-options) to transfer additional information about changes to a topic.
+* Added [changefeed configuration parameters](yql/reference/syntax/alter_table/changefeed.md) to transfer additional information about changes to a topic.
 * You can now [rename tables](concepts/datamodel/table.md#rename) that have TTL enabled.
 * You can now [manage the record retention period](concepts/cdc.md#retention-period).
 

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

@@ -53,8 +53,8 @@ Creating an index is an asynchronous operation. If the client-server connection
 A secondary index can be:
 
 - Created when creating a table with the YQL [`CREATE TABLE`](../../yql/reference/syntax/create_table/index.md) statement.
-- Added to an existing table with the YQL [`ALTER TABLE`](../../yql/reference/syntax/alter_table.md) statement or the YDB CLI [`table index add`](../../reference/ydb-cli/commands/secondary_index.md#add) command.
-- Deleted from an existing table with the YQL [`ALTER TABLE`](../../yql/reference/syntax/alter_table.md) statement or the YDB CLI [`table index drop`](../../reference/ydb-cli/commands/secondary_index.md#drop) command.
+- Added to an existing table with the YQL [`ALTER TABLE`](../../yql/reference/syntax/alter_table/index.md) statement or the YDB CLI [`table index add`](../../reference/ydb-cli/commands/secondary_index.md#add) command.
+- Deleted from an existing table with the YQL [`ALTER TABLE`](../../yql/reference/syntax/alter_table/index.md) statement or the YDB CLI [`table index drop`](../../reference/ydb-cli/commands/secondary_index.md#drop) command.
 - Deleted together with the table using the YQL [`DROP TABLE`](../../yql/reference/syntax/drop_table.md) statement or the YDB CLI `table drop` command.
 
 ## Purpose and use of secondary indexes {#best_practices}

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

@@ -32,7 +32,7 @@ Using these stamps, you can arrange records from different partitions of the top
 
 {% note info %}
 
-By default, virtual timestamps are not uploaded to the changefeed. To enable them, use the [appropriate parameter](../yql/reference/syntax/alter_table.md#changefeed-options) when creating a changefeed.
+By default, virtual timestamps are not uploaded to the changefeed. To enable them, use the [appropriate parameter](../yql/reference/syntax/alter_table/changefeed.md) when creating a changefeed.
 
 {% endnote %}
 
@@ -58,7 +58,7 @@ During the scanning process, depending on the table update frequency, you might
 
 ## Record structure {#record-structure}
 
-Depending on the [changefeed parameters](../yql/reference/syntax/alter_table.md#changefeed-options), the structure of a record may differ.
+Depending on the [changefeed parameters](../yql/reference/syntax/alter_table/changefeed.md), the structure of a record may differ.
 
 ### JSON format {#json-record-structure}
 
@@ -223,11 +223,11 @@ Records whose retention time has expired are deleted, regardless of whether they
 
 Deleting records before they are processed by the client will cause [offset](topic.md#offset) skips, which means that the offsets of the last record read from the partition and the earliest available record will differ by more than one.
 
-To set up the record retention period, specify the [RETENTION_PERIOD](../yql/reference/syntax/alter_table.md#changefeed-options) parameter when creating a changefeed.
+To set up the record retention period, specify the [RETENTION_PERIOD](../yql/reference/syntax/alter_table/changefeed.md) parameter when creating a changefeed.
 
 ## Topic partitions {#topic-partitions}
 
-By default, the number of [topic partitions](topic.md#partitioning) is equal to the number of table partitions. The number of topic partitions can be redefined by specifying [TOPIC_MIN_ACTIVE_PARTITIONS](../yql/reference/syntax/alter_table.md#changefeed-options) parameter when creating a changefeed.
+By default, the number of [topic partitions](topic.md#partitioning) is equal to the number of table partitions. The number of topic partitions can be redefined by specifying [TOPIC_MIN_ACTIVE_PARTITIONS](../yql/reference/syntax/alter_table/changefeed.md) parameter when creating a changefeed.
 
 {% note info %}
 
@@ -237,7 +237,7 @@ Currently, the ability to explicitly specify the number of topic partitions is a
 
 ## Creating and deleting a changefeed {#ddl}
 
-You can add a changefeed to an existing table or erase it using the [ADD CHANGEFEED and DROP CHANGEFEED](../yql/reference/syntax/alter_table.md#changefeed) directives of the YQL `ALTER TABLE` statement. When erasing a table, the changefeed added to it is also deleted.
+You can add a changefeed to an existing table or erase it using the [ADD CHANGEFEED and DROP CHANGEFEED](../yql/reference/syntax/alter_table/changefeed.md) directives of the YQL `ALTER TABLE` statement. When erasing a table, the changefeed added to it is also deleted.
 
 ## CDC purpose and use {#best_practices}
 

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

@@ -151,7 +151,7 @@ Operations are performed in isolation, the external process sees only two states
 
 The speed of renaming is determined by the type of data transactions currently running against the table and doesn't depend on the table size.
 
-* [Renaming a table in YQL](../../../yql/reference/syntax/alter_table.md#rename)
+* [Renaming a table in YQL](../../../yql/reference/syntax/alter_table/rename.md)
 * [Renaming a table via the CLI](../../../reference/ydb-cli/commands/tools/rename.md)
 
 ### Bloom filter {#bloom-filter}

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

@@ -174,7 +174,7 @@ The following [fault tolerance modes](../../concepts/topology.md) are available:
   ...
 ```
 
-Each database in the cluster is assigned at least one of the available storage pools selected in the database creation operation. The names of storage pools among those assigned can be used in the `DATA` attribute when defining column groups in YQL operators [`CREATE TABLE`](../../yql/reference/syntax/create_table/family.md)/[`ALTER TABLE`](../../yql/reference/syntax/alter_table.md#column-family).
+Each database in the cluster is assigned at least one of the available storage pools selected in the database creation operation. The names of storage pools among those assigned can be used in the `DATA` attribute when defining column groups in YQL operators [`CREATE TABLE`](../../yql/reference/syntax/create_table/family.md)/[`ALTER TABLE`](../../yql/reference/syntax/alter_table/family.md).
 
 ### State Storage configuration {#domains-state}
 

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

@@ -4,7 +4,7 @@ With [Change Data Capture](../concepts/cdc.md) (CDC), you can track changes in t
 
 ## Enabling and disabling CDC {#add-drop}
 
-CDC is represented as a data schema object: a changefeed that can be added to a table or deleted from them using the [ADD CHANGEFEED and DROP CHANGEFEED](../yql/reference/syntax/alter_table.md#changefeed) directives of the YQL `ALTER TABLE` statement.
+CDC is represented as a data schema object: a changefeed that can be added to a table or deleted from them using the [ADD CHANGEFEED and DROP CHANGEFEED](../yql/reference/syntax/alter_table/changefeed.md) directives of the YQL `ALTER TABLE` statement.
 
 ## Reading data from a topic {#read}
 
@@ -44,7 +44,7 @@ When writing data to a table with CDC enabled, there are additional overheads fo
 
 * Making records and saving them to a changefeed.
 * Storing records in a changefeed.
-* In some [modes](../yql/reference/syntax/alter_table.md#changefeed-options) (such as `OLD_IMAGE` and `NEW_AND_OLD_IMAGES`), data needs to be pre-fetched even if a user query doesn't require this.
+* In some [modes](../yql/reference/syntax/alter_table/changefeed.md) (such as `OLD_IMAGE` and `NEW_AND_OLD_IMAGES`), data needs to be pre-fetched even if a user query doesn't require this.
 
 As a result, queries may take longer to execute and size limits for stored data may be exceeded.
 

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

@@ -12,7 +12,7 @@ This article describes the main operations with secondary indexes and gives refe
 
 ## Creating secondary indexes {#create}
 
-A secondary index is a data schema object that can be defined when creating a table with the [`CREATE TABLE` YQL command](../yql/reference/syntax/create_table/index.md) or added to it later with the [`ALTER TABLE` YQL command](../yql/reference/syntax/alter_table.md).
+A secondary index is a data schema object that can be defined when creating a table with the [`CREATE TABLE` YQL command](../yql/reference/syntax/create_table/index.md) or added to it later with the [`ALTER TABLE` YQL command](../yql/reference/syntax/alter_table/index.md).
 
 The [`table index add` command](../reference/ydb-cli/commands/secondary_index.md#add) is supported in the {{ ydb-short-name }} CLI.
 

ydb/docs/en/core/integrations/migration/flyway.md

@@ -294,7 +294,7 @@ As a result, `series`, `season`, and `episode` tables will be created and filled
 
 ![_assets/flyway-migrate-step-1.png](_assets/flyway-migrate-step-1.png)
 
-Then, we evolve the schema by adding a [secondary index](../../yql/reference/syntax/alter_table.md) to the `series` table:
+Then, we evolve the schema by adding a [secondary index](../../yql/reference/syntax/alter_table/index.md) to the `series` table:
 
 ```
 db/migration:

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

@@ -8,7 +8,7 @@ By using the `table index` command, you can create and delete [secondary indexes
 
 {% include [conn_options_ref.md](conn_options_ref.md) %}
 
-You can also add or delete a secondary index with the [ADD INDEX and DROP INDEX](../../../../yql/reference/syntax/alter_table.md#secondary-index) directives of YQL ALTER TABLE.
+You can also add or delete a secondary index with the [ADD INDEX and DROP INDEX](../../../../yql/reference/syntax/alter_table/secondary_index.md) directives of YQL ALTER TABLE.
 
 To learn about secondary indexes and their use in application development, see [Secondary indexes](../../../../dev/secondary-indexes.md) under "Recommendations".