Bearbeiten

Freigeben über


Verbinden einer MongoDB-Anwendung mit Azure Cosmos DB

GILT FÜR: MongoDB

In diesem Artikel erfahren Sie, wie Sie Ihre MongoDB-App mithilfe einer MongoDB-Verbindungszeichenfolge mit Azure Cosmos DB verbinden. Anschließend können Sie eine Azure Cosmos DB-Datenbank als Datenspeicher für Ihre MongoDB-App verwenden.

Dieses Tutorial zeigt zwei Möglichkeiten, um Informationen zur Verbindungszeichenfolge abzurufen:

Voraussetzungen

Es sind zwei Elemente erforderlich.

Abrufen der MongoDB-Verbindungszeichenfolge mithilfe der Schnellstartmethode

Gehen Sie wie folgt vor:

  1. Melden Sie sich über einen Internetbrowser beim Azure-Portal an.

  2. Wählen Sie die API im Bereich Azure Cosmos DB aus.

  3. Klicken Sie im linken Bereich des Kontobereichs auf Schnellstart.

  4. Wählen Sie Ihre Plattform aus ( .NET, Node.js, MongoDB Shell, Java, Python). Wenn der gewünschte Treiber oder das gewünschte Tool nicht aufgeführt wird, machen Sie sich keine Sorgen: Wir stellen kontinuierlich weitere Ausschnitte von Verbindungscodes zur Verfügung. Tragen Sie ein, welche Inhalte Sie sehen möchten. Informationen darüber, wie Sie eine eigene Verbindung erstellen können, finden Sie unter Abrufen der Informationen zur Verbindungszeichenfolge für das Konto.

  5. Kopieren Sie den Codeausschnitt, und fügen Sie ihn in Ihre MongoDB-App ein.

Abrufen der MongoDB-Verbindungszeichenfolge zum Anpassen

Gehen Sie wie folgt vor:

  1. Melden Sie sich über einen Internetbrowser beim Azure-Portal an.

  2. Wählen Sie die API im Bereich Azure Cosmos DB aus.

  3. Wählen Sie im linken Bereich des Kontobereichs die Option Verbindungszeichenfolgen aus.

  4. Der Bereich Verbindungszeichenfolgen wird geöffnet. Es enthält alle erforderlichen Informationen, um mithilfe eines Treibers für MongoDB eine Verbindung mit dem Konto herzustellen, einschließlich einer vorab erstellten Verbindungszeichenfolge.

    Anforderungen an die Verbindungszeichenfolge

    Wichtig

    Für Azure Cosmos DB gelten strenge Sicherheitsanforderungen und -standards. Azure Cosmos DB-Konten erfordern eine Authentifizierung und eine sichere Kommunikation über TLS.

    Azure Cosmos DB unterstützt das standardmäßige URI-Format für MongoDB-Verbindungszeichenfolgen. Es gelten jedoch einige besondere Anforderungen: Azure Cosmos DB-Konten erfordern eine Authentifizierung und eine sichere Kommunikation über TLS. Das Format der Verbindungszeichenfolge ist:

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

    Die Werte dieser Zeichenfolge sind:

    • Benutzername (erforderlich): Name des Azure Cosmos DB-Kontos
    • Kennwort (erforderlich): Kennwort des Azure Cosmos DB-Kontos
    • Host (erforderlich): FQDN des Azure Cosmos DB-Kontos
    • Port (erforderlich): 10255
    • Datenbank (optional): Die Datenbank, die die Verbindung verwendet. Wenn keine Datenbank angegeben wird, wird standardmäßig die Datenbank „test“ verwendet.
    • ssl=true (erforderlich).

    Sehen Sie sich beispielsweise das Konto im Bereich Verbindungszeichenfolgen an. Eine gültige Verbindungszeichenfolge ist:

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

    Treiberanforderungen

    Alle Treiber, die mindestens die Wire Protocol-Version 3.4 unterstützen, unterstützen auch Azure Cosmos DB for MongoDB.

    • Clienttreiber müssen die SNI-TLS-Erweiterung (Service Name Identification) und/oder die Verbindungszeichenfolgenoption „appName“ unterstützen.
    • Bei Angabe des Parameters appName muss er so hinzugefügt werden, wie er in der Verbindungszeichenfolge im Azure-Portal angegeben ist.