---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/commands/workload.md?version=main
  - https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload.md?version=main
sourcePath: en/core/reference/ydb-cli/commands/workload/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

<!-- source: en/reference/ydb-cli/commands/workload/_includes/index.md -->
# Load testing

You can use the `workload` command to run different types of workload against your DB.

General format of the command:

```bash
ydb [global options...] workload [subcommands...]
```

* `global options`: [Global options](https://ydb.tech/docs/en/reference/ydb-cli/commands/global-options.md?version=main).
* `subcommands`: The [subcommands](#subcommands).

See the description of the command to run the data load:

```bash
ydb workload --help
```

## Available subcommands {#subcommands}

The following types of load tests are supported at the moment:

* [Stock](https://ydb.tech/docs/en/reference/ydb-cli/commands/workload/stock.md?version=main): An online store warehouse simulator.
* [Key-value](https://ydb.tech/docs/en/reference/ydb-cli/workload-kv.md?version=main): Key-Value load test.
* [ClickBench](https://ydb.tech/docs/en/reference/ydb-cli/workload-click-bench.md?version=main): [ClickBench analytical benchmark](https://github.com/ClickHouse/ClickBench).
* [TPC-C](https://ydb.tech/docs/en/reference/ydb-cli/workload-tpcc.md?version=main): [TPC-C benchmark](https://www.tpc.org/tpcc/).
* [TPC-H](https://ydb.tech/docs/en/reference/ydb-cli/workload-tpch.md?version=main): [TPC-H benchmark](https://www.tpc.org/tpch/).
* [TPC-DS](https://ydb.tech/docs/en/reference/ydb-cli/workload-tpcds.md?version=main): [TPC-DS benchmark](https://www.tpc.org/tpcds/).
* [Topic](https://ydb.tech/docs/en/reference/ydb-cli/workload-topic.md?version=main): Topic load test.
* [Transfer](https://ydb.tech/docs/en/reference/ydb-cli/workload-transfer.md?version=main): Transfer load test.
* [Query](https://ydb.tech/docs/en/reference/ydb-cli/workload-query.md?version=main): Query load test.
* [Fulltext](https://ydb.tech/docs/en/reference/ydb-cli/workload-fulltext.md?version=main): Fulltext load test.
* [Vector](https://ydb.tech/docs/en/reference/ydb-cli/workload-vector.md?version=main): Vector search load test.

## Global parameters for all workloads {#global_workload_options}

| Parameter name | Short name | Parameter description |
| --- | --- | --- |
| `--seconds <value>` | `-s <value>` | Duration of the test, in seconds. Default: 10. |
| `--threads <value>` | `-t <value>` | The number of parallel threads creating the load. Default: 10. |
| `--rate <value>` | - | Total rate for all threads, in transactions per second. Default: 0 (no rate limit). |
| `--quiet` | - | Outputs only the total result. |
| `--print-timestamp` | - | Prints the time together with the statistics of each time window. |
| `--client-timeout` | - | [Transport timeout in milliseconds](../../../../dev/timeouts.md). |
| `--operation-timeout` | - | [Operation timeout in milliseconds](../../../../dev/timeouts.md). |
| `--cancel-after` | - | [Timeout for canceling an operation in milliseconds](../../../../dev/timeouts.md). |
| `--window` | - | Statistics collection window, in seconds. Default: 1. |
<!-- endsource: en/reference/ydb-cli/commands/workload/_includes/index.md -->