Связаться с намиПодключиться

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

Статья создана
Обновлена 28 мая 2025 г.

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

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

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

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

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

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

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

Linux (Bash)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Windows (PowerShell)

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

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

mongosh.exe --norc `
            --host '<FQDN_хоста_1_MongoDB>:27018,...,<FQDN_хоста_N_MongoDB>: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 <пароль_пользователя_БД> `
            <имя_БД>

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

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

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

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

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

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

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

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

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

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

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

DataGrip

  1. Создайте источник данных:
    1. Выберите в меню File → New → Data Source → MongoDB.
    2. На вкладке General:

      1. Укажите параметры подключения:

        • User, Password — имя и пароль пользователя БД;

        • URL — строка подключения.

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

          mongodb://<FQDN_хоста_1_MongoDB>:27018,..,<FQDN_хоста_N_MongoDB>: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-сертификата для подключения.
  2. Нажмите ссылку Test Connection для проверки подключения. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
  3. Нажмите кнопку OK, чтобы сохранить источник данных.

DBeaver

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

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

  1. Создайте новое соединение с БД:
    1. Выберите в меню База данных пункт Новое соединение.
    2. Выберите из списка БД MongoDB.
    3. Нажмите кнопку Далее.
    4. Настройте параметры подключения на вкладке Главное:

      1. В блоке Адрес переключите Type на URL и укажите строку подключения.

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

        mongodb://<FQDN_хоста_1_MongoDB>:27018,..,<FQDN_хоста_N_MongoDB>: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. В блоке Настройки включите Пропустить валидацию имени хоста.
  2. Нажмите кнопку Тест соединения ... для проверки подключения. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
  3. Нажмите кнопку Готово, чтобы сохранить настройки соединения с БД.

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

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

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

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

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

Предыдущая
Предварительная настройка
Следующая
Обзор