romanzhukov-DOCSUP-2192: Split ALTER to separate files (ru) (#13905)

* DOCSUP-2192: Split alter section to separete files.

* DOCSUP-2192: Test.

* DOCSUP-2192: Fixed cross links.

* DOCSUP-2192: Fix links.

* DOCSUP-2192: Fix links.

* DOCSUP-2192: Fix links.

* DOCSUP-2192: Added alter delete and alter update topics.

* DOCSUP-2192: Fix one layout mistake and update links.

* DOCSUP-2192: Added delete and update sections. Updated alter index.md

* DOCSUP-2192: Fix links.
Co-authored-by: Nromanzhukov <romanzhukov@yandex-team.ru>

docs/en/sql-reference/statements/alter/order-by.md

@@ -14,5 +14,4 @@ The command changes the [sorting key](../../../engines/table-engines/mergetree-f
 The command is lightweight in a sense that it only changes metadata. To keep the property that data part rows are ordered by the sorting key expression you cannot add expressions containing existing columns to the sorting key (only columns added by the `ADD COLUMN` command in the same `ALTER` query).
 
 !!! note "Note"
-    It only works for tables in the [`MergeTree`](../../../engines/table-engines/mergetree-family/mergetree.md) family (including
-[replicated](../../../engines/table-engines/mergetree-family/replication.md) tables).
+    It only works for tables in the [`MergeTree`](../../../engines/table-engines/mergetree-family/mergetree.md) family (including [replicated](../../../engines/table-engines/mergetree-family/replication.md) tables).

docs/ru/engines/table-engines/log-family/index.md

@@ -26,7 +26,7 @@ toc_priority: 29
 
         Во время запросов `INSERT` таблица блокируется, а другие запросы на чтение и запись ожидают разблокировки таблицы. Если запросов на запись данных нет, то можно выполнять любое количество конкуретных запросов на чтение.
 
--   Не поддерживают операции [мутации](../../../sql-reference/statements/alter.md#mutations).
+-   Не поддерживают операции [мутации](../../../sql-reference/statements/alter/index.md#mutations).
 
 -   Не поддерживают индексы.
 

docs/ru/engines/table-engines/mergetree-family/custom-partitioning-key.md

@@ -113,7 +113,7 @@ drwxr-xr-x 2 clickhouse clickhouse 4096 Feb  1 16:48 detached
 
 ‘201901\_1\_1\_0’, ‘201901\_1\_7\_1’ и т. д. – это директории кусков партиции. Каждый кусок содержит данные только для соответствующего месяца (таблица в данном примере содержит партиционирование по месяцам).
 
-Директория `detached` содержит куски, отсоединенные от таблицы с помощью запроса [DETACH](../../../sql-reference/statements/alter.md#alter_detach-partition). Поврежденные куски также попадают в эту директорию – они не удаляются с сервера.
+Директория `detached` содержит куски, отсоединенные от таблицы с помощью запроса [DETACH](../../../sql-reference/statements/alter/partition.md#alter_detach-partition). Поврежденные куски также попадают в эту директорию – они не удаляются с сервера.
 
 Сервер не использует куски из директории `detached`. Вы можете в любое время добавлять, удалять, модифицировать данные в директории detached - сервер не будет об этом знать, пока вы не сделаете запрос [ATTACH](../../../engines/table-engines/mergetree-family/custom-partitioning-key.md#alter_attach-partition).
 

docs/ru/engines/table-engines/mergetree-family/mergetree.md

@@ -601,7 +601,7 @@ SETTINGS storage_policy = 'moving_from_ssd_to_hdd'
 В таблицах `MergeTree` данные попадают на диск несколькими способами:
 
 -   В результате вставки (запрос `INSERT`).
--   В фоновых операциях слияний и [мутаций](../../../sql-reference/statements/alter.md#mutations).
+-   В фоновых операциях слияний и [мутаций](../../../sql-reference/statements/alter/index.md#mutations).
 -   При скачивании данных с другой реплики.
 -   В результате заморозки партиций [ALTER TABLE … FREEZE PARTITION](../../../engines/table-engines/mergetree-family/mergetree.md#alter_freeze-partition).
 

docs/ru/operations/access-rights.md

@@ -56,7 +56,7 @@ ClickHouse поддерживает управление доступом на
 Запросы управления:
 
 - [CREATE USER](../sql-reference/statements/create/user.md#create-user-statement)
-- [ALTER USER](../sql-reference/statements/alter.md#alter-user-statement)
+- [ALTER USER](../sql-reference/statements/alter/user.md)
 - [DROP USER](../sql-reference/statements/misc.md#drop-user-statement)
 - [SHOW CREATE USER](../sql-reference/statements/show.md#show-create-user-statement)
 
@@ -83,7 +83,7 @@ ClickHouse поддерживает управление доступом на
 Запросы управления:
 
 - [CREATE ROLE](../sql-reference/statements/create/index.md#create-role-statement)
-- [ALTER ROLE](../sql-reference/statements/alter.md#alter-role-statement)
+- [ALTER ROLE](../sql-reference/statements/alter/role.md)
 - [DROP ROLE](../sql-reference/statements/misc.md#drop-role-statement)
 - [SET ROLE](../sql-reference/statements/misc.md#set-role-statement)
 - [SET DEFAULT ROLE](../sql-reference/statements/misc.md#set-default-role-statement)
@@ -98,7 +98,7 @@ ClickHouse поддерживает управление доступом на
 Запросы управления:
 
 - [CREATE ROW POLICY](../sql-reference/statements/create/index.md#create-row-policy-statement)
-- [ALTER ROW POLICY](../sql-reference/statements/alter.md#alter-row-policy-statement)
+- [ALTER ROW POLICY](../sql-reference/statements/alter/row-policy.md)
 - [DROP ROW POLICY](../sql-reference/statements/misc.md#drop-row-policy-statement)
 - [SHOW CREATE ROW POLICY](../sql-reference/statements/show.md#show-create-row-policy-statement)
 
@@ -110,7 +110,7 @@ ClickHouse поддерживает управление доступом на
 Запросы управления:
 
 - [CREATE SETTINGS PROFILE](../sql-reference/statements/create/index.md#create-settings-profile-statement)
-- [ALTER SETTINGS PROFILE](../sql-reference/statements/alter.md#alter-settings-profile-statement)
+- [ALTER SETTINGS PROFILE](../sql-reference/statements/alter/settings-profile.md)
 - [DROP SETTINGS PROFILE](../sql-reference/statements/misc.md#drop-settings-profile-statement)
 - [SHOW CREATE SETTINGS PROFILE](../sql-reference/statements/show.md#show-create-settings-profile-statement)
 
@@ -124,7 +124,7 @@ ClickHouse поддерживает управление доступом на
 Запросы управления:
 
 - [CREATE QUOTA](../sql-reference/statements/create/index.md#create-quota-statement)
-- [ALTER QUOTA](../sql-reference/statements/alter.md#alter-quota-statement)
+- [ALTER QUOTA](../sql-reference/statements/alter/quota.md)
 - [DROP QUOTA](../sql-reference/statements/misc.md#drop-quota-statement)
 - [SHOW CREATE QUOTA](../sql-reference/statements/show.md#show-create-quota-statement)
 

docs/ru/operations/backup.md

@@ -27,7 +27,7 @@
 
 ClickHouse позволяет использовать запрос `ALTER TABLE ... FREEZE PARTITION ...` для создания локальной копии партиций таблицы. Это реализуется с помощью жестких ссылок (hardlinks) на каталог `/var/lib/clickhouse/shadow/`, поэтому такая копия обычно не занимает дополнительное место на диске для старых данных. Созданные копии файлов не обрабатываются сервером ClickHouse, поэтому вы можете просто оставить их там: у вас будет простая резервная копия, которая не требует дополнительной внешней системы, однако при аппаратных проблемах вы можете утратить и актуальные данные и сохраненную копию. По этой причине, лучше удаленно скопировать их в другое место, а затем удалить локальную копию. Распределенные файловые системы и хранилища объектов по-прежнему являются хорошими вариантами для этого, однако можно использовать и обычные присоединенные файловые серверы с достаточно большой ёмкостью (в этом случае передача будет происходить через сетевую файловую систему или, возможно, [rsync](https://en.wikipedia.org/wiki/Rsync)).
 
-Дополнительные сведения о запросах, связанных с манипуляциями партициями, см. в разделе [ALTER](../sql-reference/statements/alter.md#alter_manipulations-with-partitions).
+Дополнительные сведения о запросах, связанных с манипуляциями партициями, см. в разделе [ALTER](../sql-reference/statements/alter/partition.md#alter_manipulations-with-partitions).
 
 Для автоматизации этого подхода доступен инструмент от сторонних разработчиков: [clickhouse-backup](https://github.com/AlexAkulov/clickhouse-backup).
 

docs/ru/operations/settings/settings.md

@@ -1606,7 +1606,7 @@ SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
 
 ## mutations_sync {#mutations_sync}
 
-Позволяет выполнять запросы `ALTER TABLE ... UPDATE|DELETE` ([мутации](../../sql-reference/statements/alter.md#mutations)) синхронно.
+Позволяет выполнять запросы `ALTER TABLE ... UPDATE|DELETE` ([мутации](../../sql-reference/statements/alter/index.md#mutations)) синхронно.
 
 Возможные значения:
 
@@ -1618,8 +1618,8 @@ SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
 
 **См. также**
 
--   [Синхронность запросов ALTER](../../sql-reference/statements/alter.md#synchronicity-of-alter-queries)
--   [Мутации](../../sql-reference/statements/alter.md#mutations)
+-   [Синхронность запросов ALTER](../../sql-reference/statements/alter/index.md#synchronicity-of-alter-queries)
+-   [Мутации](../../sql-reference/statements/alter/index.md#mutations)
 
 
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/settings/settings/) <!--hide-->

docs/ru/operations/system-tables/mutations.md

 # system.mutations {#system_tables-mutations}
 
-Таблица содержит информацию о ходе выполнения [мутаций](../../sql-reference/statements/alter.md#mutations) таблиц семейства MergeTree. Каждой команде мутации соответствует одна строка таблицы. 
+Таблица содержит информацию о ходе выполнения [мутаций](../../sql-reference/statements/alter/index.md#mutations) таблиц семейства MergeTree. Каждой команде мутации соответствует одна строка таблицы. 
 
 Столбцы:
 
@@ -41,7 +41,7 @@
 
 **См. также**
 
--   [Мутации](../../sql-reference/statements/alter.md#mutations)
+-   [Мутации](../../sql-reference/statements/alter/index.md#mutations)
 -   [Движок MergeTree](../../engines/table-engines/mergetree-family/mergetree.md)
 -   [Репликация данных](../../engines/table-engines/mergetree-family/replication.md) (семейство ReplicatedMergeTree)
 

docs/ru/operations/system-tables/part_log.md

@@ -10,7 +10,7 @@
     -   `NEW_PART` — вставка нового куска.
     -   `MERGE_PARTS` — слияние кусков.
     -   `DOWNLOAD_PART` — загрузка с реплики.
-    -   `REMOVE_PART` — удаление или отсоединение из таблицы с помощью [DETACH PARTITION](../../sql-reference/statements/alter.md#alter_detach-partition).
+    -   `REMOVE_PART` — удаление или отсоединение из таблицы с помощью [DETACH PARTITION](../../sql-reference/statements/alter/partition.md#alter_detach-partition).
     -   `MUTATE_PART` — изменение куска.
     -   `MOVE_PART` — перемещение куска между дисками.
 -   `event_date` (Date) — дата события.

docs/ru/operations/system-tables/parts.md

@@ -6,7 +6,7 @@
 
 Столбцы:
 
--   `partition` ([String](../../sql-reference/data-types/string.md)) – имя партиции. Что такое партиция можно узнать из описания запроса [ALTER](../../sql-reference/statements/alter.md#query_language_queries_alter).
+-   `partition` ([String](../../sql-reference/data-types/string.md)) – имя партиции. Что такое партиция можно узнать из описания запроса [ALTER](../../sql-reference/statements/alter/index.md#query_language_queries_alter).
 
     Форматы:
 
@@ -66,7 +66,7 @@
 
 -   `primary_key_bytes_in_memory_allocated` ([UInt64](../../sql-reference/data-types/int-uint.md)) – объём памяти (в байтах) выделенный для размещения первичных ключей.
 
--   `is_frozen` ([UInt8](../../sql-reference/data-types/int-uint.md)) – Признак, показывающий существование бэкапа партиции. 1, бэкап есть. 0, бэкапа нет. Смотрите раздел [FREEZE PARTITION](../../sql-reference/statements/alter.md#alter_freeze-partition).
+-   `is_frozen` ([UInt8](../../sql-reference/data-types/int-uint.md)) – Признак, показывающий существование бэкапа партиции. 1, бэкап есть. 0, бэкапа нет. Смотрите раздел [FREEZE PARTITION](../../sql-reference/statements/alter/partition.md#alter_freeze-partition).
 
 -   `database` ([String](../../sql-reference/data-types/string.md)) – имя базы данных.
 

docs/ru/sql-reference/index.md

@@ -10,7 +10,7 @@ toc_title: hidden
 -   [SELECT](statements/select/index.md)
 -   [INSERT INTO](statements/insert-into.md)
 -   [CREATE](statements/create/index.md)
--   [ALTER](statements/alter.md#query_language_queries_alter)
+-   [ALTER](statements/alter/index.md#query_language_queries_alter)
 -   [Прочие виды запросов](statements/misc.md)
 
 [Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/) <!--hide-->

docs/ru/sql-reference/statements/alter/column.md

+---
+toc_priority: 37
+toc_title: COLUMN
+---
+
+# Манипуляции со столбцами {#manipuliatsii-so-stolbtsami}
+
+Существуют следующие действия:
+
+-   [ADD COLUMN](#alter_add-column) — добавляет столбец в таблицу;
+-   [DROP COLUMN](#alter_drop-column) — удаляет столбец;
+-   [CLEAR COLUMN](#alter_clear-column) — сбрасывает все значения в столбце для заданной партиции;
+-   [COMMENT COLUMN](#alter_comment-column) — добавляет комментарий к столбцу;
+-   [MODIFY COLUMN](#alter_modify-column) — изменяет тип столбца, выражение для значения по умолчанию и TTL.
+
+Подробное описание для каждого действия приведено ниже.
+
+## ADD COLUMN {#alter_add-column}
+
+``` sql
+ADD COLUMN [IF NOT EXISTS] name [type] [default_expr] [codec] [AFTER name_after]
+```
+
+Добавляет в таблицу новый столбец с именем `name`, типом `type`, [кодеком](../create/table.md#codecs) `codec` и выражением для умолчания `default_expr` (смотрите раздел [Значения по умолчанию](../create/index.md#create-default-values)).
+
+Если указано `IF NOT EXISTS`, запрос не будет возвращать ошибку, если столбец уже существует. Если указано `AFTER name_after` (имя другого столбца), то столбец добавляется (в список столбцов таблицы) после указанного. Иначе, столбец добавляется в конец таблицы. Обратите внимание, ClickHouse не позволяет добавлять столбцы в начало таблицы. Для цепочки действий, `name_after` может быть именем столбца, который добавляется в одном из предыдущих действий.
+
+Добавление столбца всего лишь меняет структуру таблицы, и не производит никаких действий с данными - соответствующие данные не появляются на диске после ALTER-а. При чтении из таблицы, если для какого-либо столбца отсутствуют данные, то он заполняется значениями по умолчанию (выполняя выражение по умолчанию, если такое есть, или нулями, пустыми строками). Также, столбец появляется на диске при слиянии кусков данных (см. [MergeTree](../../../sql-reference/statements/alter/index.md)).
+
+Такая схема позволяет добиться мгновенной работы запроса `ALTER` и отсутствия необходимости увеличивать объём старых данных.
+
+Пример:
+
+``` sql
+ALTER TABLE visits ADD COLUMN browser String AFTER user_id
+```
+
+## DROP COLUMN {#alter_drop-column}
+
+``` sql
+DROP COLUMN [IF EXISTS] name
+```
+
+Удаляет столбец с именем `name`. Если указано `IF EXISTS`, запрос не будет возвращать ошибку, если столбца не существует.
+
+Запрос удаляет данные из файловой системы. Так как это представляет собой удаление целых файлов, запрос выполняется почти мгновенно.
+
+Пример:
+
+``` sql
+ALTER TABLE visits DROP COLUMN browser
+```
+
+## CLEAR COLUMN {#alter_clear-column}
+
+``` sql
+CLEAR COLUMN [IF EXISTS] name IN PARTITION partition_name
+```
+
+Сбрасывает все значения в столбце для заданной партиции. Если указано `IF EXISTS`, запрос не будет возвращать ошибку, если столбца не существует.
+
+Как корректно задать имя партиции, см. в разделе [Как задавать имя партиции в запросах ALTER](#alter-how-to-specify-part-expr).
+
+Пример:
+
+``` sql
+ALTER TABLE visits CLEAR COLUMN browser IN PARTITION tuple()
+```
+
+## COMMENT COLUMN {#alter_comment-column}
+
+``` sql
+COMMENT COLUMN [IF EXISTS] name 'Text comment'
+```
+
+Добавляет комментарий к таблице. Если указано `IF EXISTS`, запрос не будет возвращать ошибку, если столбца не существует.
+
+Каждый столбец может содержать только один комментарий. При выполнении запроса существующий комментарий заменяется на новый.
+
+Посмотреть комментарии можно в столбце `comment_expression` из запроса [DESCRIBE TABLE](../misc.md#misc-describe-table).
+
+Пример:
+
+``` sql
+ALTER TABLE visits COMMENT COLUMN browser 'Столбец показывает, из каких браузеров пользователи заходили на сайт.'
+```
+
+## MODIFY COLUMN {#alter_modify-column}
+
+``` sql
+MODIFY COLUMN [IF EXISTS] name [type] [default_expr] [TTL]
+```
+
+Запрос изменяет следующие свойства столбца `name`:
+
+-   Тип
+
+-   Значение по умолчанию
+
+-   TTL
+
+        Примеры изменения TTL столбца смотрите в разделе [TTL столбца](ttl.md#mergetree-column-ttl).
+
+Если указано `IF EXISTS`, запрос не возвращает ошибку, если столбца не существует.
+
+При изменении типа, значения преобразуются так, как если бы к ним была применена функция [toType](../../../sql-reference/statements/alter/index.md). Если изменяется только выражение для умолчания, запрос не делает никакой сложной работы и выполняется мгновенно.
+
+Пример запроса:
+
+``` sql
+ALTER TABLE visits MODIFY COLUMN browser Array(String)
+```
+
+Изменение типа столбца - это единственное действие, которое выполняет сложную работу - меняет содержимое файлов с данными. Для больших таблиц, выполнение может занять длительное время.
+
+Выполнение производится в несколько стадий:
+
+-   подготовка временных (новых) файлов с изменёнными данными;
+-   переименование старых файлов;
+-   переименование временных (новых) файлов в старые;
+-   удаление старых файлов.
+
+Из них, длительной является только первая стадия. Если на этой стадии возникнет сбой, то данные не поменяются.
+Если на одной из следующих стадий возникнет сбой, то данные будет можно восстановить вручную. За исключением случаев, когда старые файлы удалены из файловой системы, а данные для новых файлов не доехали на диск и потеряны.
+
+Запрос `ALTER` на изменение столбцов реплицируется. Соответствующие инструкции сохраняются в ZooKeeper, и затем каждая реплика их применяет. Все запросы `ALTER` выполняются в одном и том же порядке. Запрос ждёт выполнения соответствующих действий на всех репликах. Но при этом, запрос на изменение столбцов в реплицируемой таблице можно прервать, и все действия будут осуществлены асинхронно.
+
+## Ограничения запроса ALTER {#ogranicheniia-zaprosa-alter}
+
+Запрос `ALTER` позволяет создавать и удалять отдельные элементы (столбцы) вложенных структур данных, но не вложенные структуры данных целиком. Для добавления вложенной структуры данных, вы можете добавить столбцы с именем вида `name.nested_name` и типом `Array(T)` - вложенная структура данных полностью эквивалентна нескольким столбцам-массивам с именем, имеющим одинаковый префикс до точки.
+
+Отсутствует возможность удалять столбцы, входящие в первичный ключ или ключ для сэмплирования (в общем, входящие в выражение `ENGINE`). Изменение типа у столбцов, входящих в первичный ключ возможно только в том случае, если это изменение не приводит к изменению данных (например, разрешено добавление значения в Enum или изменение типа с `DateTime` на `UInt32`).
+
+Если возможностей запроса `ALTER` не хватает для нужного изменения таблицы, вы можете создать новую таблицу, скопировать туда данные с помощью запроса [INSERT SELECT](../insert-into.md#insert_query_insert-select), затем поменять таблицы местами с помощью запроса [RENAME](../misc.md#misc_operations-rename), и удалить старую таблицу. В качестве альтернативы для запроса `INSERT SELECT`, можно использовать инструмент [clickhouse-copier](../../../sql-reference/statements/alter/index.md).
+
+Запрос `ALTER` блокирует все чтения и записи для таблицы. То есть, если на момент запроса `ALTER`, выполнялся долгий `SELECT`, то запрос `ALTER` сначала дождётся его выполнения. И в это время, все новые запросы к той же таблице, будут ждать, пока завершится этот `ALTER`.
+
+Для таблиц, которые не хранят данные самостоятельно (типа [Merge](../../../sql-reference/statements/alter/index.md) и [Distributed](../../../sql-reference/statements/alter/index.md)), `ALTER` всего лишь меняет структуру таблицы, но не меняет структуру подчинённых таблиц. Для примера, при ALTER-е таблицы типа `Distributed`, вам также потребуется выполнить запрос `ALTER` для таблиц на всех удалённых серверах.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/column/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/constraint.md

+---
+toc_priority: 43
+toc_title: CONSTRAINT
+---
+
+# Манипуляции с ограничениями (constraints) {#manipuliatsii-s-ogranicheniiami-constraints}
+
+Про ограничения подробнее написано [тут](../create/table.md#constraints).
+
+Добавить или удалить ограничение можно с помощью запросов
+
+``` sql
+ALTER TABLE [db].name ADD CONSTRAINT constraint_name CHECK expression;
+ALTER TABLE [db].name DROP CONSTRAINT constraint_name;
+```
+
+Запросы выполняют добавление или удаление метаданных об ограничениях таблицы `[db].name`, поэтому выполняются мгновенно.
+
+Если ограничение появилось для непустой таблицы, то *проверка ограничения для имеющихся данных не производится*.
+
+Запрос на изменение ограничений для Replicated таблиц реплицируется, сохраняя новые метаданные в ZooKeeper и применяя изменения на всех репликах.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/constraint/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/delete.md

+---
+toc_priority: 39
+toc_title: DELETE
+---
+
+# ALTER TABLE … DELETE {#alter-mutations}
+
+``` sql
+ALTER TABLE [db.]table [ON CLUSTER cluster] DELETE WHERE filter_expr
+```
+
+Позволяет удалить данные, соответствующие указанному выражению фильтрации. Реализовано как [мутация](../../../sql-reference/statements/alter/index.md#mutations).
+
+!!! note "Note"
+    Префикс `ALTER TABLE` делает этот синтаксис отличным от большинства других систем, поддерживающих SQL. Он предназначен для обозначения того, что в отличие от аналогичных запросов в базах данных OLTP это тяжелая операция, не предназначенная для частого использования.
+
+Выражение `filter_expr` должно иметь тип `UInt8`. Запрос удаляет строки в таблице, для которых это выражение принимает ненулевое значение.
+
+Один запрос может содержать несколько команд, разделенных запятыми.
+
+Синхронность обработки запроса определяется параметром [mutations_sync](../../../operations/settings/settings.md#mutations_sync). По умолчанию он является асинхронным.
+
+**Смотрите также**
+
+-   [Мутации](../../../sql-reference/statements/alter/index.md#mutations)
+-   [Синхронность запросов ALTER](../../../sql-reference/statements/alter/index.md#synchronicity-of-alter-queries)
+-   [mutations_sync](../../../operations/settings/settings.md#mutations_sync) setting
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/delete/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/index.md

+---
+toc_priority: 36
+toc_title: ALTER
+---
+
+## ALTER {#query_language_queries_alter}
+
+Изменение структуры таблицы.
+
+``` sql
+ALTER TABLE [db].name [ON CLUSTER cluster] ADD|DROP|CLEAR|COMMENT|MODIFY COLUMN ...
+```
+
+В запросе указывается список из одного или более действий через запятую.
+Каждое действие — операция над столбцом.
+
+Большинство запросов `ALTER` изменяют настройки таблицы или данные:
+
+-   [COLUMN](../../../sql-reference/statements/alter/column.md)
+-   [PARTITION](../../../sql-reference/statements/alter/partition.md)
+-   [DELETE](../../../sql-reference/statements/alter/delete.md)
+-   [UPDATE](../../../sql-reference/statements/alter/update.md)
+-   [ORDER BY](../../../sql-reference/statements/alter/order-by.md)
+-   [INDEX](../../../sql-reference/statements/alter/index/index.md)
+-   [CONSTRAINT](../../../sql-reference/statements/alter/constraint.md)
+-   [TTL](../../../sql-reference/statements/alter/ttl.md)
+
+!!! note "Note"
+    Запрос `ALTER` поддерживается только для таблиц типа `*MergeTree`, а также `Merge` и `Distributed`. Запрос имеет несколько вариантов.
+
+Следующие запросы `ALTER` изменяют сущности, связанные с управлением доступом на основе ролей:
+
+-   [USER](../../../sql-reference/statements/alter/user.md)
+-   [ROLE](../../../sql-reference/statements/alter/role.md)
+-   [QUOTA](../../../sql-reference/statements/alter/quota.md)
+-   [ROW POLICY](../../../sql-reference/statements/alter/row-policy.md)
+-   [SETTINGS PROFILE](../../../sql-reference/statements/alter/settings-profile.md)
+
+### Мутации {#mutations}
+
+Мутации - разновидность запроса ALTER, позволяющая изменять или удалять данные в таблице. В отличие от стандартных запросов [ALTER TABLE … DELETE](../../../sql-reference/statements/alter/delete.md) и [ALTER TABLE … UPDATE](../../../sql-reference/statements/alter/update.md), рассчитанных на точечное изменение данных, область применения мутаций - достаточно тяжёлые изменения, затрагивающие много строк в таблице. Поддержана для движков таблиц семейства [MergeTree](../../../engines/table-engines/mergetree-family/mergetree.md), в том числе для движков с репликацией.
+
+Конвертировать существующие таблицы для работы с мутациями не нужно. Но после применения первой мутации формат данных таблицы становится несовместимым с предыдущими версиями и откатиться на предыдущую версию уже не получится.
+
+На данный момент доступны команды:
+
+``` sql
+ALTER TABLE [db.]table MATERIALIZE INDEX name IN PARTITION partition_name
+```
+
+Команда перестроит вторичный индекс `name` для партиции `partition_name`.
+
+В одном запросе можно указать несколько команд через запятую.
+
+Для `*MergeTree`-таблиц мутации выполняются, перезаписывая данные по кускам (parts). При этом атомарности нет — куски заменяются на помутированные по мере выполнения и запрос `SELECT`, заданный во время выполнения мутации, увидит данные как из измененных кусков, так и из кусков, которые еще не были изменены.
+
+Мутации линейно упорядочены между собой и накладываются на каждый кусок в порядке добавления. Мутации также упорядочены со вставками - гарантируется, что данные, вставленные в таблицу до начала выполнения запроса мутации, будут изменены, а данные, вставленные после окончания запроса мутации, изменены не будут. При этом мутации никак не блокируют вставки.
+
+Запрос завершается немедленно после добавления информации о мутации (для реплицированных таблиц - в ZooKeeper, для нереплицированных - на файловую систему). Сама мутация выполняется асинхронно, используя настройки системного профиля. Следить за ходом её выполнения можно по таблице [`system.mutations`](../../../operations/system-tables/mutations.md#system_tables-mutations). Добавленные мутации будут выполняться до конца даже в случае перезапуска серверов ClickHouse. Откатить мутацию после её добавления нельзя, но если мутация по какой-то причине не может выполниться до конца, её можно остановить с помощью запроса [`KILL MUTATION`](../../../sql-reference/statements/kill.md#kill-mutation).
+
+Записи о последних выполненных мутациях удаляются не сразу (количество сохраняемых мутаций определяется параметром движка таблиц `finished_mutations_to_keep`). Более старые записи удаляются.
+
+### Синхронность запросов ALTER {#synchronicity-of-alter-queries}
+
+Для нереплицируемых таблиц, все запросы `ALTER` выполняются синхронно. Для реплицируемых таблиц, запрос всего лишь добавляет инструкцию по соответствующим действиям в `ZooKeeper`, а сами действия осуществляются при первой возможности. Но при этом, запрос может ждать завершения выполнения этих действий на всех репликах.
+
+Для запросов `ALTER ... ATTACH|DETACH|DROP` можно настроить ожидание, с помощью настройки `replication_alter_partitions_sync`.
+Возможные значения: `0` - не ждать, `1` - ждать выполнения только у себя (по умолчанию), `2` - ждать всех.
+
+Для запросов `ALTER TABLE ... UPDATE|DELETE` синхронность выполнения определяется настройкой [mutations_sync](../../../operations/settings/settings.md#mutations_sync). 
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/index/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/index/index.md

+---
+toc_hidden_folder: true
+toc_priority: 42
+toc_title: INDEX
+---
+
+# Манипуляции с индексами {#manipuliatsii-s-indeksami}
+
+Добавить или удалить индекс можно с помощью операций
+
+``` sql
+ALTER TABLE [db].name ADD INDEX name expression TYPE type GRANULARITY value [AFTER name]
+ALTER TABLE [db].name DROP INDEX name
+```
+
+Поддерживается только таблицами семейства `*MergeTree`.
+
+Команда `ADD INDEX` добавляет описание индексов в метаданные, а `DROP INDEX` удаляет индекс из метаданных и стирает файлы индекса с диска, поэтому они легковесные и работают мгновенно.
+
+Если индекс появился в метаданных, то он начнет считаться в последующих слияниях и записях в таблицу, а не сразу после выполнения операции `ALTER`.
+
+Запрос на изменение индексов реплицируется, сохраняя новые метаданные в ZooKeeper и применяя изменения на всех репликах.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/index/index/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/order-by.md

+---
+toc_priority: 41
+toc_title: ORDER BY
+---
+
+# Манипуляции с ключевыми выражениями таблиц {#manipuliatsii-s-kliuchevymi-vyrazheniiami-tablits}
+
+Поддерживается операция:
+
+``` sql
+MODIFY ORDER BY new_expression
+```
+
+Работает только для таблиц семейства [`MergeTree`](../../../sql-reference/statements/alter/index.md) (в том числе [реплицированных](../../../sql-reference/statements/alter/index.md)). После выполнения запроса
+[ключ сортировки](../../../sql-reference/statements/alter/index.md) таблицы
+заменяется на `new_expression` (выражение или кортеж выражений). Первичный ключ при этом остаётся прежним.
+
+Операция затрагивает только метаданные. Чтобы сохранить свойство упорядоченности кусков данных по ключу
+сортировки, разрешено добавлять в ключ только новые столбцы (т.е. столбцы, добавляемые командой `ADD COLUMN`
+в том же запросе `ALTER`), у которых нет выражения по умолчанию.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/order-by/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/quota.md

+---
+toc_priority: 46
+toc_title: QUOTA
+---
+
+# ALTER QUOTA {#alter-quota-statement}
+
+Изменяет квоту.
+
+## Синтаксис {#alter-quota-syntax}
+
+``` sql
+ALTER QUOTA [IF EXISTS] name [ON CLUSTER cluster_name]
+    [RENAME TO new_name]
+    [KEYED BY {'none' | 'user name' | 'ip address' | 'client key' | 'client key or user name' | 'client key or ip address'}]
+    [FOR [RANDOMIZED] INTERVAL number {SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR}
+        {MAX { {QUERIES | ERRORS | RESULT ROWS | RESULT BYTES | READ ROWS | READ BYTES | EXECUTION TIME} = number } [,...] |
+        NO LIMITS | TRACKING ONLY} [,...]]
+    [TO {role [,...] | ALL | ALL EXCEPT role [,...]}]
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/quota/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/role.md

+---
+toc_priority: 46
+toc_title: ROLE
+---
+
+# ALTER ROLE {#alter-role-statement}
+
+Изменяет роль.
+
+## Синтаксис {#alter-role-syntax}
+
+``` sql
+ALTER ROLE [IF EXISTS] name [ON CLUSTER cluster_name]
+    [RENAME TO new_name]
+    [SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [READONLY|WRITABLE] | PROFILE 'profile_name'] [,...]
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/role/) <!--hide-->

docs/ru/sql-reference/statements/alter/row-policy.md

+---
+toc_priority: 47
+toc_title: ROW POLICY
+---
+
+# ALTER ROW POLICY {#alter-row-policy-statement}
+
+Изменяет политику доступа к строкам.
+
+## Синтаксис {#alter-row-policy-syntax}
+
+``` sql
+ALTER [ROW] POLICY [IF EXISTS] name [ON CLUSTER cluster_name] ON [database.]table
+    [RENAME TO new_name]
+    [AS {PERMISSIVE | RESTRICTIVE}]
+    [FOR SELECT]
+    [USING {condition | NONE}][,...]
+    [TO {role [,...] | ALL | ALL EXCEPT role [,...]}]
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/row-policy/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/settings-profile.md

+---
+toc_priority: 48
+toc_title: SETTINGS PROFILE
+---
+
+# ALTER SETTINGS PROFILE {#alter-settings-profile-statement}
+
+Изменяет профили настроек.
+
+## Синтаксис {#alter-settings-profile-syntax}
+
+``` sql
+ALTER SETTINGS PROFILE [IF EXISTS] name [ON CLUSTER cluster_name]
+    [RENAME TO new_name]
+    [SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [READONLY|WRITABLE] | INHERIT 'profile_name'] [,...]
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/settings-profile) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/ttl.md

+---
+toc_priority: 44
+toc_title: TTL
+---
+
+#  Манипуляции с TTL таблицы {#manipuliatsii-s-ttl-tablitsy}
+
+Вы можете изменить [TTL для таблицы](../../../engines/table-engines/mergetree-family/mergetree.md#mergetree-column-ttl) запросом следующего вида:
+
+``` sql
+ALTER TABLE table-name MODIFY TTL ttl-expression
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/ttl/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/update.md

+---
+toc_priority: 40
+toc_title: UPDATE
+---
+
+# ALTER TABLE … UPDATE {#alter-table-update-statements}
+
+``` sql
+ALTER TABLE [db.]table UPDATE column1 = expr1 [, ...] WHERE filter_expr
+```
+
+Позволяет манипулировать данными, соответствующими заданному выражению фильтрации. Реализовано как [мутация](../../../sql-reference/statements/alter/index.md#mutations).
+
+!!! note "Note"
+    Префикс `ALTER TABLE` делает этот синтаксис отличным от большинства других систем, поддерживающих SQL. Он предназначен для обозначения того, что в отличие от аналогичных запросов в базах данных OLTP это тяжелая операция, не предназначенная для частого использования.
+
+Выражение `filter_expr` должно иметь тип `UInt8`. Запрос изменяет значение указанных столбцов на вычисленное значение соответствующих выражений в каждой строке, для которой `filter_expr` принимает ненулевое значение. Вычисленные значения преобразуются к типу столбца с помощью оператора `CAST`. Изменение столбцов, которые используются при вычислении первичного ключа или ключа партиционирования, не поддерживается.
+
+Один запрос может содержать несколько команд, разделенных запятыми.
+
+Синхронность обработки запроса определяется параметром [mutations_sync](../../../operations/settings/settings.md#mutations_sync). По умолчанию он является асинхронным.
+
+**Смотрите также**
+
+-   [Мутации](../../../sql-reference/statements/alter/index.md#mutations)
+-   [Синхронность запросов ALTER](../../../sql-reference/statements/alter/index.md#synchronicity-of-alter-queries)
+-   [mutations_sync](../../../operations/settings/settings.md#mutations_sync) setting
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/update/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/alter/user.md

+---
+toc_priority: 45
+toc_title: USER
+---
+
+# ALTER USER {#alter-user-statement}
+
+Изменяет аккаунт пользователя ClickHouse.
+
+## Синтаксис {#alter-user-syntax}
+
+``` sql
+ALTER USER [IF EXISTS] name [ON CLUSTER cluster_name]
+    [RENAME TO new_name]
+    [IDENTIFIED [WITH {PLAINTEXT_PASSWORD|SHA256_PASSWORD|DOUBLE_SHA1_PASSWORD}] BY {'password'|'hash'}]
+    [[ADD|DROP] HOST {LOCAL | NAME 'name' | REGEXP 'name_regexp' | IP 'address' | LIKE 'pattern'} [,...] | ANY | NONE]
+    [DEFAULT ROLE role [,...] | ALL | ALL EXCEPT role [,...] ]
+    [SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [READONLY|WRITABLE] | PROFILE 'profile_name'] [,...]
+```  
+
+## Описание {#alter-user-dscr}
+
+Для выполнения `ALTER USER` необходима привилегия [ALTER USER](../grant.md#grant-access-management).
+
+## Примеры {#alter-user-examples}
+
+Установить ролями по умолчанию роли, назначенные пользователю:
+
+``` sql
+ALTER USER user DEFAULT ROLE role1, role2
+```
+
+Если роли не были назначены пользователю, ClickHouse выбрасывает исключение.
+
+Установить ролями по умолчанию все роли, назначенные пользователю:
+
+``` sql
+ALTER USER user DEFAULT ROLE ALL
+```
+
+Если роль будет впоследствии назначена пользователю, она автоматически станет ролью по умолчанию.
+
+Установить ролями по умолчанию все назначенные пользователю роли кроме `role1` и `role2`:
+
+``` sql
+ALTER USER user DEFAULT ROLE ALL EXCEPT role1, role2
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/alter/user/) <!--hide-->
\ No newline at end of file

docs/ru/sql-reference/statements/create/role.md

@@ -20,7 +20,7 @@ CREATE ROLE [IF NOT EXISTS | OR REPLACE] name
 
 Одному пользователю можно назначить несколько ролей. Пользователи могут применять назначенные роли в произвольных комбинациях с помощью выражения [SET ROLE](../misc.md#set-role-statement). Конечный объем привилегий — это комбинация всех привилегий всех примененных ролей. Если у пользователя имеются привилегии, присвоенные его аккаунту напрямую, они также прибавляются к привилегиям, присвоенным через роли.
 
-Роли по умолчанию применяются при входе пользователя в систему. Установить роли по умолчанию можно с помощью выражений [SET DEFAULT ROLE](../misc.md#set-default-role-statement) или [ALTER USER](../alter.md#alter-user-statement).
+Роли по умолчанию применяются при входе пользователя в систему. Установить роли по умолчанию можно с помощью выражений [SET DEFAULT ROLE](../misc.md#set-default-role-statement) или [ALTER USER](../alter/index.md#alter-user-statement).
 
 Для отзыва роли используется выражение [REVOKE](../../../sql-reference/statements/revoke.md).
 

docs/ru/sql-reference/statements/grant.md

@@ -249,7 +249,7 @@ GRANT INSERT(x,y) ON db.table TO john
 
 ### ALTER {#grant-alter}
 
-Разрешает выполнять запросы [ALTER](alter.md) в соответствии со следующей иерархией привилегий:
+Разрешает выполнять запросы [ALTER](alter/index.md) в соответствии со следующей иерархией привилегий:
 
 - `ALTER`. Уровень: `COLUMN`. 
     - `ALTER TABLE`. Уровень: `GROUP`

docs/ru/sql-reference/statements/kill.md

@@ -51,7 +51,7 @@ KILL MUTATION [ON CLUSTER cluster]
   [FORMAT format]
 ```
 
-Пытается остановить выполняющиеся в данные момент [мутации](alter.md#mutations). Мутации для остановки выбираются из таблицы [`system.mutations`](../../operations/system-tables/mutations.md#system_tables-mutations) с помощью условия, указанного в секции `WHERE` запроса `KILL`.
+Пытается остановить выполняющиеся в данные момент [мутации](alter/index.md#mutations). Мутации для остановки выбираются из таблицы [`system.mutations`](../../operations/system-tables/mutations.md#system_tables-mutations) с помощью условия, указанного в секции `WHERE` запроса `KILL`.
 
 Тестовый вариант запроса (`TEST`) только проверяет права пользователя и выводит список запросов для остановки.
 

docs/ru/sql-reference/statements/optimize.md

@@ -14,7 +14,7 @@ OPTIMIZE TABLE [db.]name [ON CLUSTER cluster] [PARTITION partition | PARTITION I
 Если `OPTIMIZE` применяется к таблицам семейства [ReplicatedMergeTree](../../engines/table-engines/mergetree-family/replication.md), ClickHouse создаёт задачу на мёрж и ожидает её исполнения на всех узлах (если активирована настройка `replication_alter_partitions_sync`).
 
 -   Если `OPTIMIZE` не выполняет мёрж по любой причине, ClickHouse не оповещает об этом клиента. Чтобы включить оповещения, используйте настройку [optimize\_throw\_if\_noop](../../operations/settings/settings.md#setting-optimize_throw_if_noop).
--   Если указать `PARTITION`, то оптимизация выполняется только для указанной партиции. [Как задавать имя партиции в запросах](alter.md#alter-how-to-specify-part-expr).
+-   Если указать `PARTITION`, то оптимизация выполняется только для указанной партиции. [Как задавать имя партиции в запросах](alter/index.md#alter-how-to-specify-part-expr).
 -   Если указать `FINAL`, то оптимизация выполняется даже в том случае, если все данные уже лежат в одном куске.
 -   Если указать `DEDUPLICATE`, то произойдет схлопывание полностью одинаковых строк (сравниваются значения во всех колонках), имеет смысл только для движка MergeTree.