Подключение приложения MongoDB к Azure Cosmos DB

Область применения: MongoDB

Здесь содержатся сведения о подключении приложения MongoDB к Azure Cosmos DB с помощью строки подключения MongoDB. Вы сможете использовать базу данных Azure Cosmos DB в качестве хранилища данных для приложения MongoDB.

В этом руководстве описаны два способа получения строки подключения.

Необходимые компоненты

Требуется два элемента.

Получение строка подключения MongoDB с помощью быстрого запуска

Выполните приведенные ниже действия:

  1. В браузере войдите на портал Azure.

  2. В области Azure Cosmos DB выберите API.

  3. В левой области области учетной записи выберите "Быстрый запуск".

  4. Выберите платформу (.NET, Node.js, оболочка MongoDB, Java, Python). Если соответствующего драйвера или средства нет в списке, не беспокойтесь, мы постоянно добавляем дополнительные фрагменты кода для подключения. Закомментируйте то, что вы хотите увидеть. Дополнительные сведения о том, как создавать собственное подключение, см.в разделе Получение строки подключения MongoDB для настройки.

  5. Скопируйте и вставьте фрагмент кода в приложение MongoDB.

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

Выполните приведенные ниже действия:

  1. В браузере войдите на портал Azure.

  2. В области Azure Cosmos DB выберите API.

  3. В левой области области учетной записи выберите строки подключения.

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

    Требования к строке подключения

    Внимание

    В Azure Cosmos DB строгие требования к безопасности и стандарты. Для учетных записей Azure Cosmos DB требуется проверка подлинности и безопасный обмен данными через TLS.

    Azure Cosmos DB поддерживает стандартный формат URI строки подключения MongoDB с несколькими дополнительными требованиями: для учетных записей Azure Cosmos DB требуется проверка подлинности и безопасный обмен данными через TLS. Формат строка подключения:

    mongodb://username:password@host:port/[database]?ssl=true

    Значения этой строки:

    • Имя пользователя (обязательно): имя учетной записи Azure Cosmos DB.
    • Пароль (обязательно): пароль для учетной записи Azure Cosmos DB.
    • Узел (обязательно): полное доменное имя учетной записи Azure Cosmos DB.
    • Порт (обязательно): 10255.
    • База данных (необязательно): база данных, используемая для подключения. Если база данных не указана, база данных по умолчанию — test.
    • ssl=true (обязательно).

    Например, рассмотрим учетную запись, показанную в области строк подключения. Допустимая строка подключения:

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    Требования к драйверу

    Все драйверы, поддерживающие проводной протокол версии 3.4 или более поздней, поддерживают Azure Cosmos DB для MongoDB.

    • Клиентские драйверы должны поддерживать расширение TLS для идентификации имени службы (SNI) и (или) параметр appName строка подключения.
    • Если указан параметр appName, он должен иметь точно такое же значение, которое указано в параметре строки подключения на портале Azure.