ClickHouse/docs/ru/sql-reference/statements/attach.md
2021-03-17 13:38:23 +03:00

1.7 KiB
Raw Blame History

toc_priority toc_title
40 ATTACH

ATTACH Statement

Запрос полностью аналогичен запросу CREATE, но:

  • вместо слова CREATE используется слово ATTACH;
  • запрос не создаёт данные на диске, а предполагает, что данные уже лежат в соответствующих местах, и всего лишь добавляет информацию о таблице на сервер. После выполнения запроса ATTACH сервер будет знать о существовании таблицы.

Если таблица перед этим была отключена (DETACH), т.е. её структура известна, можно использовать сокращенную форму записи без определения структуры.

ATTACH TABLE [IF NOT EXISTS] [db.]name [ON CLUSTER cluster]

Этот запрос используется при старте сервера. Сервер хранит метаданные таблиц в виде файлов с запросами ATTACH, которые он просто исполняет при запуске (за исключением некоторых системных таблиц, которые явно создаются на сервере).

Если таблица была отключена перманентно, она не будет подключена обратно во время старта сервера, так что нужно явно использовать запрос ATTACH, чтобы подключить ее.