Łączenie aplikacji MongoDB z usługą Azure Cosmos DB

DOTYCZY: MongoDB

Dowiedz się, jak połączyć aplikację MongoDB z usługą Azure Cosmos DB przy użyciu parametrów połączenia bazy danych MongoDB. Następnie możesz użyć bazy danych usługi Azure Cosmos DB jako magazynu danych dla aplikacji MongoDB.

Ten samouczek opisuje dwa sposoby pobierania informacji o parametrach połączenia:

Wymagania wstępne

Wymagane są dwa elementy

Uzyskiwanie parametry połączenia bazy danych MongoDB przy użyciu przewodnika Szybki start

Wykonaj poniższe kroki:

  1. W przeglądarce internetowej zaloguj się do witryny Azure Portal.

  2. W okienku Azure Cosmos DB wybierz interfejs API.

  3. W okienku po lewej stronie okienka konta wybierz pozycję Szybki start.

  4. Wybierz platformę (.NET, Node.js, MongoDB Shell, Java, Python). Jeśli nie widzisz sterownika lub narzędzia na liście, nie martw się — stale dokumentujemy więcej fragmentów kodu połączenia. Dodaj komentarz do tego, co chcesz zobaczyć. Aby dowiedzieć się, jak utworzyć własne połączenie, przeczytaj pobieranie informacji o parametry połączenia konta.

  5. Skopiuj i wklej fragment kodu do aplikacji MongoDB.

Pobierz parametry połączenia Bazy danych MongoDB, aby dostosować

Wykonaj poniższe kroki:

  1. W przeglądarce internetowej zaloguj się do witryny Azure Portal.

  2. W okienku Azure Cosmos DB wybierz interfejs API.

  3. W okienku po lewej stronie okienka konta wybierz pozycję Parametry połączenia.

  4. Zostanie otwarte okienko Parametry połączenia. Zawiera wszystkie informacje niezbędne do nawiązania połączenia z kontem przy użyciu sterownika dla bazy danych MongoDB, w tym wstępnie skomprukturyzowanego parametry połączenia.

    Wymagania dotyczące parametrów połączenia

    Ważne

    usługa Azure Cosmos DB ma ścisłe wymagania i standardy dotyczące bezpieczeństwa. Konta usługi Azure Cosmos DB wymagają uwierzytelniania i bezpiecznej komunikacji za pośrednictwem protokołu TLS.

    Usługa Azure Cosmos DB obsługuje standardowy format identyfikatora URI usługi MongoDB parametry połączenia z kilkoma określonymi wymaganiami: konta usługi Azure Cosmos DB wymagają uwierzytelniania i bezpiecznej komunikacji za pośrednictwem protokołu TLS. Format parametry połączenia to:

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

    Wartości tego ciągu to:

    • Nazwa użytkownika (wymagana): nazwa konta usługi Azure Cosmos DB.
    • Hasło (wymagane): hasło konta usługi Azure Cosmos DB.
    • Host (wymagany): nazwa FQDN konta usługi Azure Cosmos DB.
    • Port (wymagany): 10255.
    • Baza danych (opcjonalnie): baza danych używana przez połączenie. Jeśli nie podano bazy danych, domyślna baza danych to "test".
    • ssl=true (wymagane).

    Rozważmy na przykład konto wyświetlane w okienku Parametry połączenia. Prawidłowym parametry połączenia jest:

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

    Wymagania dotyczące sterowników

    Wszystkie sterowniki obsługujące protokół przewodowy w wersji 3.4 lub nowszej obsługują usługę Azure Cosmos DB dla bazy danych MongoDB.

    • Sterowniki klienta muszą obsługiwać rozszerzenie TLS identyfikacji nazw usług (SNI) i/lub opcję appName parametry połączenia.
    • appName Jeśli parametr jest podany, należy go uwzględnić w parametry połączenia wartości w witrynie Azure Portal.