Ru/yql/last part (#9277)

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

Author: Pseudolukian

ydb/docs/en/core/yql/reference/yql-core/syntax/alter_table/changefeed.md

@@ -8,6 +8,7 @@
 
 `ADD CHANGEFEED <name> WITH (<option> = <value>[, ...])`: Adds a [changefeed](../../../../concepts/cdc) with the specified name and options.
 
+
 ## Changefeed options {#changefeed-options}
 
 * `MODE`: Operation mode. Specifies what to write to a changefeed each time table data is altered.

ydb/docs/en/core/yql/reference/yql-core/syntax/alter_table/secondary_index.md

@@ -48,6 +48,7 @@ ALTER TABLE <table_name> ALTER INDEX <index_name> SET (<partitioning_setting_nam
 
 {% note info %}
 
+
 These settings cannot be reset.
 
 {% endnote %}
@@ -60,6 +61,7 @@ These settings cannot be reset.
 
 The query in the following example enables automatic partitioning by load for the index named `title_index` of table `series` and sets its minimum partition count to 5:
 
+
 ```yql
 ALTER TABLE `series` ALTER INDEX `title_index` SET (
     AUTO_PARTITIONING_BY_LOAD = ENABLED,
@@ -69,6 +71,7 @@ ALTER TABLE `series` ALTER INDEX `title_index` SET (
 
 ## Deleting an index {#drop-index}
 
+
 `DROP INDEX`: Deletes the index with the specified name. The code below deletes the index named `title_index`.
 
 ```yql
@@ -95,6 +98,7 @@ Replacement of atomic indexes under load is supported by the command [{{ ydb-cli
 
 Example of index renaming:
 
+
 ```yql
 ALTER TABLE `series` RENAME INDEX `title_index` TO `title_index_new`;
 ```

ydb/docs/ru/core/concepts/federated_query/s3/write_data.md

@@ -4,7 +4,7 @@
 
 ## Запись данных через внешнее соединение {#connection-write}
 
-Запись данных с помощью соединений удобно использовать для прототипирования и первоначальной настройки работы с записью данных. SQL-выражение иллистрирует запись данных во внешний источник данных напрямую.
+Запись данных с помощью соединений удобно использовать для прототипирования и первоначальной настройки работы с записью данных. SQL-выражение иллюстрирует запись данных во внешний источник данных напрямую.
 
 ```yql
 INSERT INTO `connection`.`test/`

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

@@ -1,4 +1,4 @@
-# Работа с базами данных YDB
+# Работа с базами данных {{ ydb-short-name }}
 
 {{ ydb-full-name }} может выступать в качестве внешнего источника данных для другой базы {{ ydb-full-name }}. В данном разделе рассматривается организация совместной работы двух независимых баз данных {{ ydb-short-name }} в режиме обработки федеративных запросов.
 

ydb/docs/ru/core/dev/query-plans-optimization.md

@@ -56,7 +56,7 @@ SELECT season_id, episode_id
 
 И в визуальном и в текстовом представлении видно, что в корне этого плана возвращение данных на клиент, в листьях работа с таблицами, а на промежуточных узлах — преобразования данных. Важно обратить внимание на узел, показывающий обращение к таблице `episodes`. В данном случае это  `TableFullScan`, который означает выполнение полного сканирования таблицы. А полное сканирование таблицы потребляет времени и ресурсов пропорционально её размеру, из-за чего по возможности их стараются избегать в таблицах, которые имеют тенденцию расти с течением времени или просто большие.
 
-Одним из типовых способов избежать полного сканирования таблицы является добавление [вторичного индекса](secondary-indexes.md). В данном случае имеет смысл добавить вторичный индекс для колонки `title`, для этого воспользуемся запросом:
+Одним из типовых способов избежать полного сканирования таблицы является добавление [вторичного индекса](secondary-indexes.md) (поддерживается только для строковых таблиц). В данном случае имеет смысл добавить вторичный индекс для колонки `title`, для этого воспользуемся запросом:
 
 ```yql
 ALTER TABLE episodes

ydb/docs/ru/core/yql/query_plans.md

@@ -44,6 +44,8 @@ Parallel | флаг, указывающий на то что чтение стр
 
 #### TablePointLookup
 
+{% include [not_allow_for_olap_note](../_includes/not_allow_for_olap_note.md) %}
+
 Чтение строк таблицы по конкретным значениям первичного ключа. Обратите внимание, что для этой операции необходимо указать все компоненты первичного ключа, чтение по префиксу ключа выполняется как `TableRangeScan`.
 
 Атрибут | Значение
@@ -53,6 +55,8 @@ ReadColumns | список читаемых колонок
 
 #### Upsert
 
+{% include [not_allow_for_olap_note](../_includes/not_allow_for_olap_note.md) %}
+
 Перезапись строк таблицы по соответствующим значениям первичного ключа, если они существовали, иначе добавление новых строк.
 
 Атрибут | Значение

ydb/docs/ru/core/yql/reference/yql-core/builtins/_includes/aggregation/aggregate_by.md

@@ -1,6 +1,12 @@
 
 ## AGGREGATE_BY и MULTI_AGGREGATE_BY {#aggregate-by}
 
+{% if backend_name == "YDB" and oss == true %}
+
+{% include [not_allow_for_olap_note](../../../../../_includes/not_allow_for_olap_note.md) %}
+
+{% endif %}
+
 Применение [фабрики агрегационной функции](../../basic.md#aggregationfactory) ко всем значениям колонки или выражения. Функция `MULTI_AGGREGATE_BY` требует, чтобы в значении колонки или выражения была структура, кортеж или список, и применяет фабрику поэлементно, размещая результат в контейнере той же формы. Если в разных значениях колонки или выражения содержатся списки разной длины, результирующий список будет иметь наименьшую из длин этих списков.
 
 1. Колонка, `DISTINCT` колонка или выражение;

ydb/docs/ru/core/yql/reference/yql-core/builtins/_includes/aggregation/percentile_median.md

@@ -17,8 +17,7 @@ MEDIAN(T, [ List<Double> ])->List<T>
 Подсчет процентилей по амортизированной версии алгоритма [TDigest](https://github.com/tdunning/t-digest). `MEDIAN(x)` без второго аргумента — алиас для `PERCENTILE(x, 0.5)`.
 `MEDIAN` с двумя аргументами полностью эквивалентен `PERCENTILE`.
 
-В качестве первого аргумента `PERCENTILE`/`MEDIAN` принимает выражение типа `T`. В качестве типа `T` на данный момент поддерживаются типы `Interval` и `Double`
-(а также типы которые допускают неявное приведение к ним - например целочисленные типы).
+В качестве первого аргумента `PERCENTILE`/`MEDIAN` принимает выражение типа `T`. В качестве типа `T` на данный момент поддерживаются типы `Interval` и `Double` (а также типы которые допускают неявное приведение к ним - например целочисленные типы).
 
 В качестве второго аргумента можно использовать либо один `Double` (значение перцентиля), либо сразу несколько значений перцентиля в виде `Tuple`/`Struct`/`List`.
 
@@ -31,7 +30,7 @@ SELECT
     MEDIAN(numeric_column),
     PERCENTILE(numeric_column, 0.99),
     PERCENTILE(CAST(string_column as Double), (0.01, 0.5, 0.99)),                   -- подсчет сразу трех перцентилей
-    PERCENtILE(numeric_column, AsStruct(0.01 as p01, 0.5 as median, 0.99 as p99)), -- используя структуру, значениям перцентиля можно дать удобные имена
+    PERCENTILE(numeric_column, AsStruct(0.01 as p01, 0.5 as median, 0.99 as p99)), -- используя структуру, значениям перцентиля можно дать удобные имена
     PERCENTILE(numeric_column, ListFromRange(0.00, 1.05, 0.05)),                   -- подсчет множества перцентилей (от 0.0 до 1.0 включительно с шагом 0.05)
 FROM my_table;
 ```

ydb/docs/ru/core/yql/reference/yql-core/builtins/_includes/aggregation/simple.md

@@ -8,7 +8,7 @@ COUNT(T)->Uint64
 COUNT(T?)->Uint64
 ```
 
-Подсчет количества строк в таблице (если в качестве аргумента указана `*` или константа) или непустых значений в столбце таблицы (если в качестве аргумента указано имя столбца).
+Подсчет количества строк в строковой или колоночной таблице (если в качестве аргумента указана `*` или константа) или непустых значений в столбце таблицы (если в качестве аргумента указано имя столбца).
 
 Как и другие агрегатные функции, может использоваться в сочетании с [GROUP BY](../../../syntax/group_by.md) для получения статистики по частям таблицы, соответствующим значениям в столбцах, по которым идет группировка. {% if select_statement != "SELECT STREAM" %}А модификатор [DISTINCT](../../../syntax/group_by.md#distinct) позволяет посчитать число уникальных значений.{% endif %}
 

ydb/docs/ru/core/yql/reference/yql-core/builtins/_includes/basic/files.md

@@ -79,5 +79,5 @@ SELECT ListLength(ParseFile("String", "my_file.txt"));
 
 ```yql
 SELECT * FROM my_table
-WHERE int_column IN ParseFile("Int64", "my_file.txt"));
+WHERE int_column IN ParseFile("Int64", "my_file.txt");
 ```