---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.4
alternate:
  - https://ydb.tech/docs/en/yql/reference/syntax/alter_table/rename.md
  - https://ydb.tech/docs/ru/yql/reference/syntax/alter_table/rename.md
sourcePath: ru/core/yql/reference/syntax/alter_table/rename.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Переименование таблицы

```yql
ALTER TABLE old_table_name RENAME TO new_table_name;
```


{% note info %}

При выборе имени для таблицы учитывайте общие [правила именования схемных объектов](https://ydb.tech/docs/ru/concepts/datamodel/cluster-namespace.md#object-naming-rules).

{% endnote %}


Если таблица с новым именем существует, будет возвращена ошибка. Возможность транзакционной подмены таблицы под нагрузкой поддерживается специализированными методами в CLI и SDK.

{% note warning %}

Если в YQL запросе содержится несколько команд `ALTER TABLE ... RENAME TO ...`, то каждая будет выполнена в режиме автокоммита в отдельной транзакции. С точки зрения внешнего процесса, таблицы будут переименованы последовательно одна за другой. Чтобы переименовать несколько таблиц в одной транзакции, используйте специализированные методы, доступные в CLI и SDK.

{% endnote %}

Переименование может использоваться для перемещения таблицы из одной директории внутри БД в другую, например:

```yql
ALTER TABLE `table1` RENAME TO `/backup/table1`;
```