Подключение к кластеру Yandex StoreDoc из приложений

Статья создана

Обновлена 11 февраля 2026 г.

Инструменты командной строки
- Linux (Bash)
- Windows (PowerShell)
Подключение из графических IDE
- DataGrip
- DBeaver
Подготовка к подключению из Docker-контейнера

К кластеру Yandex StoreDoc можно подключиться с помощью инструментов командной строки, из графических IDE и Docker-контейнера. О подключении из кода вашего приложения см. Примеры кода.

В примерах ниже предполагается, что SSL-сертификат root.crt расположен в директории:

~/.mongodb/ для Ubuntu;
$HOME\.mongodb для Windows.

При успешном подключении к кластеру и выполнении тестового запроса будет выведено имя БД, к которой было выполнено подключение.

Инструменты командной строки

Примеры кода с заполненным FQDN хоста доступны в консоли управления по нажатию кнопки Подключиться на странице кластера.

Способ настройки зависит от того, включено ли в кластере шардирование.

Linux (Bash)

Перед подключением установите утилиту MongoDB Shell.

Подключение с SSL для Yandex StoreDoc 4.2 и выше

Подключение с SSL для Yandex StoreDoc 4.0

Подключение без SSL

SRV-подключение

Для нешардированного кластера:

mongosh --norc \
        --tls \
        --tlsCAFile ~/.mongodb/root.crt \
        --host '<FQDN_хоста_1_Yandex_StoreDoc>:27018,...,<FQDN_хоста_N_Yandex_StoreDoc>:27018' \
        --username <имя_пользователя_БД> \
        --password <пароль_пользователя_БД> \
        <имя_БД>

Для шардированного кластера:

mongosh --norc \
        --tls \
        --tlsCAFile ~/.mongodb/root.crt \
        --host '<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...,<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017' \
        --username <имя_пользователя_БД> \
        --password <пароль_пользователя_БД> \
        <имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

После подключения выполните команду db.

Для нешардированного кластера:

mongosh --norc \
        --ssl \
        --sslCAFile ~/.mongodb/root.crt \
        --host '<FQDN_хоста_1_Yandex_StoreDoc>:27018,...,<FQDN_хоста_N_Yandex_StoreDoc>:27018' \
        --username <имя_пользователя_БД> \
        --password <пароль_пользователя_БД> \
        <имя_БД>

Для шардированного кластера:

mongosh --norc \
        --ssl \
        --sslCAFile ~/.mongodb/root.crt \
        --host '<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...,<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017' \
        --username <имя_пользователя_БД> \
        --password <пароль_пользователя_БД> \
        <имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

После подключения выполните команду db.

Для нешардированного кластера:

mongosh --norc \
        --host '<FQDN_хоста_1_Yandex_StoreDoc>:27018,...,<FQDN_хоста_N_Yandex_StoreDoc>:27018' \
        --username <имя_пользователя_БД> \
        --password <пароль_пользователя_БД> \
        <имя_БД>

Для шардированного кластера:

mongosh --norc \
        --host '<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...,<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017' \
        --username <имя_пользователя_БД> \
        --password <пароль_пользователя_БД> \
        <имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

После подключения выполните команду db.

mongosh "mongodb+srv://<имя_пользователя_БД>:<пароль_пользователя_БД>\
@<идентификатор_кластера>.mdb.yandexcloud.net/<имя_БД>"

Идентификатор кластера можно запросить со списком кластеров в каталоге.

После подключения выполните команду db.

При необходимости вы можете добавить к команде параметры подключения, например:

tls — включение TLS-шифрования соединения: true или false. По умолчанию шифрование включено.
tlsCAFile — путь к файлу .pem, содержащему корневые сертификаты центра сертификации.
readPreference — с каких хостов выполнять чтение:
- primary — только с первичной реплики (мастера);
- primaryPreferred — с мастера, а если он недоступен — с вторичных реплик;
- secondary — только с вторичных реплик;
- secondaryPreferred — с вторичных реплик, а если они отсутствуют, то с мастера;
- nearest — с хоста с наименьшей задержкой.
authSource — имя базы данных, в которой хранятся учетные данные пользователя. По умолчанию совпадает со значением параметра <имя_БД>.
appName — имя приложения, отображаемое в логах.

Описание других доступных параметров подключения см. в официальной документации.

Строка параметров начинается со знака ?, разделителем является знак &.

Пример команды с параметрами подключения:

mongosh "mongodb+srv://user********:qwe********@c9qng7jhsgtg********.mdb.yandexcloud.net\
/db********?authSource=admin&appName=debug"

Windows (PowerShell)

Перед подключением установите утилиту MongoDB Shell.

Подключение с SSL для Yandex StoreDoc 4.2 и выше

Подключение без SSL

SRV-подключение

Для нешардированного кластера:

mongosh.exe --norc `
            --host '<FQDN_хоста_1_Yandex_StoreDoc>:27018,...,<FQDN_хоста_N_Yandex_StoreDoc>:27018' `
            --tls `
            --tlsCAFile $HOME\.mongodb\root.crt `
            --username <имя_пользователя_БД> `
            --password <пароль_пользователя_БД> `
            <имя_БД>

Для шардированного кластера:

mongosh.exe --norc `
            --host '<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...,<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017' `
            --tls `
            --tlsCAFile $HOME\.mongodb\root.crt `
            --username <имя_пользователя_БД> `
            --password <пароль_пользователя_БД> `
            <имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

После подключения выполните команду db.

Для нешардированного кластера:

mongosh.exe --norc `
            --host '<FQDN_хоста_1_Yandex_StoreDoc>:27018,...,<FQDN_хоста_N_Yandex_StoreDoc>:27018' `
            --username <имя_пользователя_БД> `
            --password <пароль_пользователя_БД> `
            <имя_БД>

Для шардированного кластера:

mongosh.exe --norc `
            --host '<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...,<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017' `
            --username <имя_пользователя_БД> `
            --password <пароль_пользователя_БД> `
            <имя_БД>

О том, как получить FQDN хоста, см. инструкцию.

После подключения выполните команду db.

mongosh.exe "mongodb+srv://<имя_пользователя_БД>:<пароль_пользователя_БД>`
@<идентификатор_кластера>.mdb.yandexcloud.net/<имя_БД>"

Идентификатор кластера можно запросить со списком кластеров в каталоге.

После подключения выполните команду db.

При необходимости вы можете добавить к команде параметры подключения, например:

tls — включение TLS-шифрования соединения: true или false. По умолчанию шифрование включено.
tlsCAFile — путь к файлу .pem, содержащему корневые сертификаты центра сертификации.
readPreference — с каких хостов выполнять чтение:
- primary — только с первичной реплики (мастера);
- primaryPreferred — с мастера, а если он недоступен — с вторичных реплик;
- secondary — только с вторичных реплик;
- secondaryPreferred — с вторичных реплик, а если они отсутствуют, то с мастера;
- nearest — с хоста с наименьшей задержкой.
authSource — имя базы данных, в которой хранятся учетные данные пользователя. По умолчанию совпадает со значением параметра <имя_БД>.
appName — имя приложения, отображаемое в логах.

Описание других доступных параметров подключения см. в официальной документации.

Строка параметров начинается со знака ?, разделителем является знак &.

Пример команды с параметрами подключения:

mongosh.exe "mongodb+srv://user********:qwe********@c9qng7jhsgtg********.mdb.yandexcloud.net`
/db********?authSource=admin&appName=debug"

Подключение из графических IDE

Подключения проверялись в следующем окружении:

MacOS Big Sur 11.3.
JetBrains DataGrip: 2021.1.
DBeaver Enterprise: 21.0.

Подключаться из графических IDE можно только к хостам кластера в публичном доступе с использованием SSL-сертификата.

Чтобы избежать ошибок при подключении, сохраните сертификат в локальную папку, для доступа к которой не требуются права администратора.

DataGrip

Создайте источник данных:
1. Выберите в меню File → New → Data Source → MongoDB.
2. На вкладке General:
  1. Укажите параметры подключения:
    - User, Password — имя и пароль пользователя БД;
    - URL — строка подключения.
      
      Для нешардированного кластера:
      mongodb://<FQDN_хоста_1_Yandex_StoreDoc>:27018,..,<FQDN_хоста_N_Yandex_StoreDoc>:27018/<имя_БД>
      Для шардированного кластера:
      mongodb://<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017/<имя_БД>
      О том, как получить FQDN хоста, см. инструкцию.
  2. Нажмите ссылку Download, чтобы загрузить драйвер соединения.
3. На вкладке SSH/SSL:
  1. Включите настройку Use SSL.
  2. В поле CA file укажите путь к файлу SSL-сертификата для подключения.
Нажмите ссылку Test Connection для проверки подключения. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
Нажмите кнопку OK, чтобы сохранить источник данных.

DBeaver

Поддержка подключения к кластеру Yandex StoreDoc доступна только в коммерческих редакциях DBeaver.

Чтобы подключиться к кластеру:

Создайте новое соединение с БД:
1. Выберите в меню База данных пункт Новое соединение.
2. Выберите из списка БД MongoDB.
3. Нажмите кнопку Далее.
4. Настройте параметры подключения на вкладке Главное:
  1. В блоке Адрес переключите Type на URL и укажите строку подключения.
    
    Для нешардированного кластера:
```
mongodb://<FQDN_хоста_1_Yandex_StoreDoc>:27018,..,<FQDN_хоста_N_Yandex_StoreDoc>:27018/<имя_БД>
```
    Для шардированного кластера:
```
mongodb://<FQDN_хоста_1_MONGOINFRA_или_MONGOS>:27017,...<FQDN_хоста_N_MONGOINFRA_или_MONGOS>:27017/<имя_БД>
```
    О том, как получить FQDN хоста, см. инструкцию.
  2. В списке Устройство выберите значение SCRAM-SHA-256 (тип шифрования пароля при подключении).
  3. В блоке Полномочия укажите имя и пароль пользователя БД.
5. На вкладке SSL:
  1. Включите настройку Использовать SSL.
  2. В поле Корневой сертификат укажите путь к сохраненному файлу SSL-сертификата.
  3. В блоке Настройки включите Пропустить валидацию имени хоста.
Нажмите кнопку Тест соединения ... для проверки подключения. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
Нажмите кнопку Готово, чтобы сохранить настройки соединения с БД.

Подготовка к подключению из Docker-контейнера

Чтобы подключаться к кластеру Yandex StoreDoc из Docker-контейнера с SSL, добавьте в Dockerfile строки:

RUN apt-get update && \
    apt-get install wget --yes && \
    mkdir --parents ~/.mongodb && \
    wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
         --output-document ~/.mongodb/root.crt && \
    chmod 0644 ~/.mongodb/root.crt

Чтобы подключаться без SSL, дополнительно настраивать Dockerfile не нужно.

После запуска Docker-контейнера перейдите в него и установите утилиту mongosh. Она понадобится для подключения к кластеру.

Подключение к кластеру Yandex StoreDoc из приложений

Инструменты командной строкиИнструменты командной строки

Linux (Bash)Linux (Bash)

Windows (PowerShell)Windows (PowerShell)

Подключение из графических IDEПодключение из графических IDE

DataGripDataGrip

DBeaverDBeaver

Подготовка к подключению из Docker-контейнераПодготовка к подключению из Docker-контейнера

Была ли статья полезна?

Инструменты командной строки

Linux (Bash)

Windows (PowerShell)

Подключение из графических IDE

DataGrip

DBeaver

Подготовка к подключению из Docker-контейнера