Skip to content

Commit 25fba26

Browse files
authored
Fix includes in YQL SELECT (#7770)
1 parent 9ec6f05 commit 25fba26

File tree

15 files changed

+31
-29
lines changed

15 files changed

+31
-29
lines changed

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## TablePath {#tablepath}
22

3-
Доступ к текущему имени таблицы, что бывает востребовано при использовании [CONCAT](../../../syntax/select.md#concat), [RANGE](../../../syntax/select.md#range) и других подобных механизмов.
3+
Доступ к текущему имени таблицы, что бывает востребовано при использовании [CONCAT](../../../syntax/select/concat.md), [RANGE](../../../syntax/select/concat.md) и других подобных механизмов.
44

55
**Сигнатура**
66
```
@@ -12,7 +12,7 @@ TablePath()->String
1212
{% note info "Примечание" %}
1313

1414
Функции [TablePath](#tablepath), [TableName](#tablename) и [TableRecordIndex](#tablerecordindex) не работают для временных и анонимных таблиц (возвращают пустую строку или 0 для [TableRecordIndex](#tablerecordindex)).
15-
Данные функции вычисляются в момент [выполнения](../../../syntax/select.md#selectexec) проекции в `SELECT`, и к этому моменту текущая таблица уже может быть временной.
15+
Данные функции вычисляются в момент [выполнения](../../../syntax/select/index.md#selectexec) проекции в `SELECT`, и к этому моменту текущая таблица уже может быть временной.
1616
Чтобы избежать такой ситуации, следует поместить вычисление этих функций в подзапрос, как это сделано во втором примере ниже.
1717

1818
{% endnote %}
@@ -29,7 +29,7 @@ WHERE key IN $subquery;
2929

3030
## TableName {#tablename}
3131

32-
Получить имя таблицы из пути к таблице. Путь можно получить через функцию [TablePath](#tablepath), или в виде колонки `Path` при использовании табличной функции [FOLDER](../../../syntax/select.md#folder).
32+
Получить имя таблицы из пути к таблице. Путь можно получить через функцию [TablePath](#tablepath), или в виде колонки `Path` при использовании табличной функции {% if feature_map_reduce %}[FOLDER](../../../syntax/select/index.md#folder){% else %} `FOLDER`{% endif %}.
3333

3434
**Сигнатура**
3535
```
@@ -41,7 +41,7 @@ TableName(String, String)->String
4141
Необязательные аргументы:
4242

4343
* путь к таблице, по умолчанию используется `TablePath()` (также см. его ограничения);
44-
* указание системы ("yt"), по правилам которой выделяется имя таблицы. Указание системы нужно только в том случае, если с помощью [USE](../../../syntax/select.md#use) не указан текущий кластер.
44+
* указание системы ("yt"), по правилам которой выделяется имя таблицы. Указание системы нужно только в том случае, если с помощью {% if feature_mapreduce %}[USE](../../../syntax/use.md){% else %}`USE`{% endif %} не указан текущий кластер.
4545

4646
**Примеры**
4747
``` yql
@@ -62,7 +62,7 @@ SELECT TableName(Path, "yt") FROM hahn.FOLDER(folder_name);
6262
TableRecordIndex()->Uint64
6363
```
6464

65-
Аргументов нет. При использовании в сочетании с [CONCAT](../../../syntax/select.md#concat), [RANGE](../../../syntax/select.md#range) и другими подобными механизмами нумерация начинается заново для каждой таблицы на входе. В случае использования в некорректном контексте возвращает 0.
65+
Аргументов нет. При использовании в сочетании с [CONCAT](../../../syntax/select/concat.md), [RANGE](../../../syntax/select/concat.md) и другими подобными механизмами нумерация начинается заново для каждой таблицы на входе. В случае использования в некорректном контексте возвращает 0.
6666

6767
**Пример**
6868
``` yql

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,6 @@ ELSE
6767

6868
{% note info "Примечание" %}
6969

70-
Стоит учитывать, что `EVALUATE` выполняется до начала работы основного запроса. Также в рамках вычисления предиката в `EVALUATE IF` или списка в `EVALUATE FOR` невозможно использование [анонимных таблиц](../../select.md#temporary-tables).
70+
Стоит учитывать, что `EVALUATE` выполняется до начала работы основного запроса. Также в рамках вычисления предиката в `EVALUATE IF` или списка в `EVALUATE FOR` невозможно использование {% if feature_temp_table %}[анонимных таблиц](../../select/temporary_table.md){% else %} анонимных таблиц{% endif %}.
7171

7272
{% endnote %}

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# DELETE FROM
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% note warning %}
66

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# INSERT INTO
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% note warning %}
66

77
{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
88

9-
{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
9+
{% include [ways_add_data_to_olap](../../../../_includes/ways_add_data_to_olap.md) %}
1010

1111
{% endnote %}
1212

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,13 @@
2626

2727
{% note info "Примечание" %}
2828

29-
После выполнения `{{ process_command }}` в рамках того же запроса по результирующей таблице (или таблицам) можно выполнить {% if select_command != "SELECT STREAM" %}[SELECT](../select.md), [REDUCE](../reduce.md){% else %}[SELECT STREAM](../select_stream.md){% endif %}, [INSERT INTO](../insert_into.md), ещё один `{{ process_command }}` и так далее в зависимости от необходимого результата.
29+
После выполнения `{{ process_command }}` в рамках того же запроса по результирующей таблице (или таблицам) можно выполнить {% if select_command != "SELECT STREAM" %}[SELECT](../select/index.md), [REDUCE](../reduce.md){% else %}[SELECT STREAM](../select_stream.md){% endif %}, [INSERT INTO](../insert_into.md), ещё один `{{ process_command }}` и так далее в зависимости от необходимого результата.
3030

3131
{% endnote %}
3232

3333
Ключевое слово `USING` и указание функции необязательны: если они не указаны, то возвращается исходная таблица. {% if feature_subquery %}Это может быть удобно для применения [шаблона подзапроса](subquery.md).{% endif %}
3434

35-
В `{{ process_command }}` можно передать несколько входов (под входом здесь подразумевается таблица,{% if select_command != "PROCESS STREAM" %} [диапазон таблиц](../select.md#range){% endif %}, подзапрос, [именованное выражение](../expressions.md#named-nodes)), разделенных запятой. В функцию из `USING` в этом случае можно передать только специальные именованные выражения `TableRow()` или `TableRows()`, которые будут иметь следующий тип:
35+
В `{{ process_command }}` можно передать несколько входов (под входом здесь подразумевается таблица,{% if select_command != "PROCESS STREAM" %} {% if feature_bulk_tables %}[диапазон таблиц](../select/concat.md){% else %}диапазон таблиц{% endif %}{% endif %}, подзапрос, [именованное выражение](../expressions.md#named-nodes)), разделенных запятой. В функцию из `USING` в этом случае можно передать только специальные именованные выражения `TableRow()` или `TableRows()`, которые будут иметь следующий тип:
3636

3737
* `TableRow()` — альтернатива (`Variant`), где каждый элемент имеет тип структуры записи из соответствущего входа. Для каждой входной строки в альтернативе заполнен элемент, соответствущий номеру входа этой строки
3838
* `TableRows()` — ленивый итератор по альтернативам, с точки зрения типов — `Stream<Variant<...>>`. Альтернатива имеет такую же семантику, что и для `TableRow()`

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Указываемые следом ключевые слова:
66

7-
* `PRESORT` <span style="color: gray;">(опционально)</span> — указание порядка внутри каждой группы, синтаксис аналогичен [ORDER BY](../select.md#orderby);
7+
* `PRESORT` <span style="color: gray;">(опционально)</span> — указание порядка внутри каждой группы, синтаксис аналогичен [ORDER BY](../select/order_by.md);
88
* `ON` <span style="color: gray;">(обязательно)</span> — указание ключевых столбцов;
99
* `USING` или `USING ALL` <span style="color: gray;">(обязательно)</span> — вызов UDF, о правилах подробнее ниже.
1010

@@ -20,7 +20,7 @@
2020

2121
Результат формируется аналогичным [PROCESS](../process.md) образом. Также доступно ключевое слово `TableRow()` для получения строки целиком в виде структуры.
2222

23-
В `REDUCE` можно передать несколько входов (под входом здесь подразумевается таблица, [диапазон таблиц](../select.md#range), подзапрос, [именованное выражение](../expressions.md#named-nodes)), разделенных запятой. Все входы обязаны иметь указанные в `ON` ключевые колонки совпадающего типа. В функцию из `USING` в этом случае можно передать только специальное именованное выражение `TableRow()`. Второй аргумент (или второй элемент кортежа для `USING ALL`) будет содержать ленивый итератор альтернатив с заполненным элементом, соответствущим номеру входа текущей записи.
23+
В `REDUCE` можно передать несколько входов (под входом здесь подразумевается таблица, [диапазон таблиц](../select/concat.md), подзапрос, [именованное выражение](../expressions.md#named-nodes)), разделенных запятой. Все входы обязаны иметь указанные в `ON` ключевые колонки совпадающего типа. В функцию из `USING` в этом случае можно передать только специальное именованное выражение `TableRow()`. Второй аргумент (или второй элемент кортежа для `USING ALL`) будет содержать ленивый итератор альтернатив с заполненным элементом, соответствущим номеру входа текущей записи.
2424

2525
После `USING` в `REDUCE` можно опционально указать `ASSUME ORDER BY` со списком столбцов. Результат такого `REDUCE` будет считаться сортированным, но без выполнения фактической сортировки. Проверка сортированности осуществляется на этапе исполнения запроса. Поддерживается задание порядка сортировки с помощью ключевых слов `ASC` (по возрастанию) и `DESC` (по убыванию). Выражения в `ASSUME ORDER BY` не поддерживается.
2626

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# REPLACE INTO
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% note warning %}
66

77
{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
88

9-
{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
9+
{% include [ways_add_data_to_olap](../../../../_includes/ways_add_data_to_olap.md) %}
1010

1111
{% endnote %}
1212

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# TABLESAMPLE и SAMPLE
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% include [olap_warning_note](../../../../../_includes/not_allow_for_olap_note.md) %}
66

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# VIEW (INDEX)
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% include [olap_warning_note](../../../../../_includes/not_allow_for_olap_note.md) %}
66

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## DEFINE SUBQUERY {#define-subquery}
44

5-
`DEFINE SUBQUERY` позволяет объявить шаблон подзапроса (subquery), который представляет собой параметризуемый блок из нескольких выражений верхнего уровня (statements), и затем многократно его использовать путем применения в секции `FROM` выражения [SELECT](../select.md){% if feature_mapreduce %} или входных данных в [PROCESS](../process.md)/[REDUCE](../reduce.md){% endif %} с указанием параметров.
5+
`DEFINE SUBQUERY` позволяет объявить шаблон подзапроса (subquery), который представляет собой параметризуемый блок из нескольких выражений верхнего уровня (statements), и затем многократно его использовать путем применения в секции `FROM` выражения [SELECT](../select/index.md){% if feature_mapreduce %} или входных данных в [PROCESS](../process.md)/[REDUCE](../reduce.md){% endif %} с указанием параметров.
66
В отличие от [действий](../action.md) шаблон подзапроса должен заканчиваться выражением `SELECT`{% if feature_mapreduce %}/`PROCESS`/`REDUCE`{% endif %}, чей результат и является возвращаемым значением подзапроса. При этом выражение верхнего уровня `SELECT`{% if feature_mapreduce %}/`PROCESS`/`REDUCE`{% endif %} нельзя использовать более одного раза, как и модифицирующие выражения (например, `INSERT`).
77

88
После `DEFINE SUBQUERY` указывается:

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# UPDATE
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% note warning %}
66

77
{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
88

9-
{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
9+
{% include [ways_add_data_to_olap.md](../../../../_includes/ways_add_data_to_olap.md) %}
1010

1111
{% endnote %}
1212

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# UPSERT INTO
22

3-
{% if oss == "true" and backend_name == "YDB" %}
3+
{% if oss == true and backend_name == "YDB" %}
44

55
{% note warning %}
66

77
{% include [OLAP_not_allow_text](../../../../_includes/not_allow_for_olap_text.md) %}
88

9-
{% include [OLAP_not_allow_text](../../../../_includes/ways_add_data_to_olap.md) %}
9+
{% include [ways_add_data_to_olap](../../../../_includes/ways_add_data_to_olap.md) %}
1010

1111
{% endnote %}
1212

0 commit comments

Comments
 (0)