| Name | Description | Default value |
|---|---|---|
| blocking_task_processor | Deprecated, unused property. | – |
| credentials-provider | Name of credentials provider component. | – |
| operation-settings | Default operation settings for requests to the database. | – |
| operation-settings.retries | Default retries count for an operation. | 3 |
| operation-settings.client-timeout | Default client timeout in utils::StringToDuration format. | 1s |
| operation-settings.get-session-timeout | Default session timeout. | 5s |
| databases.* | Single database settings. | – |
| databases.*.endpoint | GRPC endpoint URL, e.g. grpc://localhost:1234. | – |
| databases.*.database | Full database path, e.g. /ru/service/production/database. | – |
| databases.*.credentials.* | Credentials config passed to credentials provider component. | – |
| databases.*.max_pool_size | Maximum connection pool size. | 50 |
| databases.*.min_pool_size | Minimum connection pool size. | 10 |
| databases.*.get_session_retry_limit | Retries count to get session, every attempt with a get-session-timeout. | 5 |
| databases.*.keep-in-query-cache | Whether to use query cache. | true |
| databases.*.network-threads-num | NYdb::TDriverConfig::SetNetworkThreadsNum. If omitted, not set (SDK default). | – |
| databases.*.client-threads-num | NYdb::TDriverConfig::SetClientThreadsNum. If omitted, not set (SDK default). | – |
| databases.*.tcp-keepalive | NYdb::TDriverConfig::SetTcpKeepAliveSettings. If the whole block is omitted, not set (SDK default). Use 0 for idle/count/interval on Linux to mean OS default. | – |
| databases.*.tcp-keepalive.enabled | Enable TCP keepalive on gRPC sockets (Linux; if omitted in a partial block, parser default applies). | – |
| databases.*.tcp-keepalive.idle-sec | Seconds idle before first keepalive probe (0 = OS default on Linux). | – |
| databases.*.tcp-keepalive.probe-count | Unacknowledged probes before drop (0 = OS default on Linux). | – |
| databases.*.tcp-keepalive.interval-sec | Seconds between probes (0 = OS default on Linux). | – |
| databases.*.grpc-keepalive-timeout | Duration string, e.g. 10s. NYdb::TDriverConfig::SetGRpcKeepAliveTimeout. If omitted, not set (SDK default). | – |
| databases.*.grpc-keepalive-permit-without-calls | NYdb::TDriverConfig::SetGRpcKeepAlivePermitWithoutCalls. If omitted, not set (SDK default). | – |
| databases.*.prefer_local_dc | Prefer making requests to local data center. | true |
| databases.*.sync_start | Fail to boot if YDB is not available. | true |
| databases.*.use-query-client | Whether to use query client for table client methods (ExecuteDataQuery, Transaction methods). | true |
| databases.*.aliases.[] | List of aliases for this database. Each of the elements: alias name. | – |
| databases.*.by-database-timings-buckets-ms.[] | Histogram bounds for by-database timing metrics. Each of the elements: upper bound for an individual bucket. | 40 buckets with +20% increment per step. |
| databases.*.by-query-timings-buckets-ms.[] | Histogram bounds for by-query timing metrics. Each of the elements: upper bound for an individual bucket. | 15 buckets with +100% increment per step. |
