ADD OLAP in YDB-CLI and SDK (#9067)

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

Author: Pseudolukian

ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md

@@ -52,23 +52,23 @@ scheme permissions revoke | Удаление разрешения
 scheme permissions set | Установка разрешений
 [scheme rmdir](../commands/dir.md#rmdir) | Удаление директории
 [scripting yql](../scripting-yql.md) | Выполнение YQL-скрипта
-table attribute add | Добавление атрибута таблицы
-table attribute drop | Удаление атрибута таблицы
-[table drop](../table-drop.md) | Удаление таблицы
-[table index add global-async](../commands/secondary_index.md#add) | Добавление асинхронного индекса
-[table index add global-sync](../commands/secondary_index.md#add) | Добавление синхронного индекса
-[table index drop](../commands/secondary_index.md#drop) | Удаление индекса
+table attribute add | Добавление атрибута для строкой или колоночной таблицы
+table attribute drop | Удаление атрибута у строковой или колоночной таблицы
+[table drop](../table-drop.md) | Удаление строковой или колоночной таблицы
+[table index add global-async](../commands/secondary_index.md#add) | Добавление асинхронного индекса для строковых таблиц
+[table index add global-sync](../commands/secondary_index.md#add) | Добавление синхронного индекса для строковых таблиц
+[table index drop](../commands/secondary_index.md#drop) | Удаление индекса у строковых таблиц
 [table query execute](../table-query-execute.md) | Исполнение YQL-запроса
 [table query explain](../commands/explain-plan.md) | План исполнения YQL-запроса
-[table read](../commands/readtable.md) | Потоковое чтение таблицы
-[table ttl set](../table-ttl-set.md) | Установка параметров TTL
-[table ttl reset](../table-ttl-reset.md) | Сброс параметров TTL
+[table read](../commands/readtable.md) | Потоковое чтение строковой таблицы
+[table ttl set](../table-ttl-set.md) | Установка параметров TTL для строковых и колоночных таблиц
+[table ttl reset](../table-ttl-reset.md) | Сброс параметров TTL для строковых и колоночных таблиц
 [tools copy](../tools-copy.md) | Копирование таблиц
-[tools dump](../export-import/tools-dump.md) | Выгрузка директории или таблицы в файловую систему
+[tools dump](../export-import/tools-dump.md) | Выгрузка директории или таблиц в файловую систему
 {% if ydb-cli == "ydb" %}
 [tools pg-convert](../../../postgresql/import.md#pg-convert) | Конвертация дампа PostgreSQL, полученного утилитой pg_dump, в формат, понятный YDB
 {% endif %}
-[tools rename](../commands/tools/rename.md) | Переименование таблиц
+[tools rename](../commands/tools/rename.md) | Переименование строковых таблиц
 [tools restore](../export-import/tools-restore.md) | Восстановление из файловой системы
 [topic create](../topic-create.md) | Создание топика
 [topic alter](../topic-alter.md) | Модификация параметров топика и перечня читателей

ydb/docs/ru/core/reference/ydb-cli/_includes/index.md

@@ -10,7 +10,7 @@
 * [Получение информации об объекте схемы](../commands/scheme-describe.md).
 * [Работа с директориями](../commands/dir.md).
 * [Выполнение YQL](../yql-query-overview.md).
-* [Потоковое чтение таблицы](../commands/readtable.md).
+* [Потоковое чтение строковых таблиц](../commands/readtable.md).
 * [Работа со вторичными индексами](../commands/secondary_index.md).
 * [Получение списка эндпоинтов для базы данных](../commands/discovery-list.md).
 * [Нагрузочное тестирование](../commands/workload/index.md).

ydb/docs/ru/core/reference/ydb-cli/commands/_includes/readtable.md

@@ -1,4 +1,6 @@
-# Потоковое чтение таблицы
+# Потоковое чтение строковой таблицы
+
+{% include [not_allow_for_olap_note](../../../../_includes/not_allow_for_olap_note.md) %}
 
 Чтобы прочитать снапшот таблицы целиком, используйте подкоманду `read`. Данные передаются в виде стрима, что позволяет прочитать таблицу произвольного размера.
 

ydb/docs/ru/core/reference/ydb-cli/commands/_includes/secondary_index.md

@@ -1,5 +1,7 @@
 # Создание и удаление вторичных индексов
 
+{% include [not_allow_for_olap_note](../../../../_includes/not_allow_for_olap_note.md) %}
+
 Команда `table index` позволяет создавать и удалять [вторичные индексы](../../../../concepts/secondary_indexes.md):
 
 ```bash

ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/rename.md

@@ -1,6 +1,8 @@
-# Переименование таблицы
+# Переименование строковых таблиц
 
-С помощью подкоманды `tools rename` вы можете [переименовать](../../../../../concepts/datamodel/table.md#rename) одну или несколько таблиц одновременно, перенести таблицу в другую директорию в пределах той же БД, заменить одну таблицу другой в рамках одной транзакции.
+{% include [not_allow_for_olap_note](../../../../../_includes/not_allow_for_olap_note.md) %}
+
+С помощью подкоманды `tools rename` вы можете [переименовать](../../../../../concepts/datamodel/table.md#rename) одну или несколько строковых таблиц одновременно, перенести таблицу в другую директорию в пределах той же БД, заменить одну таблицу другой в рамках одной транзакции.
 
 Общий вид команды:
 
@@ -11,7 +13,7 @@
 * `global options` — [глобальные параметры](../../../commands/global-options.md).
 * `options` — [параметры подкоманды](#options).
 
-Посмотрите описание команды для переименования таблицы:
+Посмотрите описание команды для переименования строковых таблицы:
 
 ```bash
 {{ ydb-cli }} tools rename --help

ydb/docs/ru/core/reference/ydb-cli/commands/workload/_includes/stock.md

@@ -1,5 +1,7 @@
 # Stock нагрузка
 
+{% include [not_allow_for_olap_note](../../../../../_includes/not_allow_for_olap_note.md) %}
+
 Симулирует работу склада интернет-магазина: создание заказов из нескольких товаров, получение списка заказов по клиенту.
 
 ## Виды нагрузки {#workload_types}
@@ -10,11 +12,11 @@
 * [rand-user-hist](#get-random-customer-history) - читает заданное количество заказов у случайно выбранного покупателя. Создается нагрузка на чтение из разных потоков.
 * [add-rand-order](#insert-random-order) - создает случайно сгенерированный заказ. Например, клиент создал заказ из 2 товаров, но еще не оплатил его, поэтому остатки товаров не снижаются. В БД записывается информация о заказе и товарах. Создается нагрузка на запись и чтение (insert перед вставкой проверяет есть ли уже запись).
 * [put-rand-order](#submit-random-order) - создает и обрабатывает случайно сгенерированный заказ. Например, покупатель создал и оплатил заказ из 2 товаров. В БД записывается информация о заказе, товарах, проверяется их наличие и уменьшаются остатки. Создается смешанная нагрузка.
-* [put-same-order](#submit-same-order) - создает заказы с одним и тем же набором товаров. Например, все покупатели покупают один и тот же набор товаров (только что вышедший телефон и заряжающее устройство). Создается нагрузка в виде конкурентного обновления одних и тех же строк в таблице.
+* [put-same-order](#submit-same-order) - создает заказы с одним и тем же набором товаров. Например, все покупатели покупают один и тот же набор товаров (только что вышедший телефон и заряжающее устройство). Создается нагрузка в виде конкурентного обновления одних и тех же строк в строковой таблице.
 
 ## Инициализация нагрузочного теста {#init}
 
-Для начала работы необходимо создать таблицы и заполнить их данными:
+Для начала работы необходимо создать строковую таблицы и заполнить их данными:
 
 ```bash
 {{ ydb-cli }} workload stock init [init options...]
@@ -38,12 +40,48 @@
 `--min-partitions <значение>` | - | Минимальное количество шардов для таблиц. Значение по умолчанию: 40.
 `--auto-partition <значение>` | - | Включение/выключение автошардирования. Возможные значения: 0 или 1. Значение по умолчанию: 1.
 
-Создаются 3 таблицы со следующими DDL:
+
+Создаются 3 строковые таблицы со следующими DDL:
 
 ```yql
-CREATE TABLE `stock`(product Utf8, quantity Int64, PRIMARY KEY(product)) WITH (AUTO_PARTITIONING_BY_LOAD = ENABLED, AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = <min-partitions>);
-CREATE TABLE `orders`(id Uint64, customer Utf8, created Datetime, processed Datetime, PRIMARY KEY(id), INDEX ix_cust GLOBAL ON (customer, created)) WITH (READ_REPLICAS_SETTINGS = "per_az:1", AUTO_PARTITIONING_BY_LOAD = ENABLED, AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = <min-partitions>, UNIFORM_PARTITIONS = <min-partitions>, AUTO_PARTITIONING_MAX_PARTITIONS_COUNT = 1000);
-CREATE TABLE `orderLines`(id_order Uint64, product Utf8, quantity Int64, PRIMARY KEY(id_order, product)) WITH (AUTO_PARTITIONING_BY_LOAD = ENABLED, AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = <min-partitions>, UNIFORM_PARTITIONS = <min-partitions>, AUTO_PARTITIONING_MAX_PARTITIONS_COUNT = 1000);
+CREATE TABLE `stock`(
+    product Utf8,
+    quantity Int64,
+    PRIMARY KEY(product)
+    )
+    WITH (
+        AUTO_PARTITIONING_BY_LOAD = ENABLED,
+        AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = <min-partitions>
+        );
+
+CREATE TABLE `orders`(
+    id Uint64,
+    customer Utf8,
+    created Datetime,
+    processed Datetime,
+    PRIMARY KEY(id),
+    INDEX ix_cust GLOBAL ON (customer, created)
+    )
+    WITH (
+        READ_REPLICAS_SETTINGS = "per_az:1",
+        AUTO_PARTITIONING_BY_LOAD = ENABLED,
+        AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = <min-partitions>,
+        UNIFORM_PARTITIONS = <min-partitions>,
+        AUTO_PARTITIONING_MAX_PARTITIONS_COUNT = 1000
+        );
+
+CREATE TABLE `orderLines`(
+    id_order Uint64,
+    product Utf8,
+    quantity Int64,
+    PRIMARY KEY(id_order, product)
+    )
+    WITH (
+        AUTO_PARTITIONING_BY_LOAD = ENABLED,
+        AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = <min-partitions>,
+        UNIFORM_PARTITIONS = <min-partitions>,
+        AUTO_PARTITIONING_MAX_PARTITIONS_COUNT = 1000
+        );
 ```
 
 ### Примеры инициализации нагрузки {#init-stock-examples}

ydb/docs/ru/core/reference/ydb-cli/parameterized-queries-cli.md

@@ -14,7 +14,7 @@
 
 {% note warning %}
 
-Из всех команд исполнения YQL-запросов только команда `table query execute` применяет политики повторных попыток, обеспечивающие надежное исполнение запросов и продолжение работы при изменении набора партиций в таблицах, а также других стандартных ситауциях в распределенной базе данных, вызывающих кратковременную невозможность выполнения операций над частью данных.
+Из всех команд исполнения YQL-запросов только команда `table query execute` применяет политики повторных попыток, обеспечивающие надежное исполнение запросов и продолжение работы при изменении набора партиций в таблицах, а также других стандартных ситуаций в распределенной базе данных, вызывающих кратковременную невозможность выполнения операций над частью данных.
 
 {% endnote %}
 
@@ -483,11 +483,13 @@ for i in $(seq 1 200);do echo "Line$i";done | \
 {"count":20,"p2":10,"items":["Line181","Line182","Line183","Line184","Line185","Line186","Line187","Line188","Line189","Line190","Line191","Line192","Line193","Line194","Line195","Line196","Line197","Line198","Line199","Line200"]}
 ```
 
-#### Удаление множества записей из таблицы YDB по первичным ключам {#example-adaptive-delete-pk}
+#### Удаление множества записей из строковой таблицы {{ ydb-short-name }} по первичным ключам {#example-adaptive-delete-pk}
 
-Данный пример показывает как можно удалять неограниченное количество записей из таблиц YDB, не рискуя превысить ограничения на количество записей в транзакции.
+{% include [not_allow_for_olap_note](../../_includes/not_allow_for_olap_note.md) %}
 
-Создадим тестовую таблицу:
+Данный пример показывает как можно удалять неограниченное количество записей из строковых таблиц {{ ydb-short-name }}, не рискуя превысить ограничения на количество записей в транзакции.
+
+Создадим тестовую строковую таблицу:
 
 ```bash
 {{ ydb-cli }} -p quickstart yql -s 'create table test_delete_1( id UInt64 not null, primary key (id))'

ydb/docs/ru/core/reference/ydb-cli/scripting-yql.md

@@ -51,7 +51,7 @@
 
 {% include [ydb-cli-profile](../../_includes/ydb-cli-profile.md) %}
 
-Скрипт создания таблицы, заполнения её данными, и получения выборки из этой таблицы:
+Скрипт создания строковой таблицы, заполнения её данными, и получения выборки из этой таблицы:
 
 ```bash
 {{ ydb-cli }} -p quickstart scripting yql -s '

ydb/docs/ru/core/reference/ydb-cli/workload-kv.md

@@ -1,6 +1,6 @@
 # Key-Value нагрузка
 
-Простой вид нагрузки, использующий БД YDB как Key-Value хранилище.
+Простой вид нагрузки, использующий БД {{ ydb-short-name }} как Key-Value хранилище.
 
 ## Виды нагрузки {#workload-types}
 

ydb/docs/ru/core/reference/ydb-cli/yql.md

@@ -50,7 +50,7 @@
 
 {% include [ydb-cli-profile](../../_includes/ydb-cli-profile.md) %}
 
-Скрипт создания таблицы, заполнения её данными, и получения выборки из этой таблицы:
+Скрипт создания строковой таблицы, заполнения её данными, и получения выборки из этой таблицы:
 
 ```bash
 {{ ydb-cli }} -p quickstart yql -s '