---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/operations/connection/create-ydb
  - ru/operations/connection/create-ydb
  - href: ru/operations/connection/create-ydb.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/operations/connection/create-ydb.html
title: Как создать подключение к Managed Service for YDB в DataLens On-premises
description: >-
  Следуя данной инструкции, вы сможете создать подключение к Managed Service for
  YDB в DataLens On-premises.
vcsPath: ru/operations/connection/create-ydb.md
---

# Создание подключения к YDB в DataLens On-premises

{% note info %}


Для написания подзапросов в датасетах и запросов в QL-чартах используйте [синтаксис YQL](https://ydb.tech/docs/ru//yql/reference/syntax/).

{% endnote %}

Чтобы создать подключение к YDB:



1. Перейдите на страницу [воркбука](../../workbooks-collections/index.md) или создайте новый.
1. В правом верхнем углу нажмите **Создать** → **Подключение**.
1. Выберите подключение **YDB**.
1. Выберите тип аутентификации:

   {% list tabs group=auth-type %}

   - Анонимный {#anonymous}

     * **Имя хоста**. Укажите путь до хоста YDB.
     * **Порт**. Укажите порт подключения к YDB. Порт по умолчанию — 2135.
     * **Путь к базе данных**. Укажите имя подключаемой базы данных.
     * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).
     * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset).

     ![image](../../_assets/datalens/operations/connection/connection-ydb-ent.png)

   - Пароль {#password}

     * **Имя хоста**. Укажите путь до хоста YDB.
     * **Порт**. Укажите порт подключения к YDB. Порт по умолчанию — 2135.
     * **Путь к базе данных**. Укажите имя подключаемой базы данных.
     * **Имя пользователя**. Укажите имя пользователя для подключения к YDB.
     * **Пароль**. Укажите пароль для пользователя.
     * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).
     * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset).

     ![image](../../_assets/datalens/operations/connection/connection-ydb-ent-pw.png)

   - OAuth {#oauth}

     * **OAuth-токен**. Укажите OAuth-токен для работы с YDB.
     * **Имя хоста**. Укажите путь до хоста YDB.
     * **Порт**. Укажите порт подключения к YDB. Порт по умолчанию — 2135.
     * **Путь к базе данных**. Укажите имя подключаемой базы данных.
     * **Время жизни кеша в секундах**. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).
     * **Уровень доступа SQL-запросов**. Позволяет использовать произвольный SQL-запрос для [формирования датасета](../../dataset/settings.md#sql-request-in-datatset).

     ![image](../../_assets/datalens/operations/connection/connection-ydb-ent-oauth.png)

   {% endlist %}

1. Нажмите кнопку **Создать подключение**.
1. Укажите название подключения и нажмите кнопку **Создать**.


## Дополнительные настройки {#additional-settings}

Вы можете указать дополнительные параметры подключения в разделе **Продвинутые настройки подключения**:

* **TLS** — опция определяет необходимость использования протокола TLS. Когда опция включена, использование SSL для подключения становится обязательным.
* **CA Certificate** — чтобы загрузить сертификат, нажмите кнопку **Прикрепить файл** и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла.


{% cut "Ошибка RESOURCE_EXHAUSTED" %}

При превышении квот и лимитов Managed Service for YDB может появиться сообщение об ошибке `RESOURCE_EXHAUSTED`. Чтобы избежать появления ошибки, придерживайтесь следующих рекомендаций:

* Снизьте интенсивность запросов. Например, используйте фильтры, указывайте в чартах только необходимые поля для ограничения количества получаемых данных.
* Выполните [рекомендации по оптимизации](../../concepts/optimization_recommendations.md) запросов к базе данных.
* Проанализируйте время загрузки и объем данных с помощью [инспектора чартов](../../concepts/chart/inspector.md) в DataLens.
* Проверьте графики мониторинга Managed Service for YDB на предмет превышения квот и лимитов. При необходимости немного увеличьте только пропускную способность (Request Units) в блоке **Ограничения**.

{% endcut %}