> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# toloka dataset split

> Put every row without a part in one, sampled by share; rows that already have a part keep it, so test rows stay test as the dataset grows.

## Usage

```bash theme={null}
toloka dataset split [options] <name>
```

## Arguments

**name** `string` *required*

Dataset name or id.

## Options

**--column \<name>** `string`

Split column to fill: a new name creates it, an existing split column gets its empty cells filled, an ordinary column whose values are part names becomes a split column (default split).

**--ratios \<train/validate/test>** `string`

Whole percentages that add up to 100 (default 80/10/10 for a new column, then the column's own shares).

**--parts \<parts>** `string`

Parts as name\[=roles]\[:percent], for example train:70,dev=validate:10,holdout=test:20; without percentages the column's values name the parts.

**--validate-on-test** `boolean` (default: false)

The test part is also the validation set, common when data is scarce; needs a validate ratio of 0, for example `--ratios` 80/0/20.

**--balance-by \<field>** `string`

Label column to balance: every label value is split by the shares.

**--seed \<n>** `integer`

Seed for the row order; generated when omitted, then kept by the column.

**--filter \<field=value>** `string`

Place only rows whose field equals the value; repeat for more fields.

Repeat this option to supply multiple values.

**--slice \<slice-id>** `string`

Place only the rows of this slice.

**--no-wait** `boolean`

Return as soon as placing starts.

The `wait` setting defaults to `true`. This flag sets `wait` to `false`.

**--timeout \<ms>** `integer`

How long to wait for the rows to be placed.

**--json** `boolean` (default: false)

Print JSON.

## Inherited options

**-v, --version** `boolean`

Output the current version.

**--source-root \<directory>** `string`

Project root; otherwise search the working directory and parents; init and report use only the working directory.

**--api-key \<key>** `string`

API key override; login stores the key it verifies.

Environment fallback: [`TOLOKA_SCOPED_TOKEN`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables), [`TOLOKA_API_KEY`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables).

**--base-url \<url>** `string`

Platform base URL override; login saves the selected URL.

Environment fallback: [`TOLOKA_BASE_URL`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables).

**--project-id \<id>** `string`

Target project; overrides toloka.json.

Environment fallback: [`TOLOKA_PROJECT_ID`](https://docs.platform.toloka.ai/docs/cli/reference#environment-variables).

See the [CLI guide](https://docs.platform.toloka.ai/docs/cli.md#manage-shared-datasets) for the workflow, and [environment variables and exit codes](https://docs.platform.toloka.ai/docs/cli/reference.md#environment-variables) for shared behavior.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.