YQL-14787: describe (A)SYMMETRIC BETWEEN in ru doc

ref:a2cfcddb9f884ae1ec3fe23034a1d7f07f366ee0

1 files changed, 19 insertions, 0 deletions

diff --git a/ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/expressions/between.md b/ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/expressions/between.md
index a8c1e3bc3d..160bd3832a 100644
--- a/ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/expressions/between.md
+++ b/ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/expressions/between.md
@@ -1,6 +1,15 @@
 ## BETWEEN {#between}
 
 Проверка на вхождение значения в диапазон. Эквивалентно паре условий с `>=` и `<=`, то есть границы диапазона включаются. Может использоваться с префиксом  `NOT` для инверсии.
+Поддерживается два режима проверки вхождения: симметричный и асимметричный (по умолчанию). В случае симметричной проверки в качестве начала диапазона выбирается минимальное значение из двух границ диапазона, а в качестве конца диапазона выбирается максимальное значение из двух границ диапазона. В случае асимметричного режима в качестве начала диапазона выбирается первый элемент диапазона, а в качестве конца диапазона выбирается второй элемент диапазона.
+Иными словами выражение
+``` yql
+x BETWEEN SYMMETRIC a AND b
+```
+эквивалентно
+``` yql
+x BETWEEN LEAST(a, b) AND GREATEST(a, b)
+```
 
 **Примеры**
 
@@ -9,3 +18,13 @@ SELECT * FROM my_table
 WHERE key BETWEEN 10 AND 20;
 ```
 
+``` yql
+SELECT * FROM my_table
+WHERE key BETWEEN SYMMETRIC 20 AND 10;
+```
+
+``` yql
+SELECT * FROM my_table
+WHERE key NOT BETWEEN ASYMMETRIC 10 AND 20;
+```
+