Connessione un'applicazione MongoDB ad Azure Cosmos DB

SI APPLICA A: MongoDB

Informazioni su come connettere un'app MongoDB ad Azure Cosmos DB usando una stringa di connessione MongoDB. È quindi possibile usare un database di Azure Cosmos DB come archivio dati per l'app MongoDB.

Questa esercitazione illustra due modi per recuperare le informazioni della stringa di connessione:

Prerequisiti

Sono necessari due elementi

Ottenere il stringa di connessione MongoDB usando la guida introduttiva

Segui i passaggi riportati di seguito:

  1. In un browser Internet accedere al portale di Azure.

  2. Nel riquadro Azure Cosmos DB selezionare l'API.

  3. Nel riquadro sinistro del riquadro dell'account selezionare Avvio rapido.

  4. Scegliere la piattaforma (.NET, Node.js, MongoDB Shell, Java, Python). Se il driver o lo strumento non compare nell'elenco, ricordare che altri frammenti di codice di connessione vengono continuamente documentati. Commenta ciò che vuoi vedere. Per informazioni su come realizzare la propria connessione, leggere Ottenere informazioni sulla stringa di connessione dell'account.

  5. Copiare e incollare il frammento di codice nell'app MongoDB.

Ottenere il stringa di connessione MongoDB da personalizzare

Segui i passaggi riportati di seguito:

  1. In un browser Internet accedere al portale di Azure.

  2. Nel riquadro Azure Cosmos DB selezionare l'API.

  3. Nel riquadro sinistro del riquadro dell'account selezionare Connessione stringhe di Connessione.

  4. Viene visualizzato il riquadro stringhe di Connessione ion. Contiene tutte le informazioni necessarie per connettersi all'account usando un driver per MongoDB, inclusa una stringa di connessione precostruita.

    Requisiti della stringa di connessione

    Importante

    Azure Cosmos DB presenta standard e requisiti di sicurezza restrittivi. Gli account Azure Cosmos DB richiedono l'autenticazione e la comunicazione sicura tramite TLS.

    Azure Cosmos DB supporta il formato URI stringa di connessione MongoDB standard, con un paio di requisiti specifici: gli account Azure Cosmos DB richiedono l'autenticazione e la comunicazione sicura tramite TLS. Il formato stringa di connessione è:

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

    I valori di questa stringa sono:

    • Nome utente (obbligatorio): nome dell'account Azure Cosmos DB.
    • Password (obbligatorio): password dell'account Azure Cosmos DB.
    • Host (obbligatorio): nome di dominio completo dell'account Azure Cosmos DB.
    • Porta (obbligatorio): 10255.
    • Database (facoltativo): il database utilizzato dalla connessione. Se viene specificato alcun database, il database predefinito è "test".
    • ssl=true (obbligatorio).

    Si consideri ad esempio l'account visualizzato nel riquadro stringhe di Connessione ion. Una stringa di connessione valida è la seguente:

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

    Requisiti del driver

    Tutti i driver che supportano il protocollo wire versione 3.4 o successiva supportano Azure Cosmos DB per MongoDB.

    • I driver client devono supportare l'estensione TLS Service Name Identification (SNI) e/o l'opzione appName stringa di connessione.
    • Se il appName parametro viene specificato, deve essere incluso come trovato nel valore stringa di connessione nel portale di Azure.