Added ydb cli commands table drop and copy

updated

6 files changed, 94 insertions, 61 deletions

diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
index 94669b6b393..07a2d437031 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
+++ b/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
@@ -53,7 +53,7 @@ scheme permissions set | Установка разрешений
 [scripting yql](../scripting-yql.md) | Выполнение YQL-скрипта
 table attribute add | Добавление атрибута таблицы
 table attribute drop | Удаление атрибута таблицы
-table drop | Удаление таблицы
+[table drop](../table-drop.md) | Удаление таблицы
 [table index add global-async](../commands/secondary_index.md#add) | Добавление асинхронного индекса 
 [table index add global-sync](../commands/secondary_index.md#add) | Добавление синхронного индекса 
 [table index drop](../commands/secondary_index.md#drop) | Удаление индекса
@@ -62,7 +62,7 @@ table drop | Удаление таблицы
 [table readtable](../commands/readtable.md) | Потоковое чтение таблицы
 [table ttl set](../table-ttl-set.md) | Установка параметров TTL
 [table ttl drop](../table-ttl-drop.md) | Удаление параметров TTL
-tools copy | Копирование таблиц
+[tools copy](../tools-copy.md) | Копирование таблиц
 [tools dump](../export_import/tools_dump.md) | Выгрузка директории или таблицы в файловую систему
 [tools rename](../commands/tools/rename.md) | Переименование таблиц
 [tools restore](../export_import/tools_restore.md) | Восстановление из файловой системы
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/copy.md b/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/copy.md
deleted file mode 100644
index 6dd94a13b0f..00000000000
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/_includes/tools/copy.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# Копирование таблицы
-
-С помощью подкоманды `tools copy` вы можете создать копию таблицы БД.
-
-Общий вид команды:
-
-```bash
-{{ ydb-cli }} [global options...] tools copy [options...]
-```
-
-* `global options` — [глобальные параметры](../../../commands/global-options.md).
-* `options` — [параметры подкоманды](#options).
-
-Посмотрите описание команды для копирования таблицы:
-
-```bash
-{{ ydb-cli }} tools copy --help
-```
-
-## Параметры подкоманды {#options}
-
-Имя параметра | Описание параметра
----|---
-`--client-timeout <значение>` | Таймаут операции на стороне клиента, мс.
-`--operation-timeout <значение>` | Таймаут операции на стороне сервера, мс.
-`--cancel-after <значение>` | Время жизни операции, по окончании которого она будет отменена, мс.
-`--item <свойство>=<значение>,...` | Параметры операции. Возможные значения:<br/><ul><li>`destination`, `dst`, `d` —  обязательный параметр, путь таблицы назначения. Если путь назначения содержит директории, они должны быть созданы заранее. Таблица с именем назначения не должна существовать.</li><li>`source`, `src`, `s` — обязательный параметр, путь таблицы источника.</li></ul>
-
-## Примеры {#examples}
-
-### Копирование таблицы {#copy-table}
-
-Создайте в базе данных директорию `backup`:
-
-```bash
-{{ ydb-cli }} scheme mkdir backup
-```
-
-Скопируйте таблицу `seasons` в таблицу `seasons-v1` директории `backup`:
-
-```bash
-{{ ydb-cli }} tools copy \
-  --item destination=backup/seasons-v1,source=seasons
-```
-
-Посмотрите листинг объектов директории `backup`:
-
-```bash
-{{ ydb-cli }} scheme ls backup
-```
-
-Результат:
-
-```text
-seasons-v1
-```
diff --git a/ydb/docs/ru/core/reference/ydb-cli/commands/tools/copy.md b/ydb/docs/ru/core/reference/ydb-cli/commands/tools/copy.md
deleted file mode 100644
index db7461732f6..00000000000
--- a/ydb/docs/ru/core/reference/ydb-cli/commands/tools/copy.md
+++ /dev/null
@@ -1 +0,0 @@
-{% include [copy.md](../../_includes/commands/tools/copy.md) %}
diff --git a/ydb/docs/ru/core/reference/ydb-cli/table-drop.md b/ydb/docs/ru/core/reference/ydb-cli/table-drop.md
new file mode 100644
index 00000000000..fd34f79829d
--- /dev/null
+++ b/ydb/docs/ru/core/reference/ydb-cli/table-drop.md
@@ -0,0 +1,35 @@
+# Удаление таблицы
+
+С помощью подкоманды `table drop` вы можете удалить указанную таблицу.
+
+Общий вид команды:
+
+```bash
+{{ ydb-cli }} [global options...] table drop [options...] <table path>
+```
+
+* `global options` — [глобальные параметры](commands/global-options.md).
+* `options` — [параметры подкоманды](#options).
+* `table path` — путь таблицы.
+
+Посмотрите описание команды удаления таблицы:
+
+```bash
+{{ ydb-cli }} table drop --help
+```
+
+## Параметры подкоманды {#options}
+
+Имя | Описание
+---|---
+`--timeout` | Время, в течение которого должна быть выполнена операция на сервере.
+
+## Примеры {examples}
+
+{% include [ydb-cli-profile](../../_includes/ydb-cli-profile.md) %}
+
+Удалите таблицу `series`:
+
+```bash
+{{ ydb-cli }} -p db1 table drop series
+```
diff --git a/ydb/docs/ru/core/reference/ydb-cli/toc_i.yaml b/ydb/docs/ru/core/reference/ydb-cli/toc_i.yaml
index af17731a4d8..b2c08613de8 100644
--- a/ydb/docs/ru/core/reference/ydb-cli/toc_i.yaml
+++ b/ydb/docs/ru/core/reference/ydb-cli/toc_i.yaml
@@ -19,12 +19,16 @@ items:
       href: commands/dir.md
     - name: Вторичные индексы
       href: commands/secondary_index.md
+    - name: Копирование таблиц
+      href: tools-copy.md
     - name: Переименование таблиц
       href: commands/tools/rename.md
     - name: Установка параметров TTL
       href: table-ttl-set.md
     - name: Удаление параметров TTL
       href: table-ttl-drop.md
+    - name: Удаление таблицы
+      href: table-drop.md
   - name: Работа с данными
     items:
     - name: Получение плана исполнения запроса и AST
@@ -67,8 +71,6 @@ items:
       href: table-query-execute.md
 #  - name: Утилиты
 #    items:
-    # - name: Копирование таблиц
-    #   href: commands/tools/copy.md
     # - name: Снятие бэкапа
     #   href: commands/tools/dump.md
     # - name: Восстановление бэкапа
diff --git a/ydb/docs/ru/core/reference/ydb-cli/tools-copy.md b/ydb/docs/ru/core/reference/ydb-cli/tools-copy.md
new file mode 100644
index 00000000000..cf398145980
--- /dev/null
+++ b/ydb/docs/ru/core/reference/ydb-cli/tools-copy.md
@@ -0,0 +1,53 @@
+# Копирование таблиц
+
+С помощью подкоманды `tools copy` вы можете создать копию таблицы или нескольких таблиц БД. При копировании исходная таблица остается на месте, копия содержит все данные исходной таблицы.
+
+Общий вид команды:
+
+```bash
+{{ ydb-cli }} [global options...] tools copy [options...]
+```
+
+* `global options` — [глобальные параметры](commands/global-options.md).
+* `options` — [параметры подкоманды](#options).
+
+Посмотрите описание команды для копирования таблицы:
+
+```bash
+{{ ydb-cli }} tools copy --help
+```
+
+## Параметры подкоманды {#options}
+
+Имя параметра | Описание параметра
+---|---
+`--timeout` | Время, в течение которого должна быть выполнена операция на сервере.
+`--item <свойство>=<значение>,...` | Свойства операции. Параметр может быть указан несколько раз, если необходимо выполнить копирование нескольких таблиц в одной транзакции.<br/>Обязательные свойства:<ul><li>`destination`, `dst`, `d` —  путь таблицы-назначения. Если путь назначения содержит директории, они должны быть созданы заранее. Таблица с именем назначения не должна существовать.</li><li>`source`, `src`, `s` — путь таблицы-источника.</li></ul>
+
+## Примеры {#examples}
+
+{% include [ydb-cli-profile](../../_includes/ydb-cli-profile.md) %}
+
+Создайте в базе данных директорию `backup`:
+
+```bash
+{{ ydb-cli }} -p db1 scheme mkdir backup
+```
+
+Скопируйте таблицу `series` в таблицу `series-v1`, таблицу `seasons` в `seasons-v1`, таблицу `episodes` в `episodes-v1` директории `backup`:
+
+```bash
+{{ ydb-cli }} -p db1 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-cli }} -p db1 scheme ls backup
+```
+
+Результат:
+
+```text
+episodes-v1  seasons-v1  series-v1
+```