Browse Source

YDBDOCS-803: add ya.make targets for various versions of YQL docs (#8361)

Ivan Blinkov 6 months ago
parent
commit
1ba20dfbc7

+ 4 - 0
ydb/docs/ru/core/yql/reference/_includes/index/intro.md

@@ -11,6 +11,8 @@ keywords:
 
 *YQL* (YDB Query Language) — универсальный декларативный язык запросов к YDB, диалект SQL. YQL создавался для работы с большими распределенными базами данных, и поэтому обладает рядом отличий от стандарта SQL.
 
+{% if backend_name == "YDB" %}
+
 Инструменты работы с YDB поддерживают интерфейсы отправки YQL-запросов и получения результатов их исполнения:
 
 {% include [yql/ui_prompt.md](yql/ui_prompt.md) %}
@@ -24,3 +26,5 @@ keywords:
 - [Встроенные функции](../../builtins/index.md) с описанием доступных встроенных функций
 
 Также вы можете пройти серию уроков, знакомящих вас с основными командами YQL, в разделе [Туториал YQL](../../../../dev/yql-tutorial/index.md).
+
+{% endif %}

+ 0 - 1
ydb/docs/ru/core/yql/reference/index.md

@@ -2,4 +2,3 @@
 {% include [intro.md](_includes/index/intro.md) %}
 
 {% include [intro.md](_includes/index/start.md) %}
-

+ 51 - 0
ydb/docs/ru/core/yql/reference/presets.yaml

@@ -0,0 +1,51 @@
+default:
+  oss: true
+  ya_make: true
+
+rtmr:
+  backend_name: RTMR
+  backend_name_lower: rtmr
+  rtmr: true
+  example_cluster: rtmr_yql_alpha
+  feature_not_null: true 
+  feature_column_container_type: true
+  feature_mapreduce: true
+  process_command: PROCESS STREAM
+  select_command: SELECT STREAM
+  feature_temp_table: true
+
+ydb:
+  backend_name: YDB
+  backend_name_lower: ydb
+  ydb: true
+  example_cluster: ydbtest
+  feature_secondary_index: true 
+  feature_changefeed: true 
+  feature_replace: true
+  feature_upsert: true
+  feature_join: true
+  feature_map_tables: true
+  feature_group_by_rollup_cube: true
+  feature_window_functions: true
+  feature_bulk_tables: false
+
+yt:
+  backend_name: YT
+  backend_name_lower: yt
+  yt: true
+  example_cluster: hahn
+  feature_mapreduce: true
+  process_command: PROCESS
+  reduce_command: REDUCE
+  feature_column_container_type: true
+  feature_subquery: true
+  feature_upsert: true
+  feature_join: true
+  feature_insert_with_truncate: true
+  feature_bulk_tables: true # CONCAT, RANGE, TablePath(), INSERT INTO details...
+  feature_group_by_rollup_cube: true
+  feature_window_functions: true
+  feature_codegen: true
+  feature_functional_tables: true 
+  feature_udf_noncpp: true
+  feature_temp_table: true

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

@@ -1,7 +1,11 @@
 ## FileContent и FilePath {#file-content-path}
 
+{% if oss != true %}
+
 Как [консольный](../../../interfaces/cli.md), так и [веб](../../../interfaces/web.md)-интерфейсы позволяют «прикладывать» к запросу произвольные именованные файлы. С помощью этих функций можно по имени приложенного файла получить его содержимое или путь в «песочнице» и в дальнейшем использовать в запросе произвольным образом.
 
+{% endif %}
+
 **Сигнатуры**
 ```
 FilePath(String)->String
@@ -42,9 +46,9 @@ SELECT FolderPath("foo"); -- в директории по возвращённо
 
 ## ParseFile
 
-Получить из приложенного текстового файла список значений. Может использоваться в сочетании с [IN](../../../syntax/expressions.md#in) и прикладыванием файла по URL <span style="color:gray;">(инструкции по прикладыванию файлов для {% if feature_webui %}[веб-интерфейса](../../../interfaces/web.md#attach) и {% endif %} [клиента](../../../interfaces/cli.md#attach))</span>.
+Получить из приложенного текстового файла список значений. Может использоваться в сочетании с [IN](../../../syntax/expressions.md#in) и прикладыванием файла по URL{% if oss != true %} <span style="color:gray;">(инструкции по прикладыванию файлов для {% if feature_webui %}[веб-интерфейса](../../../interfaces/web.md#attach) и {% endif %} [клиента](../../../interfaces/cli.md#attach))</span>{% endif %}.
 
-Поддерживается только один формат файла — по одному значению на строку.{% if feature_udf_noncpp %} Для чего-то более сложного прямо сейчас придется написать небольшую UDF на [Python](../../../udf/python.md) или [JavaScript](../../../udf/javascript.md). {% endif %}
+Поддерживается только один формат файла — по одному значению на строку.{% if feature_udf_noncpp and oss != true %} Для чего-то более сложного прямо сейчас придется написать небольшую UDF на [Python](../../../udf/python.md) или [JavaScript](../../../udf/javascript.md). {% endif %}
 
 **Сигнатура**
 ```

+ 1 - 1
ydb/docs/ru/core/yql/reference/yql-core/builtins/_includes/json.md

@@ -1155,7 +1155,7 @@ SELECT
     JSON_QUERY($json, "$.friends.name" WITH CONDITIONAL WRAPPER); -- ["James Holden", "Naomi Nagata"]
 ```
 
-{% if oss %}
+{% if oss and ya_make != true %}
 
 ## Смотрите также
 

+ 1 - 1
ydb/docs/ru/core/yql/reference/yql-core/builtins/_includes/list.md

@@ -361,7 +361,7 @@ ListIndexOf(List<T>?, T)->Uint64?
 2. Функции для обработки элементов, например:
     * [Лямбда функция](../../syntax/expressions.md#lambda);
     * `Module::Function` - С++ UDF;
-{% if feature_udf_noncpp %} 
+{% if feature_udf_noncpp and oss != true %}
     * [Python UDF](../../udf/python.md), [JavaScript UDF](../../udf/javascript.md) или любое другое вызываемое значение;
 {% endif %}
 

+ 1 - 1
ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/pragma/files.md

@@ -9,7 +9,7 @@
 | --- | --- | --- |
 | Два или три строковых аргумента — алиас, URL и опциональное имя токена | — | Статическая |
 
-Приложить файл к запросу по URL. Использовать приложенные файлы можно с помощью встроенных функций [FilePath и FileContent](../../../builtins/basic.md#filecontent). Данная `PRAGMA` является универсальной альтернативой прикладыванию файлов с использованием встроенных механизмов [веб-](../../../interfaces/web.md#attach) или [консольного](../../../interfaces/cli.md#attach) клиентов.
+Приложить файл к запросу по URL. Использовать приложенные файлы можно с помощью встроенных функций [FilePath и FileContent](../../../builtins/basic.md#filecontent).{% if oss != true %} Данная `PRAGMA` является универсальной альтернативой прикладыванию файлов с использованием встроенных механизмов [веб-](../../../interfaces/web.md#attach) или [консольного](../../../interfaces/cli.md#attach) клиентов.{% endif %}
 
 Сервис YQL оставляет за собой право кешировать находящиеся за URL файлы на неопределенный срок, по-этому при значимом изменении находящегося за ней содержимого настоятельно рекомендуется модифицировать URL за счет добавления/изменения незначащих параметров.
 

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

@@ -1,6 +1,6 @@
 # {{ process_command }}
 
-Преобразовать входную таблицу с помощью UDF на [C++](../../udf/cpp.md){% if yt %}, [Python](../../udf/python.md) или [JavaScript](../../udf/javascript.md){% endif %} или [лямбда функции](../../syntax/expressions.md#lambda), которая применяется последовательно к каждой строке входа и имеет возможность для каждой строки входа создать ноль, одну или несколько строк результата (аналог Map в терминах MapReduce).
+Преобразовать входную таблицу с помощью {% if oss != true %}UDF на [C++](../../udf/cpp.md){% if yt %}, [Python](../../udf/python.md) или [JavaScript](../../udf/javascript.md){% endif %} или {% endif %}[лямбда функции](../../syntax/expressions.md#lambda), которая применяется последовательно к каждой строке входа и имеет возможность для каждой строки входа создать ноль, одну или несколько строк результата (аналог Map в терминах MapReduce).
 
 {% if feature_mapreduce %}Таблица по имени ищется в базе данных, заданной оператором [USE](../use.md).{% endif %}
 

+ 4 - 0
ydb/docs/ru/core/yql/reference/yql-core/syntax/create_table/secondary_index.md

@@ -1,7 +1,11 @@
 # INDEX
 
+{% if backend_name == "YDB" and oss == true %}
+
 {% include [not_allow_for_olap](../../../../_includes/not_allow_for_olap_note.md) %}
 
+{% endif %}
+
 Конструкция `INDEX` используется для определения {% if concept_secondary_index %}[вторичного индекса]({{ concept_secondary_index }}){% else %}вторичного индекса{% endif %} {% if backend_name == "YDB" %}для [строковых](../../../../concepts/datamodel/table.md#row-oriented-tables) таблиц{% else %}на таблице{% endif %}:
 
 ```sql

+ 3 - 3
ydb/docs/ru/core/yql/reference/yql-core/syntax/create_table/temporary.md

@@ -1,13 +1,13 @@
 # Создание временных таблиц (TEMPORARY)
 
-{% if backend_name == "YDB" %}
+{% if backend_name == "YDB" and oss == true %}
 
 {% include [OLAP_not_allow_note](../../../../_includes/not_allow_for_olap_note.md) %}
 
-{% endif %}
-
 {% include [temp-table-description.md](../../../../_includes/temp-table-description.md) %}
 
+{% endif %}
+
 ```sql
 CREATE TEMPORARY TABLE table_name (
     ...

Some files were not shown because too many files changed in this diff