CREATE NAMED COLLECTION

Создаёт новую именованную коллекцию.

Именованные коллекции, созданные с помощью DDL, могут быть включены в некоторых сервисах ClickHouse Cloud. Обратитесь в службу поддержки, чтобы уточнить доступность.

Синтаксис

CREATE [OR REPLACE] NAMED COLLECTION [IF NOT EXISTS] name [ON CLUSTER cluster] AS
key_name1 = 'some value' [[NOT] OVERRIDABLE],
key_name2 = 'some value' [[NOT] OVERRIDABLE],
key_name3 = 'some value' [[NOT] OVERRIDABLE],
...

OR REPLACE и IF NOT EXISTS нельзя использовать вместе. CREATE OR REPLACE для существующей коллекции полностью заменяет её: ключи и флаги переопределяемости, которых нет в новом определении, удаляются. Чтобы переопределить сохранённый ключ при использовании коллекции, требуется привилегия SHOW NAMED COLLECTIONS SECRETS на эту коллекцию, в том числе для ключей, помеченных OVERRIDABLE. Ключи, помеченные NOT OVERRIDABLE, переопределить нельзя. На источники для словарей распространяется то же правило. Привилегия проверяется при создании, подключении или восстановлении словаря. При загрузке словаря проверяются только ограничения для ключей, помеченных NOT OVERRIDABLE. Пример

CREATE NAMED COLLECTION foobar AS a = '1', b = '2' OVERRIDABLE;
CREATE OR REPLACE NAMED COLLECTION foobar AS a = '2', c = '3';

Связанные команды

См. также

Руководство по именованным коллекциям

Часть: CREATE

Справочник по SQL

Типы данных

Движки

Функции

Форматы

Настройки

Системные таблицы

Озера данных