Key-Value нагрузка

Простой вид нагрузки, использующий БД YDB как Key-Value хранилище.

Виды нагрузки

Данный нагрузочный тест содержит несколько видов нагрузки:

• upsert — при помощи операции UPSERT вставляет в заранее созданную командой init таблицу строки, которые представляют из себя кортежи (key1, key2, ... keyK, value1, value2, ... valueN), числа K и N задаются в параметрах.
• insert — функционал такой же, как у нагрузки upsert, но для вставки используется операция INSERT.
• select — читает данные при помощи операции SELECT * WHERE key = $key. Запрос всегда затрагивает все колонки таблицы, но не всегда является точечным, количеством вариаций primary ключа можно управлять с помощью параметров.
• read-rows - читает данные при помощи операции ReadRows, выполняющей более быстрые чтения по ключу, чем SELECT. Запрос всегда затрагивает все колонки таблицы, но не всегда является точечным, количеством вариаций primary ключа можно управлять с помощью параметров.
• mixed - одновременно пишет и читает данные, дополнительно проверяя что все записанные данные успешно читаются.

Инициализация нагрузочного теста

Для начала работы необходимо создать таблицы, при создании можно указать, сколько строк необходимо вставить при инициализации:

ydb workload kv init [init options...]

• init options — параметры инициализации.

Посмотрите описание команды для инициализации таблицы:

ydb workload kv init --help

Доступные параметры

Для создания таблицы используется следующая команда:

CREATE TABLE `kv_test`(
    c0 Uint64,
    c1 Uint64,
    ...
    cI Uint64,
    cI+1 String,
    ...
    cN String,
    PRIMARY KEY(c0, c1, ... cK)) WITH (
        AUTO_PARTITIONING_BY_LOAD = ENABLED,
        AUTO_PARTITIONING_MIN_PARTITIONS_COUNT = partsNum,
        UNIFORM_PARTITIONS = partsNum,
        AUTO_PARTITIONING_PARTITION_SIZE_MB = partSize,
        AUTO_PARTITIONING_MAX_PARTITIONS_COUNT = 1000
    )
)

Примеры инициализации нагрузки

Пример команды создания таблицы с 1000 строками:

ydb workload kv init --init-upserts 1000

Удаление таблицы

После завершения работы можно удалить таблицу:

ydb workload kv clean

Исполняется следующая YQL команда:

DROP TABLE `kv_test`

Примеры использования clean

ydb workload kv clean

Запуск нагрузочного теста

Для запуска нагрузки необходимо выполнить команду:

ydb workload kv run [workload type...] [global workload options...] [specific workload options...]

В течение теста на экран выводится статистика по нагрузке для каждого временного окна.

• workload type — виды нагрузки.
• global workload options — общие параметры для всех видов нагрузки.
• specific workload options — параметры конкретного вида нагрузки.

Посмотрите описание команды для запуска нагрузки:

ydb workload kv run --help

Общие параметры для всех видов нагрузки

Нагрузка upsert

Данный вид нагрузки вставляет кортежи (key1, key2, ... keyK, value1, value2, ... valueN)

Для запуска данного вида нагрузки необходимо выполнить команду:

ydb workload kv run upsert [global workload options...] [specific workload options...]

• global workload options - общие параметры для всех видов нагрузки.
• specific workload options - параметры конкретного вида нагрузки.

Например для параметров --rows 2 --cols 3 --int-cols 2 YQL Запрос будет выглядеть так:

DECLARE $c0_0 AS Uint64;
DECLARE $c0_1 AS Uint64;
DECLARE $c0_2 AS String;
DECLARE $c1_0 AS Uint64;
DECLARE $c1_1 AS Uint64;
DECLARE $c1_2 AS String;
UPSERT INTO `kv_test` (c0, c1, c2) VALUES ($c0_0, $c0_1, $c0_2), ($c1_0, $c1_1, $c1_2)

Параметры для upsert

Нагрузка insert

Данный вид нагрузки вставляет кортежи (key1, key2, ... keyK, value1, value2, ... valueN)

Для запуска данного вида нагрузки необходимо выполнить команду:

ydb workload kv run insert [global workload options...] [specific workload options...]

• global workload options - общие параметры для всех видов нагрузки.
• specific workload options - параметры конкретного вида нагрузки.

Например для параметров --rows 2 --cols 3 --int-cols 2 YQL Запрос будет выглядеть так:

DECLARE $c0_0 AS Uint64;
DECLARE $c0_1 AS Uint64;
DECLARE $c0_2 AS String;
DECLARE $c1_0 AS Uint64;
DECLARE $c1_1 AS Uint64;
DECLARE $c1_2 AS String;
INSERT INTO `kv_test` (c0, c1, c2) VALUES ($c0_0, $c0_1, $c0_2), ($c1_0, $c1_1, $c1_2)

Параметры для insert

Нагрузка select

Данный вид нагрузки создает SELECT запросы, возвращающие строки по точному совпадению primary ключа.

Для запуска данного вида нагрузки необходимо выполнить команду:

ydb workload kv run select [global workload options...]

• global workload options - общие параметры для всех видов нагрузки.

Например для параметров --rows 2 --cols 3 --int-cols 2 --key-cols 2 YQL Запрос будет выглядеть так:

DECLARE $r0_0 AS Uint64;
DECLARE $r0_1 AS Uint64;
DECLARE $r1_0 AS Uint64;
DECLARE $r1_1 AS Uint64;
SELECT c0, c1, c2 FROM `kv_test` WHERE c0 = $r0_0 AND c1 = $r0_1 OR c0 = $r1_0 AND c1 = $r1_1

Нагрузка read-rows

Данный вид нагрузки создает ReadRows запросы, возвращающие строки по точному совпадению primary ключа.

Для запуска данного вида нагрузки необходимо выполнить команду:

ydb workload kv run read-rows [global workload options...]

• global workload options - общие параметры для всех видов нагрузки.

Нагрузка mixed

Данный вид нагрузки одновременно вставляет и читает кортежи (key1, key2, ... keyK, value1, value2, ... valueN), дополнительно проверяя что все записанные данные успешно читаются.

Для запуска данного вида нагрузки необходимо выполнить команду:

ydb workload kv run mixed [global workload options...] [specific workload options...]

• global workload options - общие параметры для всех видов нагрузки.
• specific workload options - параметры конкретного вида нагрузки.

Параметры для mixed