Использование профиля
Соединение по выбранному профилю
Профиль может быть применен при запуске команды YDB CLI указанием опции --profile
или -p
:
ydb -p <profile_name> <команда и опции команды>
Например:
ydb -p mydb1 scheme ls -l
В таком случае все параметры соединения с БД будут взяты из профиля. При этом, если в профиле не указано параметров аутентификации, то YDB CLI попробует их определить по переменным окружения, как описано в статье Соединение с БД и аутентификация — Переменные окружения.
Соединение по выбранному профилю и параметрам командной строки
Опция --profile
(-p
) может быть не единственной среди параметров соединения в командной строке, например:
ydb -p mydb1 -d /local2 scheme ls -l
ydb -p mydb1 --user alex scheme ls -l
В таком случае указанные в командной строке параметры соединения имеют приоритет перед сохраненными в профиле. Такой формат позволяет переиспользовать профили для соединения с разными БД или под разными учетными записями. Также, указание в командной строке параметра аутентификации (как --user alex
в примере выше) отключает проверку переменных окружения независимо от их наличия в профиле.
Соединение по активированному профилю
Если в командной строке не указана опция --profile
(-p
), то YDB CLI попробует взять из текущего активированного профиля все параметры соединения, которые он не смог определить другими способами (из опций командной строки или переменных окружения, как описано в статье Соединение с БД и аутентификация).
Неявное применение активированного профиля может приводить к ошибкам, поэтому перед использованием данного режима рекомендуется изучить статью Активированный профиль.