Свойства JDBC-драйвера
JDBC-драйвер для YDB поддерживает следующие конфигурационные свойства, которые можно указать в JDBC URL или передать через дополнительные свойства:
-
saKeyFile— путь к файлу с ключом сервисной учётной записи (Service Account Key). -
iamEndpoint— IAM-эндпойнт для аутентификации с помощью ключа сервисной учётной записи (Service Account Key). -
token— токен для аутентификации. -
tokenFile— путь к файлу с токеном для аутентификации. -
useMetadata— использование режима аутентификации Metadata. Возможные значения:true— использовать режим аутентификации Metadata;false— не использовать режим аутентификации Metadata.
Значение по умолчанию:
false. -
metadataURL— эндпойнт для получения токена в режиме аутентификации Metadata. -
localDatacenter— название локального датацентра, в котором выполняется приложение. -
secureConnectionCertificate— путь к файлу с сертификатом CA для TLS-соединения.
Примечание
Значения свойства saKeyFile, tokenFile или secureConnectionCertificate могут быть как абсолютными от корня файловой системы, так и относительными от домашней директории пользователя. Примеры:
-
saKeyFile=~/mysakey1.json -
tokenFile=/opt/secret/token-file -
secureConnectionCertificate=/etc/ssl/cacert.cer
Примеры JDBC URL
- Локальный Docker контейнер с анонимной аутентификацией и без TLS:
jdbc:ydb:grpc://localhost:2136/local - Удаленный кластер, размещенный на собственном сервере:
jdbc:ydb:grpcs://<host>:2135/Root/<testdb>?secureConnectionCertificate=~/<myca>.cer - Экземпляр облачной базы данных с токеном:
jdbc:ydb:grpcs://<host>:2135/<path/to/database>?tokenFile=~/my_token - Экземпляр облачной базы данных с файлом сервисного аккаунта:
jdbc:ydb:grpcs://<host>:2135/<path/to/database>?saKeyFile=~/sa_key.json