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

# CREATE SECRET

Команда `CREATE SECRET` создаёт [секрет](https://ydb.tech/docs/ru/concepts/datamodel/secrets.md).

Синтаксис:

```sql
CREATE SECRET secret_name
WITH (option = value[, ...])
```

* `secret_name` — имя создаваемого секрета.
* `option` — опция команды:
  * `value` — строка со значением секрета.
  * `inherit_permissions` — опция, при включении которой [права](https://ydb.tech/docs/ru/yql/reference/syntax/grant.md) на секрет наследуются от директории, в которой секрет создаётся. При отключении опции от директории наследуется только [право](https://ydb.tech/docs/ru/yql/reference/syntax/grant.md#permissions-list) `DESCRIBE SCHEMA`. Владелец секрета получает все возможные права на него в любом случае. По умолчанию — `False`.

## Разрешения

Для создания секрета требуется [право](https://ydb.tech/docs/ru/yql/reference/syntax/grant.md#permissions-list) `CREATE TABLE`.

## Примеры

Создать секрет в корне базы с именем `secret_name` и значением `secret_value`:

```sql
CREATE SECRET secret_name WITH (value = "secret_value");
```

Создать секрет в директории `dir` в корне базы с именем `secret_name` и значением `secret_value`. Если директория `dir` не существует, она будет создана:

```sql
CREATE SECRET `dir/secret_name` WITH (value = "secret_value");
```

Создать секрет в корне базы с именем `secret_name` и значением `secret_value` с правами такими же, как у родительской директории секрета:

```sql
CREATE SECRET secret_name WITH (value = "secret_value", inherit_permissions = True);
```

## См. также

* [ALTER SECRET](https://ydb.tech/docs/ru/yql/reference/syntax/alter-secret.md)
* [DROP SECRET](https://ydb.tech/docs/ru/yql/reference/syntax/drop-secret.md)