Rewrite YQL DML (#6470)

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

Author: Pseudolukian

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

@@ -1,5 +1,9 @@
-{% note warning %}
+{% if backend_name == "YDB" %}
+
+{% note alert %}
 
 {% include [not_allow_for_olap_text](not_allow_for_olap_text.md) %}
 
-{% endnote %}
+{% endnote %}
+
+{% endif %}

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

@@ -0,0 +1,5 @@
+Доступные способы загрузки данных в колоночные таблицы:
+* [YDB CLI](../reference/ydb-cli/export-import/import-file.md)
+* [Пакетная вставка данных](../recipes/ydb-sdk/bulk-upsert.md)
+* [FluentBit](../integrations/fluent-bit.md)
+* [Yandex Data Transfer](https://yandex.cloud/ru/services/data-transfer)

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

@@ -21,8 +21,12 @@ EnsureConvertibleTo(T, Type<T>, String)->T
 2. В Ensure — булевый предикат, который проверяется на `true`. В остальных функциях — тип данных, который может быть получен через [предназначенные для этого функции](../../types.md), либо строковый литерал с [текстовым описанием типа](../../../types/type_string.md).
 3. Опциональная строка с комментарием к ошибке, которая попадет в общее сообщение об ошибке при завершении запроса. Для проверок типов не может использовать сами данные, так как они выполняются на этапе валидации запроса, а для Ensure — может быть произвольным выражением.
 
+{% if backend_name != "YDB" %}
+
 Для проверки условий по финальному результату вычисления Ensure удобно использовать в сочетании с [DISCARD SELECT](../../../syntax/discard.md).
 
+{% endif %}
+
 **Примеры**
 ``` yql
 SELECT Ensure(

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/delete.md

@@ -1,6 +1,18 @@
 # DELETE FROM
 
-Удаляет строки из таблицы, заданные с помощью условия `WHERE`.{% if feature_mapreduce %}  Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %}
+{% if backend_name == "YDB" %}
+
+{% note warning %}
+
+{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
+
+Вместо `DELETE FROM` для удаления данных из колоночных таблиц можно воспользоваться механизмом удаления строк по времени — [TTL](../../../../concepts/ttl.md). TTL можно задать при [создании](../create_table.md) таблицы через `CREATE TABLE` или [измененить позже](../alter_table.md) через `ALTER TABLE`.
+
+{% endnote %}
+
+{% endif %}
+
+Удаляет строки из строковой таблицы, подходящие под условия, заданные в `WHERE`.{% if feature_mapreduce %}  Таблица ищется по имени в базе данных, заданной оператором [USE](../use.md).{% endif %}
 
 **Пример**
 
@@ -11,10 +23,12 @@ WHERE Key1 == 1 AND Key2 >= "One";
 
 ## DELETE FROM ... ON {#delete-on}
 
+
 Используется для удаления данных на основе результатов подзапроса. Набор колонок, возвращаемых подзапросом, должен быть подмножеством колонок обновляемой таблицы, и в составе возвращаемых колонок обязательно должны присутствовать все колонки первичного ключа таблицы. Типы данных возвращаемых подзапросом колонок должны совпадать с типами данных соответствующих колонок таблицы.
 
 Для поиска удаляемых из таблицы записей используется значение первичного ключа. Присутствие других (неключевых) колонок таблицы в составе выходных колонок подзапроса не влияет на результаты операции удаления.
 
+
 **Пример**
 
 ```sql

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/insert_into.md

@@ -6,13 +6,7 @@
 
 {% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
 
-{% cut "Способы загрузки данных в колоночные таблицы" %}
-* [YDB CLI](../../../../reference/ydb-cli/export-import/import-file.md)
-* [Пакетная вставка данных](../../../../recipes/ydb-sdk/bulk-upsert.md)
-* [FluentBit](../../../../integrations/fluent-bit.md)
-* [Yandex Data Transfer](https://yandex.cloud/ru/services/data-transfer)
-
-{% endcut %}
+{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
 
 {% endnote %}
 

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/into_result.md

@@ -1,6 +1,6 @@
 # INTO RESULT
 
-Позволяет задать пользовательскую метку для [SELECT](../select/index.md){% if feature_mapreduce and process_command == "PROCESS" %}, [PROCESS](../process.md) или [REDUCE](../reduce.md){% endif %}. Не может быть задано одновременно с [DISCARD](../discard.md).
+Позволяет задать пользовательскую метку для [SELECT](../select/index.md){% if feature_mapreduce and process_command == "PROCESS" %}, [PROCESS](../process.md) или [REDUCE](../reduce.md){% endif %}. {% if backend_name != "YDB" %}Не может быть задано одновременно с [DISCARD](../discard.md).{% endif %}
 
 **Примеры:**
 

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/replace_into.md

@@ -1,13 +1,20 @@
 # REPLACE INTO
 
-Сохраняет данные в таблицу с перезаписью строк по первичному ключу.{% if feature_mapreduce %}  Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %} Если заданный первичный ключ отсутствует, в таблицу будет добавлена новая строка. Если задан существующий `PRIMARY_KEY`, строка будет перезаписана. При этом значения столбцов, не участвующих в операции, заменяются на значения по умолчанию.
+{% if backend_name == "YDB" %}
 
-{% note info %}
+{% note warning %}
 
-В отличие от [`INSERT INTO`](../insert_into.md) и [`UPDATE`](../update.md), запросы [`UPSERT INTO`](../upsert_into.md) и `REPLACE INTO` не требуют предварительного чтения данных, поэтому выполняются быстрее.
+{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
+
+{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
 
 {% endnote %}
 
+{% endif %}
+
+В отличие от [`INSERT INTO`](../insert_into.md) и [`UPDATE`](../update.md), запросы [`UPSERT INTO`](../upsert_into.md) и `REPLACE INTO` не требуют предварительного чтения данных, поэтому выполняются быстрее. `REPLACE INTO` сохраняет данные в {% if backend_name == "YDB" %}строковую таблицу{% else %}таблицу{% endif %} с перезаписью строк по первичному ключу.{% if feature_mapreduce %} Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %} Если заданный первичный ключ отсутствует, в таблицу будет добавлена новая строка. Если задан существующий `PRIMARY_KEY`, строка будет перезаписана. При этом значения столбцов, не участвующих в операции, заменяются на значения по умолчанию.
+
+
 * Задание значений для `REPLACE INTO` c помощью `VALUES`.
 
   **Пример**

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/update.md

@@ -1,9 +1,23 @@
 # UPDATE
 
-Изменяет данные в таблице.{% if feature_mapreduce %}  Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %} После ключевого слова `SET` указываются столбцы, значение которых необходимо заменить, и сами новые значения. Список строк задается с помощью условия `WHERE`. Если `WHERE` отсутствует, изменения будут применены ко всем строкам таблицы.
+{% if backend_name == "YDB" %}
+
+{% note warning %}
+
+{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
+
+{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
+
+{% endnote %}
+
+{% endif %}
 
 `UPDATE` не может менять значение колонок, входящих в состав первичного ключа.
 
+Изменяет данные в строковой таблице.{% if feature_mapreduce %} Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %} После ключевого слова `SET` указываются столбцы, значение которых необходимо заменить, и сами новые значения. Список строк задается с помощью условия `WHERE`. Если `WHERE` отсутствует, изменения будут применены ко всем строкам таблицы.
+
+`UPDATE` не может менять значение `PRIMARY_KEY`.
+
 **Пример**
 
 ```sql

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/upsert_into.md

@@ -1,6 +1,18 @@
 # UPSERT INTO
 
-UPSERT (расшифровывается как UPDATE or INSERT) обновляет или добавляет множество строк в таблице на основании сравнения по первичному ключу. Отсутствующие строки добавляются. В присутствующих строках обновляются значения заданных столбцов, значения остальных столбцов остаются неизменными.
+{% if backend_name == "YDB" %}
+
+{% note warning %}
+
+{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
+
+{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
+
+{% endnote %}
+
+{% endif %}
+
+UPSERT (расшифровывается как UPDATE or INSERT) обновляет или добавляет множество строк в строковой таблице на основании сравнения по первичному ключу. Отсутствующие строки добавляются. В присутствующих строках обновляются значения заданных столбцов, значения остальных столбцов остаются неизменными.
 
 {% if feature_mapreduce %}  Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %}
 

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

@@ -35,7 +35,9 @@
 {% if feature_mapreduce and process_command == "PROCESS" %}
 * [SUBQUERY](subquery.md)
 {% endif %}
+{% if backend_name != "YDB" %}
 * [DISCARD](discard.md)
+{% endif %}
 * [INTO RESULT](into_result.md)
 {% if feature_mapreduce %}
 {% if process_command == "PROCESS" %}