---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/maintenance/manual/adding_storage_groups.md?version=v26.1
  - https://ydb.tech/docs/ru/maintenance/manual/adding_storage_groups.md?version=v26.1
  - href: ru/maintenance/manual/adding_storage_groups.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/maintenance/manual/adding_storage_groups.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Добавление групп хранения

По мере роста объема хранимых данных может понадобиться добавление дисков в кластер YDB. Диски могут быть добавлены в уже существующие узлы или вместе с новыми узлами. Для того, чтобы ресурсы новых дисков стали доступны БД, необходимо добавить [группы хранения](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#storage-groups).

Чтобы добавить новые группы хранения, воспользуйтесь утилитой [YDB DSTool](https://ydb.tech/docs/ru/reference/ydb-dstool/index.md?version=v26.1).

Просмотрите список пулов хранения кластера:

```bash
ydb-dstool -e <bs_endpoint> pool list
```

`<bs_endpoint>` - эндпоинт произвольного [узла хранения](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#storage-node) кластера.
>Пример результата:
>
>```text
>┌──────────────┬──────────────────┬────────────────┬──────┬──────────────┬──────────────┐
>│ BoxId:PoolId │ PoolName         │ ErasureSpecies │ Kind │ Groups_TOTAL │ VDisks_TOTAL │
>├──────────────┼──────────────────┼────────────────┼──────┼──────────────┼──────────────┤
>│ [1:1]        │ /Root/testdb:ROT │ mirror-3-dc    │ ROT  │ 1            │ 9            │
>└──────────────┴──────────────────┴────────────────┴──────┴──────────────┴──────────────┘
>```

Следующая команда добавит 10 групп в пул `/Root/testdb:ROT`:

```bash
ydb-dstool -e <bs_endpoint> group add --pool-name /Root/testdb:ROT --groups 10
```

В случае успеха команда вернет нулевой `exit status`. Иначе команда вернет ненулевой статус и
выведет сообщение об ошибке в `stderr`.

Чтобы проверить возможность добавления групп без фактического добавления, используйте глобальный параметр `--dry-run`. Следующая команда проверит возможность добавления 100 групп в пул `/Root/testdb:ROT`:

```bash
ydb-dstool --dry-run -e <bs_endpoint> group add --pool-name /Root/testdb:ROT --groups 100
```

Параметр `--dry-run` позволяет оценить, какое максимальное число групп можно добавить в пул.