---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/tools-copy.md?version=v25.4
  - https://ydb.tech/docs/ru/reference/ydb-cli/tools-copy.md?version=v25.4
  - href: ru/reference/ydb-cli/tools-copy.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/reference/ydb-cli/tools-copy.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Копирование таблиц

С помощью подкоманды `tools copy` вы можете создать копию таблицы или нескольких таблиц БД. При копировании исходная таблица остается на месте, копия содержит все данные исходной таблицы.

Общий вид команды:

```bash
ydb [global options...] tools copy [options...]
```

* `global options` — [глобальные параметры](https://ydb.tech/docs/ru/reference/ydb-cli/commands/global-options.md?version=v25.4).
* `options` — [параметры подкоманды](#options).

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

```bash
ydb tools copy --help
```

## Параметры подкоманды {#options}

Имя параметра | Описание параметра
---|---
`--timeout` | Время, в течение которого должна быть выполнена операция на сервере.
`--item <свойство>=<значение>,...` | Свойства операции. Параметр может быть указан несколько раз, если необходимо выполнить копирование нескольких таблиц в одной транзакции.<br/>Обязательные свойства:<ul><li>`destination`, `dst`, `d` —  путь таблицы-назначения. Если путь назначения содержит директории, они должны быть созданы заранее. Таблица с именем назначения не должна существовать.</li><li>`source`, `src`, `s` — путь таблицы-источника.</li></ul>

## Примеры {#examples}

<!-- source: ru/_includes/ydb-cli-profile.md -->
{% note info %}

В примерах используется профиль `quickstart`, подробнее смотрите в [Создание профиля для соединения с тестовой БД](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=v25.4#quickstart).

{% endnote %}
<!-- endsource: ru/_includes/ydb-cli-profile.md -->

Создайте в базе данных директорию `backup`:

```bash
ydb -p quickstart scheme mkdir backup
```

Скопируйте таблицу `series` в таблицу `series-v1`, таблицу `seasons` в `seasons-v1`, таблицу `episodes` в `episodes-v1` директории `backup`:

```bash
ydb -p quickstart tools copy --item destination=backup/series-v1,source=series --item destination=backup/seasons-v1,source=seasons --item destination=backup/episodes-v1,source=episodes
```

Посмотрите листинг объектов директории `backup`:

```bash
ydb -p quickstart scheme ls backup
```

Результат:

```text
episodes-v1  seasons-v1  series-v1
```