Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • AI Studio
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»
Yandex Managed Service for MongoDB
  • Начало работы
    • Все инструкции
      • Предварительная настройка
      • Подключение из приложений
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Обучающие курсы

В этой статье:

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

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

Статья создана
Yandex Cloud
Обновлена 28 мая 2025 г.
  • Инструменты командной строки
    • Linux (Bash)
    • Windows (PowerShell)
  • Подключение из графических IDE
    • DataGrip
    • DBeaver
  • Подготовка к подключению из Docker-контейнера

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

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

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

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

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

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

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

Linux (Bash)Linux (Bash)

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

Подключение с SSL для MongoDB 4.2 и выше
Подключение с SSL для MongoDB 4.0
Подключение без SSL

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

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)Windows (PowerShell)

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

Подключение с SSL для MongoDB 4.2 и выше
Подключение без SSL

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

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Подключение из графических IDE

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

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

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

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

DataGripDataGrip

  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, чтобы сохранить источник данных.

DBeaverDBeaver

Поддержка подключения к кластеру 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-контейнераПодготовка к подключению из 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. Она понадобится для подключения к кластеру.

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

Предыдущая
Предварительная настройка
Следующая
Обзор
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»