---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/profile/use.md?version=main
  - https://ydb.tech/docs/ru/reference/ydb-cli/profile/use.md?version=main
sourcePath: ru/core/reference/ydb-cli/profile/use.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

<!-- source: ru/reference/ydb-cli/profile/_includes/use.md -->
# Использование профиля

## Соединение по выбранному профилю {#explicit}

Профиль может быть применен при запуске команды YDB CLI указанием опции `--profile` или `-p`:

``` bash
ydb -p <profile_name> <команда и опции команды>
```

Например:

```bash
ydb -p mydb1 scheme ls -l
```

В таком случае все параметры соединения с БД будут взяты из профиля. При этом, если в профиле не указано параметров аутентификации, то YDB CLI попробует их определить по переменным окружения, как описано в статье [Соединение с БД и аутентификация — Переменные окружения](https://ydb.tech/docs/ru/reference/ydb-cli/connect.md?version=main#env).

## Соединение по выбранному профилю и параметрам командной строки {#explicit-and-pars}

Опция `--profile` (`-p`) может быть не единственной среди параметров соединения в командной строке, например:

```bash
ydb -p mydb1 -d /local2 scheme ls -l
```

```bash
ydb -p mydb1 --user alex scheme ls -l
```

В таком случае указанные в командной строке параметры соединения имеют приоритет перед сохраненными в профиле. Такой формат позволяет переиспользовать профили для соединения с разными БД или под разными учетными записями. Также, указание в командной строке параметра аутентификации (как `--user alex` в примере выше) отключает проверку переменных окружения независимо от их наличия в профиле.

## Соединение по активированному профилю {#implicit}

Если в командной строке не указана опция `--profile` (`-p`), то YDB CLI попробует взять из текущего активированного профиля все параметры соединения, которые он не смог определить другими способами (из опций командной строки или переменных окружения, как описано в статье [Соединение с БД и аутентификация](https://ydb.tech/docs/ru/reference/ydb-cli/connect.md?version=main)).

Неявное применение активированного профиля может приводить к ошибкам, поэтому перед использованием данного режима рекомендуется изучить статью [Активированный профиль](https://ydb.tech/docs/ru/reference/ydb-cli/profile/activate.md?version=main).
<!-- endsource: ru/reference/ydb-cli/profile/_includes/use.md -->