> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Документация по оператору CREATE NAMED COLLECTION

# CREATE NAMED COLLECTION

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

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

**Синтаксис**

```sql theme={null}
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`.

**Пример**

```sql theme={null}
CREATE NAMED COLLECTION foobar AS a = '1', b = '2' OVERRIDABLE;
CREATE OR REPLACE NAMED COLLECTION foobar AS a = '2', c = '3';
```

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

* [ALTER NAMED COLLECTION](/docs/ru/reference/statements/alter/named-collection)
* [DROP NAMED COLLECTION](/docs/ru/reference/statements/drop#drop-function)

**См. также**

* [Руководство по именованным коллекциям](/docs/ru/concepts/features/configuration/server-config/named-collections)

**Часть:** `CREATE`