Удаляет существующий объект. Если указан оператор IF EXISTS, ошибка не возвращается, даже если объект не существует. Если указан модификатор SYNC, объект удаляется без задержки.
Удаляет все таблицы в базе данных db, а затем саму базу данных db.
Синтаксис:
DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster] [SYNC]
Удаляет одну или несколько таблиц.
Синтаксис:
DROP [TEMPORARY] TABLE [IF EXISTS] [IF EMPTY] [db1.]name_1[, [db2.]name_2, ...] [ON CLUSTER cluster] [SYNC]
Ограничения:
- Если указано условие
IF EMPTY, сервер проверяет, пуста ли таблица, только на реплике, получившей запрос.
- Удаление нескольких таблиц одновременно не является атомарной операцией: если удаление одной из таблиц завершается ошибкой, последующие таблицы удалены не будут.
Удаляет словарь.
Синтаксис:
DROP DICTIONARY [IF EXISTS] [db.]name [SYNC]
Удаляет пользователя.
Синтаксис:
DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
Удаляет роль. Удалённая роль отзывается у всех объектов, которым она была назначена.
Синтаксис:
DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
Удаляет ROW POLICY. Удалённая ROW POLICY отзывается у всех сущностей, которым она была назначена.
Синтаксис:
DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
Удаляет политику маскирования.
Синтаксис:
DROP MASKING POLICY [IF EXISTS] name ON [database.]table [ON CLUSTER cluster_name] [FROM access_storage_type]
Удаляет квоту. Удалённая квота отзывается у всех сущностей, которым она была назначена.
Синтаксис:
DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
Удаляет профиль настроек. Удаленный профиль настроек отзывается у всех сущностей, которым он был назначен.
Синтаксис:
DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]
Удаляет представление. Представления также можно удалять командой DROP TABLE, однако DROP VIEW проверяет, что [db.]name — это именно представление.
Синтаксис:
DROP VIEW [IF EXISTS] [db.]name [ON CLUSTER cluster] [SYNC]
Удаляет пользовательскую функцию, созданную оператором CREATE FUNCTION.
Системные функции удалить нельзя.
Синтаксис
DROP FUNCTION [IF EXISTS] function_name [on CLUSTER cluster]
Пример
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
DROP FUNCTION linear_equation;
Удаляет именованную коллекцию.
Синтаксис
DROP NAMED COLLECTION [IF EXISTS] name [on CLUSTER cluster]
Пример
CREATE NAMED COLLECTION foobar AS a = '1', b = '2';
DROP NAMED COLLECTION foobar;
Последнее изменение 10 июня 2026 г.