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

# Свойства JDBC-драйвера

JDBC-драйвер для YDB поддерживает следующие конфигурационные свойства, которые можно указать в [JDBC URL](#jdbc-url) или передать через дополнительные свойства:

* `saKeyFile` — путь к файлу с ключом сервисной учётной записи (Service Account Key). {#saFileFile}

* `iamEndpoint` — IAM-эндпойнт для аутентификации с помощью ключа сервисной учётной записи (Service Account Key).

* `token` — токен для аутентификации. {#token}

* `tokenFile` — путь к файлу с токеном для аутентификации. {#tokenFile}

* `useMetadata` — использование режима аутентификации **Metadata**. Возможные значения: {#metadata}

    - `true` — использовать режим аутентификации **Metadata**;
    - `false` — не использовать режим аутентификации **Metadata**.

    Значение по умолчанию: `false`.

* `metadataURL` — эндпойнт для получения токена в режиме аутентификации **Metadata**.

* `localDatacenter` — название локального датацентра, в котором выполняется приложение.

* `secureConnectionCertificate` — путь к файлу с сертификатом CA для TLS-соединения.

{% note info %}

Значения свойства `saKeyFile`, `tokenFile` или `secureConnectionCertificate` могут быть как абсолютными от корня файловой системы, так и относительными от домашней директории пользователя. Примеры:

* `saKeyFile=~/mysakey1.json`

* `tokenFile=/opt/secret/token-file`

* `secureConnectionCertificate=/etc/ssl/cacert.cer`

{% endnote %}

## Примеры JDBC URL {#jdbc-url}

<!-- source: ru/reference/languages-and-apis/jdbc-driver/_includes/jdbc-url-examples.md -->
- Локальный Docker контейнер с анонимной аутентификацией и без TLS:<br/>`jdbc:ydb:grpc://localhost:2136/local`
- Удаленный кластер, размещенный на собственном сервере:<br/>`jdbc:ydb:grpcs://<host>:2135/Root/<testdb>?secureConnectionCertificate=~/<myca>.cer`
- Экземпляр облачной базы данных с токеном:<br/>`jdbc:ydb:grpcs://<host>:2135/<path/to/database>?tokenFile=~/my_token`
- Экземпляр облачной базы данных с файлом сервисного аккаунта:<br/>`jdbc:ydb:grpcs://<host>:2135/<path/to/database>?saKeyFile=~/sa_key.json`
<!-- endsource: ru/reference/languages-and-apis/jdbc-driver/_includes/jdbc-url-examples.md -->